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

このエンドポイントを使用すると、プロンプトから画像を生成できます。任意の参照画像は gen4_image に対して指定できます。CometAPI API キーは Bearer 認証で送信し JSON リクエスト本文を指定します。

モデルと参照画像を選択する

すべてのリクエストには model、promptText、および ratio が必要です。

モデル	`referenceImages`
`gen4_image`	任意です。省略するか、テキストのみの生成には `[]` を使用するか、最大 3 枚の画像を指定します。
`gen4_image_turbo`	1 ～ 3 枚の画像を指定します。

gen4_image_turbo では、referenceImages が必須であり、1 ～ 3 枚の画像を含める必要があります。各参照オブジェクトには画像 uri と任意の tagを指定できます。タグには 3 ～ 16 文字の小文字、数字、またはアンダースコアを使用でき、先頭は文字にする必要があります。promptText ではこれをとして参照します。たとえば、@tag や @cat_ref のように指定します。画像 URI には、アクセス可能な HTTPS URL、または最大 5 MB の Base64 画像データ URI を使用できます。プロンプトには 1 ～ 1,000 UTF-16 コード単位を指定できます。

サイズを選択する

ratio には、スキーマ内の正確なサイズの組み合わせのいずれかを設定します。たとえば、 1024:1024 では正方形の画像をリクエストし、1280:720 では横長の画像をリクエストし、 720:1280 では縦長の画像をリクエストします。サイズの選択には ratio を使用してください。これらのモデルで送信してはならないのは resolution や size です。明示的なサンプリングシードには、1 から 4294967295 を使用します。省略するか 0 を指定すると、ランダムなシードが選択されます。contentModeration を含める場合は、その publicFigureThreshold を auto または low に設定します。そうでない場合は、このオブジェクトを省略します。

結果を取得する

返された id を保存し、 Runway タスクを取得する. status が SUCCEEDED の場合、生成された画像 URL を output で読み取ります。

承認

Authorization

string

header

必須

Use your CometAPI API key.

ボディ

application/json

gen4_image
gen4_image_turbo

Request parameters for gen4_image.

model

enum<string>

必須

Model ID for this request variant.

利用可能なオプション:

gen4_image

Allowed value: "gen4_image"

promptText

string

必須

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

Required string length: 1 - 1000

ratio

enum<string>

必須

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

利用可能なオプション:

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.

必須範囲: 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

レスポンス

Task submitted. Save its id to retrieve task status.

string

必須

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

最終更新日 2026年9月18日

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

コンテンツモデレーション

APIキー

モデルと参照画像を選択する

サイズを選択する

結果を取得する

承認

ボディ

レスポンス

​モデルと参照画像を選択する

​サイズを選択する

​結果を取得する

承認

ボディ

レスポンス

モデルと参照画像を選択する

サイズを選択する

結果を取得する