Crea un'immagine Runway

POST

runwayml

text_to_image

curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4_image",
  "promptText": "A watercolor portrait of @cat_ref.",
  "ratio": "1024:1024",
  "referenceImages": [
    {
      "uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
      "tag": "cat_ref"
    }
  ]
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Usa questo endpoint per generare un’immagine da un Prompt, con immagini di riferimento facoltative immagini per gen4_image. Invia la tua chiave API CometAPI con autenticazione Bearer e un corpo della richiesta JSON.

Scegli un modello e i riferimenti

Ogni richiesta richiede model, promptText e ratio.

Modello	`referenceImages`
`gen4_image`	Facoltativo. Omettilo oppure usa `[]` per la generazione solo testo, oppure fornisci fino a tre immagini.
`gen4_image_turbo`	Fornisci da una a tre immagini.

Per gen4_image_turbo, referenceImages è obbligatorio e deve contenere da una a tre immagini. Ogni oggetto di riferimento contiene un uri dell’immagine e un tagfacoltativo. Usa un tag di 3-16 lettere minuscole, cifre o trattini bassi, che inizi con una lettera. Fai riferimento a esso in promptText come @tag, ad esempio @cat_ref. Gli URI delle immagini accettano URL HTTPS accessibili o URI di dati immagine Base64 fino a 5 MB. Il Prompt accetta da 1 a 1.000 unità di codice UTF-16.

Scegli le dimensioni

Imposta ratio su una delle coppie di dimensioni esatte nello schema. Ad esempio, 1024:1024 richiede un’immagine quadrata, 1280:720 un’immagine orizzontale e 720:1280 un’immagine verticale. Usa ratio per selezionare le dimensioni; non inviare resolution né size con questi modelli. Per un seed di campionamento esplicito, usa 1 fino a 4294967295. L’omissione o 0 seleziona un seed casuale. Se includi contentModeration, imposta il relativo publicFigureThreshold su auto o low; altrimenti ometti l’oggetto.

Recupera il risultato

Salva il valore id restituito e usa Recupera un’attività Runway. Quando status è SUCCEEDED, leggi gli URL delle immagini generate in output.

Autorizzazioni

Authorization

string

header

obbligatorio

Use your CometAPI API key.

Corpo

application/json

gen4_image
gen4_image_turbo

Request parameters for gen4_image.

model

enum<string>

obbligatorio

Model ID for this request variant.

Opzioni disponibili:

gen4_image

Allowed value: "gen4_image"

promptText

string

obbligatorio

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000

ratio

enum<string>

obbligatorio

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

Opzioni disponibili:

1024:1024,

1080:1080,

1168:880,

1360:768,

1440:1080,

1080:1440,

1808:768,

1920:1080,

1080:1920,

2112:912,

1280:720,

720:1280,

720:720,

960:720,

720:960,

1680:720

seed

integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

Intervallo richiesto: 0 <= x <= 4294967295

referenceImages

object[]

Optional array of up to three reference images. Omit it or use an empty array for text-only generation.

Maximum array length: 3

Show child attributes

contentModeration

object

Optional content moderation settings. Omit the object to use standard moderation.

Show child attributes

Risposta

Task submitted. Save its id to retrieve task status.

string

obbligatorio

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Ultima modifica il 18 settembre 2026

curl "https://api.cometapi.com/runwayml/v1/text_to_image" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4_image",
  "promptText": "A watercolor portrait of @cat_ref.",
  "ratio": "1024:1024",
  "referenceImages": [
    {
      "uri": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
      "tag": "cat_ref"
    }
  ]
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Moderazione dei contenuti

Chiavi API

Scegli un modello e i riferimenti

Scegli le dimensioni

Recupera il risultato

Autorizzazioni

Corpo

Risposta

​Scegli un modello e i riferimenti

​Scegli le dimensioni

​Recupera il risultato

Autorizzazioni

Corpo

Risposta

Scegli un modello e i riferimenti

Scegli le dimensioni

Recupera il risultato