開発者向けリファレンス

Seedream 5 Pro APIドキュメント

このサイトの非同期APIでSeedream 5 Proの画像を生成できます。Seedream 5.5はプレビュー段階であり、ここではまだ呼び出せません。

クイックスタート

  1. ワークスペースのAPIキー管理画面でキーを作成します。
  2. model=seedream-5-proとプロンプトをPOST /api/v1/images/generateへ送信します。
  3. 返されたdata.task_idと同じAPIキーでGET /api/v1/images/status?task_id=TASK_IDを繰り返し問い合わせます。

認証

サーバーからAuthorization: Bearer YOUR_API_KEYを送信してください。ブラウザーのログインセッションやCookieは不要です。APIキーは非公開で保管してください。

Authorization: Bearer YOUR_API_KEY

エンドポイントとリクエスト項目

POST /api/v1/images/generate

model、prompt、aspect_ratio、resolution(1kまたは2k)を含むJSON本文を送信します。任意のimage_urlsには最大10件の参照画像URLを指定でき、publicは任意の真偽値です。応答はcode、message、task_idとstatusを含むdataを返します。

GET /api/v1/images/status?task_id=TASK_ID

task_idで問い合わせると、code、message、task_id、status、consumed_credits、image_urls(画像URLの配列)を含むdataが返ります。失敗時にはerror_messageが含まれる場合があります。

呼び出せるモデルは次の1つです: seedream-5-pro

処理中は問い合わせを続け、完了時はimage_urls、失敗時はerror_messageを確認してください。

cURLの例

コマンドをターミナルにコピーし、YOUR_API_KEYを自分の非公開APIキーに置き換えてください。次にTASK_IDを最初の応答のdata.task_idに置き換えます。

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"はっきりと読みやすい文字を使ったカフェのポスター","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'