Seedream-5.5 画像生成 | ToAPIs Documentation

POST

/v1/images/generations

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください.本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください.

doubao-seedream-5-5 でテキストからの画像生成, 参照画像を使った編集, レイヤー分解をリクエストできます. 送信後に返されるタスク ID を使って結果を取得します.

1 リクエストにつき結果画像を 1 枚返します.

Authorizations

Authorizationstringヘッダー必須

All endpoints require Bearer Token authentication

Get your API Key from the API Key Management Page

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

modelstringボディ必須デフォルト: doubao-seedream-5-5

Image generation model name

Example: "doubao-seedream-5-5"

promptstringボディ

通常の生成と編集では必須のテキスト説明. layer_decomposition を有効にした場合は省略でき, モデルが分解する要素を自動的に判断します.

sizestringボディデフォルト: 2K

1K, 1.5K, 2K, または 2048x2048 のような WIDTHxHEIGHT 形式のピクセル寸法に対応します. プリセットは解像度の区分であり, アスペクト比を固定しません. 指定寸法の総画素数は 921600-4624220 です. 正方形を指定する場合は 1:1 ではなく 2048x2048 を使用してください. 通常生成の既定値は 2K です. レイヤー分解では 2K を明示してください.

image_urlsstring[]ボディ

画像編集や複数画像の参照に使用する画像 URL の配列.

参照画像は最大 10 枚.
公開アクセス可能な HTTP/HTTPS URL のみ対応. base64 データの直接指定は非対応.
ローカル画像は画像アップロード API で先にアップロードしてください.
reference_images または images 配列も使用できます.

imagestringボディ

1 枚の参照画像を指定する URL 文字列. 複数画像には image_urls を使用し, image に配列を渡さないでください.

layer_decompositionbooleanボディ

true で 1 枚の参照画像を分解します. prompt は省略できます. 連続画像生成のパラメータは省略してください. ベース画像と透過 PNG レイヤーを返し, z_index, 配置情報, 名前を含みます. 現在の API はベース画像 1 枚と最大 16 レイヤーを処理できます. レイヤー数や OCR の設定は公開していません.

optimize_prompt_optionsobjectボディ

プロンプト最適化の設定. {"mode": "standard"} を使用してください. Seedream 5.5 は fast を受け付けません.

metadataobjectボディ

Channel-specific parameters for advanced Seedream 5.5 model configuration

metadata properties

metadata.output_formatstringボディデフォルト: png

出力形式は png または jpeg. 透過背景には png を使用してください.

metadata.backgroundstringボディ

opaque または transparent. 透過背景と output_format=jpeg は併用できません. transparent で形式を省略した場合は PNG になります. 現在の API は明示的な auto を受け付けません.

metadata.watermarkbooleanボディデフォルト: false

表示される AI generated 透かしの設定. false で無効, true で有効にします. 来歴メタデータや不可視マーカーの削除を意味するものではありません.

metadata.response_formatstringボディデフォルト: url

このページでは url モードを使用します. 非同期タスクの結果から画像 URL を取得してください.

パラメータの制限

通常の複数画像生成には対応していません. sequential_image_generation と sequential_image_generation_options は省略してください. disabled でも上流 API に拒否されます. stream=true は使用できません. stream は省略するか false にしてください. 現在の API は tools によるウェブ検索と seed に対応していません.

タスクの照会

送信成功は生成完了を意味しません. 同じ API Key でタスクを照会してください. 状態は pending, queued, in_progress, completed, failed のいずれかです. 完了時は result.data, 失敗時は error を確認します.

curl "https://toapis.com/v1/images/generations/TASK_ID" \
  -H "Authorization: Bearer $TOAPIS_API_KEY"

Response

idstring

Unique task identifier for status queries

objectstring

Object type, always generation.task

modelstring

モデル name used

statusstring

Task status

queued - Queued for processing
in_progress - Processing
completed - Successfully completed
failed - Failed

progressinteger

Task progress percentage (0-100)

created_atinteger

Task creation timestamp (Unix timestamp)

metadataobject

Task metadata

result.dataarray

完了した画像の一覧. 通常生成は 1 件, レイヤー分解は複数件です.

result.data[]object

画像 URL, 実際のピクセル寸法, 出力形式.

result.data[].z_indexinteger

レイヤーの重なり順. 0 はベース画像です. ほかのレイヤーには bounding_box, name, description も含まれる場合があります.

実行前に環境変数 TOAPIS_API_KEY を設定してください. 参照画像の例にある example.com はプレースホルダーです. アクセス可能な画像 URL に置き換えてください.

リクエスト例

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "prompt": "A red toy sailboat and a small yellow sun, isolated objects, no text.",
  "size": "2K",
  "metadata": {
    "output_format": "png",
    "background": "transparent",
    "watermark": false,
    "response_format": "url"
  }
}'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "prompt": "Combine the subjects from both references into one product illustration.",
  "size": "2K",
  "image_urls": [
    "https://example.com/reference-front.png",
    "https://example.com/reference-side.jpg"
  ],
  "metadata": {
    "output_format": "png",
    "watermark": false,
    "response_format": "url"
  }
}'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "doubao-seedream-5-5",
  "image": "https://example.com/composition.png",
  "layer_decomposition": true,
  "size": "2K",
  "metadata": {
    "output_format": "png",
    "watermark": false,
    "response_format": "url"
  }
}'

レスポンス例

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "doubao-seedream-5-5",
  "status": "pending",
  "progress": 0,
  "created_at": 1794300000,
  "metadata": {}
}

{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "doubao-seedream-5-5",
  "status": "completed",
  "progress": 100,
  "created_at": 1794300000,
  "metadata": {},
  "result": {
    "type": "image",
    "data": [
      {
        "url": "https://files.toapis.com/images/example/seedream-5-5.png",
        "size": "2512x1680",
        "output_format": "png"
      }
    ]
  }
}