curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.5-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "png",
  "n": 30,
  "model_params": {
    "text_recognition": true
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612934-seedream55layerize",
  "model": "doubao-seedream-5.5-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 150
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 55.624,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.5-layerize",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Seedream 5.5

Seedream 5.5 レイヤー分解

🚧 このモデルはまだ利用できません。お楽しみに

Seedream 5.5 レイヤー分解 (doubao-seedream-5.5-layerize) は、1枚の画像をベース画像と複数の独立したレイヤーに分解します
入力画像は 1 枚です。prompt は省略可能で、省略時は主要な要素を自動で識別して分解します
n で最大出力枚数を指定し、model_params.text_recognition で文字認識を有効にできます
非同期処理です。返されたタスク ID でタスクの状態を確認してください
生成された画像リンクは24時間有効です、お早めに保存してください

出力について

ベース画像の形式は output_format で指定します。独立したレイヤーは透過チャンネル付き PNG で出力されます
result_data 内の各画像には z_index（重ね順。ベース画像は 0、レイヤーは 1 から昇順）と background（ベース画像は opaque、レイヤーは transparent）が付きます。レイヤーには bounding_box（absolute はベース画像の座標系でのピクセル座標、normalized は 0～1000）、name、description も付きます
いずれかのレイヤーが失敗するとタスク全体が失敗し、全額返金されます。一部成功の結果は返されません

課金について

ベース画像と各レイヤーはそれぞれ1枚として課金されます。入力画像は別途課金されます
タスク作成時に入力画像 1 枚と最大 n 枚の出力画像に相当するクレジットを事前に確保します。完了後は実際の出力枚数で精算し、未使用分は自動で返却されます

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.5-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "png",
  "n": 30,
  "model_params": {
    "text_recognition": true
  }
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612934-seedream55layerize",
  "model": "doubao-seedream-5.5-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 150
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 55.624,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.5-layerize",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

承認

Authorization

string

header

必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得：

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

デフォルト:doubao-seedream-5.5-layerize

必須

画像生成モデル名

利用可能なオプション:

doubao-seedream-5.5-layerize

例:

"doubao-seedream-5.5-layerize"

image_urls

string<uri>[]

必須

分解対象の画像 URL（必須）

注意:

ちょうど 1 枚が必要です。指定しない場合や 2 枚以上を指定した場合はエラーになります
サポートされる形式: .png、.jpeg、.jpg（通常の生成より厳しく、webp などは拒否されます）
画像サイズ: 最大 30MB
総ピクセル数: [262144, 6000×6000]、つまり最低 512×512（通常の生成より下限が高い）
縦横比（幅/高さ）の範囲: [1/16, 16]
画像URLはサーバーから直接参照できるか、アクセス時に直接ダウンロードが始まる必要があります（通常このようなURLは.pngや.jpgなどの画像拡張子で終わります）
入力画像は別途課金されます

Required array length: 1 element

例:

["https://example.com/poster.png"]

prompt

string

分解したい要素の指定（任意）

3 つの使い方：

指定しない：モデルが画像内の主要な要素をすべて認識し、1 つずつ分解します
自然言語：例 オウムとタイトル文字を分解して。意味を解釈して要素を判別し、レイヤーに分けます
座標指定：<bbox> タグで位置を指定します。例 タイトル文字<bbox>179 58 809 197</bbox>。正規化座標（0～1000）の使用を推奨します

例:

"オウムとタイトル文字を分解して"

integer

デフォルト:30

ベース画像を含む最大出力枚数。デフォルトは 30 です。

説明：

指定範囲は 2～100 です。範囲外では 400 が返され、課金されません
上限に達すると分解を終了し、残りの要素は統合または省略される場合があります。値を大きくすると、より細かな分解が可能です
n が大きいほど事前に確保するクレジットも増えます。完了後は実際の出力枚数で精算し、未使用分は自動で返却されます

必須範囲: 2 <= x <= 100

例:

30

quality

enum<string>

デフォルト:auto

出力解像度。デフォルトは auto です。

オプション： auto、1K、1.5K、2K

説明：

上記の解像度オプションのみに対応します。比率（16:9 など）やピクセルサイズ（2048x2048 など）を指定するとエラーになります
auto は出力が入力画像に従うことを意味します。元のサイズが [921600, 4624220] ピクセルの範囲内であればそのまま、1K 未満なら 1K、2K を超えるなら 2K で出力されます
各レイヤーは元画像での縦横比をそれぞれ保持し、ベース画像の縦横比は入力画像と同じです

利用可能なオプション:

auto,

1K,

1.5K,

2K

例:

"auto"

prompt_priority

enum<string>

デフォルト:standard

プロンプト最適化モード。standard のみに対応し、デフォルトも standard です。

fast を指定すると 400 が返され、課金されません。

利用可能なオプション:

standard

例:

"standard"

output_format

enum<string>

デフォルト:png

出力画像フォーマット

オプション：

png：PNG フォーマット（デフォルト）
jpeg：JPEG フォーマット

注意：このパラメータはベース画像のみを制御します。分解されたレイヤーは常に透過チャンネル付きの png で、この設定の影響を受けません。

利用可能なオプション:

png,

jpeg

例:

"png"

model_params

object

レイヤー分解の追加オプションです。text_recognition のみ指定でき、他のキーを渡すと 400 が返されます。

Show child attributes

callback_url

string<uri>

タスク完了後の HTTPS コールバックアドレス

コールバックタイミング：

タスクが完了、失敗、またはキャンセルされた時にトリガーされます
課金確認完了後に送信されます

セキュリティ制限：

HTTPS プロトコルのみサポート
内部 IP アドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など）
URL の長さは 2048 文字以内

コールバックメカニズム：

タイムアウト：10 秒
失敗時最大 3 回リトライ（1 秒/2 秒/4 秒後にリトライ）
コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致
コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします

例:

"https://your-domain.com/webhooks/image-task-completed"

レスポンス

画像生成タスクが正常に作成されました

created

integer

タスク作成タイムスタンプ

例:

1757165031

string

タスク ID

例:

"task-unified-1793612934-seedream55layerize"

model

string

使用された実際のモデル名

例:

"doubao-seedream-5.5-layerize"

object

enum<string>

具体的なタスクタイプ

利用可能なオプション:

image.generation.task

progress

integer

タスク進捗率（0-100）

必須範囲: 0 <= x <= 100

例:

0

status

enum<string>

タスクステータス

利用可能なオプション:

pending,

processing,

completed,

failed

例:

"pending"

task_info

object

非同期タスク情報

Show child attributes

type

enum<string>

タスク出力タイプ

利用可能なオプション:

text,

image,

audio,

video

例:

"image"

usage

object

使用量と課金情報

Show child attributes

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

Seedream 5.5 レイヤー分解

出力について

課金について

承認

ボディ

レスポンス