Seedream 5 Pro

リクエスト ID seedream-5-0-pro

プロトコル

• POST /v1/images/generations · 画像を生成の例
• GET /v1/images/tasks/{task_id} · 画像タスクを照会の例

認証

リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。

• Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

POST /v1/images/generations

リクエスト例

API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。

例のメディア URL とアセット ID は、有効な素材に置き換えてください。

Images Generations

curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "seedream-5-0-pro",
  "prompt": "A watercolor illustration of a paper lantern by a lake.",
  "aspect_ratio": "16:9",
  "image_size": "1K"
}'

画像タスクを照会

curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

レスポンスとタスク

HTTP 200 · 同期リクエストの成功

?sync=1 を指定した場合、画像 URL は data[].url から取得できます。created は UNIX 秒、id はタスク ID です。

{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · 非同期リクエストの受付

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

?async=1 を指定した場合は、同じ API キーで GET /v1/images/tasks/{task_id} をポーリングします。status は pending、completed、failed のいずれかです。完了後は result_url から画像 URL を取得できます。

HTTP 200 · 完了したタスクの取得

{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "seedream-5-0-pro",
  "result_url": "https://example.com/generated-image.png"
}

主なエラー

照会結果が failed の場合は error を確認してください。error_detail がある場合は再送前に retryable を確認します。

レスポンス例とエラー

接続ガイド · リクエスト項目、タスクの状態、レスポンス形式は API ガイドを参照してください。

機能と制限

• text_to_image · 対応
• image_to_image · 条件付き対応 — 対応するリクエスト形式で有効な参照画像が必要です
• image_editing · 未公開
• reference_images · 条件付き対応 — 対応するリクエスト形式で有効な参照画像が必要です
• 制限 参照画像：最大 8 枚 · 解像度: 1K, 1.5K, 2K · アスペクト比: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9

モデル機能カタログ · 価格を確認