Seedream 5 画像 API

API ドキュメンテーション

これらのエンドポイントで Seedream 5 画像を非同期生成できます。クレジット消費は品質とモードによって変わります。

認証

すべてのリクエストには、API キーを Authorization header:

Authorization: Bearer <YOUR_API_KEY>

キーがないか無効な場合は、 401 Unauthorized.

POST

https://seedream45ai.org/api/generate

生成タスクの作成

新しい Seedream 5 ジョブを送信します。この呼び出しは、レンダリングが非同期で完了する間、すぐに task_id を返します。

パラメータ	タイプ	必須	説明
prompt	string (max 1500 chars)	はい	メインのテキスト説明（最大1500文字）。すべてのリクエストで必須です。
aspectRatio	string	はい	対応比率：1:1 · 3:4 · 4:3 · 9:16 · 16:9。
quality	string (basic \| high)	はい	basic（高速、2K）または high（高精細、4K）。
imageUrls	string[]	いいえ	任意の参照画像。編集モードでは必須です。

クレジット消費

クレジットはタスク作成時に差し引かれます。失敗したジョブは自動的に返金されます。

プリセット	差し引かれたクレジット
テキストから画像 · Basic	12
テキストから画像 · High	18
参照画像編集 · Basic	18
参照画像編集 · High	24
4枚連続生成（1回の呼び出し）	48

リクエスト例

POST https://seedream45ai.org/api/generate
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
  "aspectRatio": "4:3",
  "quality": "high",
  "imageUrls": []
}

レスポンス例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71"
  }
}

GET / POST

https://seedream45ai.org/api/status

タスクステータスの確認

このエンドポイントを使用して、最新のレコードをポーリングします。タスクがまだ IN_PROGRESS (進行中) の場合は、応答する前にもう一度プロバイダーに問い合わせます。

パラメータ	タイプ	必須	説明
task_id	string	はい	/generate が返す ID。/status 呼び出し時にクエリ（?task_id=）で指定します。

フィールド	説明
task_id	/generate から返された ID。
status	SUCCESS (成功)
request	送信されたペイロードのサニタイズされたコピー。
response	ステータスが SUCCESS の場合のメディア URL の配列。
consumed_credits	タスクに対して請求されたクレジット（返金時は 0）。
error_message	ステータスが FAILED の場合のプロバイダーエラーメッセージ。
created_at	ジョブが保存されたときの UTC タイムスタンプ。

リクエスト例

GET https://seedream45ai.org/api/status?task_id=sd5_b83bf7c0c51a4c71
Authorization: Bearer <YOUR_API_KEY>

レスポンス例

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71",
    "status": "SUCCESS",
    "request": {
      "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
      "aspectRatio": "4:3",
      "quality": "high"
    },
    "response": [
      "https://watch_001.png"
    ],
    "consumed_credits": 12,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

エラー処理

401 Unauthorized - API キーがないか無効です。
402 Payment Required - クレジット残高が控除額をカバーできませんでした。
429 Too Many Requests - ポーリング頻度またはリクエストレートを下げてください。
500 - 一時的な問題です。指数関数的バックオフで再試行してください。