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-flash-layerize",
"image_urls": [
"https://example.com/poster.png"
],
"quality": "auto",
"output_format": "jpeg"
}
'{
"created": 1757165031,
"id": "task-unified-1757165031-seedream5flashlayerize",
"model": "doubao-seedream-5.0-flash-layerize",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 60
},
"type": "image",
"usage": {
"billing_rule": "per_image",
"credits_reserved": 18.7272,
"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-flash-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 Flash レイヤー分解
- Seedream 5.0 Flash レイヤー分解（doubao-seedream-5.0-flash-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が付きます - 画像単位の課金です。ベース画像と各レイヤーをそれぞれ 1 枚として数え、解像度にかかわらず同一価格です。入力画像は無料です。タスク作成時に最大
17枚分のクレジットを確保し、完了後に実際の出力枚数で精算します。余分に確保されたクレジットは自動で返却されます - 処理時間の目安は約
60秒です - 生成された画像リンクは24時間有効です、お早めに保存してください
POST
/
v1
/
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-flash-layerize",
"image_urls": [
"https://example.com/poster.png"
],
"quality": "auto",
"output_format": "jpeg"
}
'{
"created": 1757165031,
"id": "task-unified-1757165031-seedream5flashlayerize",
"model": "doubao-seedream-5.0-flash-layerize",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"estimated_time": 60
},
"type": "image",
"usage": {
"billing_rule": "per_image",
"credits_reserved": 18.7272,
"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-flash-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"
}
}承認
##すべてのAPIにBearer Token認証が必要です##
APIキーの取得：
APIキー管理ページにアクセスしてAPIキーを取得してください
リクエストヘッダーに追加：
Authorization: Bearer YOUR_API_KEY
ボディ
application/json
画像生成モデル名
利用可能なオプション:
doubao-seedream-5.0-flash-layerize 例:
"doubao-seedream-5.0-flash-layerize"
分解対象の画像 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"]
分解したい要素の指定（任意）
3 つの使い方：
- 指定しない：モデルが画像内の主要な要素をすべて認識し、1 つずつ分解します
- 自然言語：例
オウムとタイトル文字を分解して。意味を解釈して要素を判別し、レイヤーに分けます - 座標指定：
<bbox>タグで位置を指定します。例タイトル文字<bbox>179 58 809 197</bbox>。正規化座標（0～1000）の使用を推奨します
例:
"オウムとタイトルの文字を分離してください"
出力段階。デフォルトは auto
オプション： auto、1K、1.5K、2K
説明：
- レイヤーモードは段階のみ受け付けます。比率（
16:9など）やピクセル指定（2048x2048など）を渡すとエラーになります autoは出力が入力画像に従うことを意味します。元のサイズが[921600, 4624220]ピクセルの範囲内であればそのまま、1K 未満なら 1K、2K を超えるなら 2K で出力されます- 各レイヤーは元画像での縦横比をそれぞれ保持し、ベース画像の縦横比は入力画像と同じです
課金について： 解像度にかかわらず画像単位で課金されます。1K、1.5K、2K、auto は同一価格です。
利用可能なオプション:
auto, 1K, 1.5K, 2K 例:
"auto"
プロンプト最適化のモードを設定するための最適化戦略
オプション：
standard：標準モード
注意： Seedream 5.0 Flash は standard のみに対応しています。fast を指定すると 400 が返されます。Flash 自体が高速生成版のため、別の高速モードはありません。
利用可能なオプション:
standard 例:
"standard"
出力画像フォーマット
オプション：
jpeg: JPEG フォーマット（デフォルト）png: PNG フォーマット
注意： このパラメータはベース画像のみを制御します。分解されたレイヤーは常に透過チャンネル付きの png で、この設定の影響を受けません。
利用可能なオプション:
jpeg, png 例:
"jpeg"
タスク完了後の 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"
レスポンス
画像生成タスクが正常に作成されました
タスク作成タイムスタンプ
例:
1757165031
タスク ID
例:
"task-unified-1757165031-seedream5flashlayerize"
使用された実際のモデル名
例:
"doubao-seedream-5.0-flash-layerize"
具体的なタスクタイプ
利用可能なオプション:
image.generation.task タスク進捗率（0-100）
必須範囲:
0 <= x <= 100例:
0
タスクステータス
利用可能なオプション:
pending, processing, completed, failed 例:
"pending"
非同期タスク情報
Show child attributes
Show child attributes
タスク出力タイプ
利用可能なオプション:
text, image, audio, video 例:
"image"
使用量と課金情報
Show child attributes
Show child attributes