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",
  "prompt": "A serene lake reflecting the beautiful sunset",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612886-seedream55",
  "model": "doubao-seedream-5.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 1.836,
    "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",
    "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) はテキストからの画像生成、画像からの画像生成、画像編集に対応し、透明背景の画像も生成できます
非同期処理です。返されたタスク ID でタスクの状態を確認してください
生成画像のリンクの有効期限は 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.5",
  "prompt": "A serene lake reflecting the beautiful sunset",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612886-seedream55",
  "model": "doubao-seedream-5.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 1.836,
    "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",
    "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

必須

画像生成モデル名

利用可能なオプション:

doubao-seedream-5.5

例:

"doubao-seedream-5.5"

prompt

string

必須

生成したい画像を説明するプロンプト、または入力画像の編集方法を説明するプロンプト

対応言語：中国語・英語のほか、Seedream 5.5 はロシア語、アラビア語、フィリピン語、タイ語、トルコ語、韓国語、マレー語、スペイン語、ポルトガル語、インドネシア語、フランス語、ドイツ語、ベトナム語、日本語にも対応しています。

長さ制限：最大 4000 トークン（中国語で約 2,600 字、英語で約 5,000 語）。超過した場合は 400 を返し、課金されません。

推奨：中国語は 300 字、英語は 600 語以内を推奨します。制限内であっても長すぎると情報が分散し、モデルが細部を見落として画面の要素が欠けることがあります。

例:

"A serene lake reflecting the beautiful sunset"

size

string

デフォルト:auto

生成画像のサイズ。2つの形式をサポートします：

方法1 - 比率形式：

auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21
quality パラメータと組み合わせると、ピクセルを手動で指定せずに、対応する比率と解像度の画像が自動生成されます

方法2 - ピクセル形式：

幅x高さ、例: 1024x1024, 2048x2048
総ピクセル範囲: [921600, 4624220]
アスペクト比範囲: [1/16, 16]
幅と高さはいずれも 14px より大きい必要があります

size を省略するとデフォルトは auto です。モデルがプロンプトからアスペクト比を決定し、出力解像度は quality で指定します。

例:

"16:9"

quality

enum<string>

デフォルト:1K

出力解像度。size の比率形式と組み合わせて使用します。デフォルトは 1K です。

比率	1K	1.5K	2K
`1:1`	1024×1024	1536×1536	2048×2048
`2:3`	832×1248	1248×1872	1664×2496
`3:2`	1248×832	1872×1248	2496×1664
`3:4`	864×1152	1344×1792	1776×2368
`4:3`	1152×864	1792×1344	2368×1776
`4:5`	896×1120	1344×1680	1792×2240
`5:4`	1120×896	1680×1344	2240×1792
`9:16`	800×1424	1152×2048	1584×2816
`16:9`	1424×800	2048×1152	2816×1584
`21:9`	1568×672	2352×1008	3136×1344
`9:21`	672×1568	1008×2352	1344×3136

利用可能なオプション:

1K,

1.5K,

2K

例:

"2K"

prompt_priority

enum<string>

デフォルト:standard

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

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

利用可能なオプション:

standard

例:

"standard"

image_urls

string<uri>[]

画像から画像への変換および画像編集機能のための参照画像URLリスト

注意:

参照画像は生成画像とは別に課金されます
単一リクエストでサポートされる入力画像数: 10画像
画像サイズ: 30MB以下
サポートされる画像形式: .jpeg, .jpg, .png, .webp, .bmp, .tiff, .gif, .heic, .heif
アスペクト比（幅/高さ）範囲: [1/16, 16]
幅と高さ（px）> 14
総ピクセル数: [196, 6000×6000]
画像URLはサーバーから直接表示可能であるか、アクセス時に直接ダウンロードをトリガーする必要があります（通常、これらのURLは.png、.jpgなどの画像ファイル拡張子で終わります）

Maximum array length: 10

例:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

output_format

enum<string>

デフォルト:png

出力画像フォーマット

オプション：

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

注意： background=transparent の場合、出力は png 固定です。output_format を省略すると自動で png になり、jpeg を指定すると拒否されます。

利用可能なオプション:

png,

jpeg

例:

"png"

watermark

boolean

デフォルト:false

生成画像にウォーターマークを追加するかどうか

例:

false

background

enum<string>

デフォルト:auto

出力画像の背景の種類。デフォルトは auto です。

オプション：

auto：プロンプトと参照画像からモデルが背景を決定します。タスク詳細の result_data[].background に、実際の背景の種類として transparent または opaque が返されます
transparent：透過チャンネル付き PNG を生成します。テキストからの画像生成と画像からの画像生成に対応します
opaque：不透明な背景の画像を生成します

transparent を使用する場合：

参照画像は省略可能です。指定する場合は最大 10 枚で、入力画像に透過チャンネルは不要です
出力形式は png 固定です。output_format を省略すると自動で png になり、jpeg を指定するとエラーになります

利用可能なオプション:

auto,

transparent,

opaque

例:

"auto"

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-1793612886-seedream55"

model

string

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

例:

"doubao-seedream-5.5"

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 画像生成

課金について

承認

ボディ

レスポンス