Bir Runway görüntüsü oluşturun

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

Bir Prompt’tan görüntü oluşturmak için bu endpoint’i, isteğe bağlı referans görüntüleriyle birlikte gen4_image için kullanın. CometAPI API anahtarınızı Bearer kimlik doğrulamasıyla ve bir JSON istek gövdesiyle gönderin.

Model ve referansları seçin

Her istek model, promptText ve ratio gerektirir.

Model	`referenceImages`
`gen4_image`	İsteğe bağlıdır. Yalnızca metinle oluşturma için bunu atlayın veya `[]` kullanın ya da en fazla üç görüntü sağlayın.
`gen4_image_turbo`	Bir ila üç görüntü sağlayın.

gen4_image_turbo için referenceImages zorunludur ve bir ila üç görüntü içermelidir. Her referans nesnesi bir görüntü uri ve isteğe bağlı bir tag. Harfle başlayan, 3 ila 16 küçük harf, rakam veya alt çizgiden oluşan bir tag kullanın. Bunu promptText içinde @tag olarak, örneğin @cat_ref şeklinde referans gösterin. Görüntü URI’leri, erişilebilir HTTPS URL’lerini veya en fazla 5 MB boyutunda Base64 görüntü verisi URI’lerini kabul eder. Prompt, 1 ila 1.000 UTF-16 kod birimini kabul eder.

Boyutları seçin

ratio öğesini şemadaki tam boyut çiftlerinden birine ayarlayın. Örneğin, 1024:1024 kare bir görüntü ister, 1280:720 yatay bir görüntü ister ve 720:1280 dikey bir görüntü ister. Boyutları seçmek için ratio kullanın; bu modellerle şu değerleri göndermeyin: resolution veya size. Açık bir örnekleme seed’i için 1 ile 4294967295 arasını kullanın. Atama yapılmaması veya 0 rastgele bir seed seçer. contentModeration eklerseniz, bunun publicFigureThreshold değerini auto veya low olarak ayarlayın; aksi takdirde nesneyi atlayın.

Sonucu alın

Döndürülen id değerini kaydedin ve Bir Runway görevi alın. status SUCCEEDED olduğunda, oluşturulan görüntü URL’lerini output içinde okuyun.

Yetkilendirmeler

Authorization

string

header

gerekli

Use your CometAPI API key.

Gövde

application/json

gen4_image
gen4_image_turbo

Request parameters for gen4_image.

model

enum<string>

gerekli

Model ID for this request variant.

Mevcut seçenekler:

gen4_image

Allowed value: "gen4_image"

promptText

string

gerekli

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

Required string length: 1 - 1000

ratio

enum<string>

gerekli

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

Mevcut seçenekler:

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.

Gerekli aralık: 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

Yanıt

Task submitted. Save its id to retrieve task status.

string

gerekli

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

Son değiştirilme tarihi 18 Eylül 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>"
  }
}

İçerik moderasyonu

API anahtarları

Model ve referansları seçin

Boyutları seçin

Sonucu alın

Yetkilendirmeler

Gövde

Yanıt

​Model ve referansları seçin

​Boyutları seçin

​Sonucu alın

Yetkilendirmeler

Gövde

Yanıt

Model ve referansları seçin

Boyutları seçin

Sonucu alın