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.0-pro-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5prolayerize",
  "model": "doubao-seedream-5.0-pro-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 39.168,
    "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.0-pro-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

Seedream 5.0 Pro レイヤー分解

Seedream 5.0 Pro レイヤー分解（doubao-seedream-5.0-pro-layerize）は 1 枚の画像をベース画像と複数の独立したレイヤーに分割します。各レイヤーは透過チャンネル付きの PNG で、ベース画像の形式は output_format に従います
入力画像はちょうど 1 枚必要です。prompt は任意で、指定しない場合はモデルが画像内の主要な要素をすべて自動で認識し、1 つずつ分解します
出力枚数は分解結果によって決まり（1～17 枚）、リクエストパラメータでは制御できません。いずれかのレイヤーが失敗するとリクエスト全体が失敗し、部分的な成功はありません。失敗した場合は全額返金されます
非同期処理モード、返却されたタスクIDで照会。タスク詳細の result_data では、各画像に z_index（重ね順。ベース画像は 0、レイヤーは 1 から昇順）が付きます。レイヤーにはさらに bounding_box（absolute はベース画像の座標系でのピクセル座標、normalized は 0～1000 の範囲）、name、description が付きます
本モデルは通常の生成より時間がかかり、目安は約 120 秒です
生成された画像リンクは24時間有効です、お早めに保存してください

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.0-pro-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5prolayerize",
  "model": "doubao-seedream-5.0-pro-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 39.168,
    "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.0-pro-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.0-pro-layerize

必須

画像生成モデル名

利用可能なオプション:

doubao-seedream-5.0-pro-layerize

例:

"doubao-seedream-5.0-pro-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）の使用を推奨します

例:

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

quality

enum<string>

デフォルト:auto

出力段階。デフォルトは auto

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

説明：

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

課金について：段階は出力画像ごとにその画像自身のピクセル数で判定されます。1K と 1.5K は同一価格で、1 枚の出力が 2610000 ピクセルを超えると高い段階の価格になります。

利用可能なオプション:

auto,

1K,

1.5K,

2K

例:

"auto"

prompt_priority

enum<string>

デフォルト:standard

プロンプト最適化のモードを設定するために使用されるプロンプト最適化戦略

オプション:

standard: 標準モード、より高品質な出力、処理時間が長い
fast: 高速モード、処理時間が短く、品質は標準モードよりやや劣ります

利用可能なオプション:

standard,

fast

例:

"standard"

output_format

enum<string>

デフォルト:jpeg

出力画像フォーマット

オプション：

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

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

利用可能なオプション:

jpeg,

png

例:

"jpeg"

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-1757165031-seedream5prolayerize"

model

string

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

例:

"doubao-seedream-5.0-pro-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.0 Pro レイヤー分解

承認

ボディ

レスポンス