Opprett et Runway-bilde

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>"
  }
}

Bruk dette endepunktet til å generere et bilde fra en Prompt, med valgfrie referanse bilder for gen4_image. Send CometAPI API-nøkkelen din med Bearer-autentisering og en JSON-forespørselstekst.

Velg en modell og referanser

Hver forespørsel krever model, promptText og ratio.

Modell	`referenceImages`
`gen4_image`	Valgfritt. Utelat feltet eller bruk `[]` for generering med bare tekst, eller oppgi opptil tre bilder.
`gen4_image_turbo`	Oppgi ett til tre bilder.

For gen4_image_turbo er referenceImages obligatorisk og må inneholde ett til tre bilder. Hvert referanseobjekt inneholder en bilde-uri og en valgfri tag. Bruk en tagg på 3 til 16 små bokstaver, sifre eller understreker, og den må starte med en bokstav. Referer til den i promptText som @tag, for eksempel @cat_ref. Bilde-URI-er godtar tilgjengelige HTTPS-URL-er eller Base64-data-URI-er for bilder på opptil 5 MB. Prompt godtar 1 til 1 000 UTF-16-kodeenheter.

Velg dimensjoner

Angi ratio til ett av de nøyaktige dimensjonsparene i skjemaet. For eksempel 1024:1024 ber 1280:720 om et kvadratisk bilde, et liggende bilde, og 720:1280 et stående bilde. Bruk ratio for å velge dimensjoner; ikke send resolution eller size med disse modellene. For en eksplisitt seed for sampling bruker du 1 til 4294967295. Utelatelse eller 0 velger en tilfeldig seed. Hvis du inkluderer contentModeration, angir du dens publicFigureThreshold til auto eller low; ellers utelater du objektet.

Hent resultatet

Lagre den returnerte id og bruk Hent en Runway-oppgave. Når status er SUCCEEDED, leser du de genererte bilde-URL-ene i output.

Autorisasjoner

Authorization

string

header

påkrevd

Use your CometAPI API key.

Kropp

application/json

gen4_image
gen4_image_turbo

Request parameters for gen4_image.

model

enum<string>

påkrevd

Model ID for this request variant.

Tilgjengelige alternativer:

gen4_image

Allowed value: "gen4_image"

promptText

string

påkrevd

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

Required string length: 1 - 1000

ratio

enum<string>

påkrevd

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

Tilgjengelige alternativer:

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.

Nødvendig område: 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

Svar

Task submitted. Save its id to retrieve task status.

string

påkrevd

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

Sist endret 18. september 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>"
  }
}

Innholdsmoderering

API-nøkler

Velg en modell og referanser

Velg dimensjoner

Hent resultatet

Autorisasjoner

Kropp

Svar

​Velg en modell og referanser

​Velg dimensjoner

​Hent resultatet

Autorisasjoner

Kropp

Svar

Velg en modell og referanser

Velg dimensjoner

Hent resultatet