開発者向けリファレンス
Seedream 5 Pro APIドキュメント
このサイトの非同期APIでSeedream 5 Proの画像を生成できます。Seedream 5.5はプレビュー段階であり、ここではまだ呼び出せません。
クイックスタート
- ワークスペースのAPIキー管理画面でキーを作成します。
- model=seedream-5-proとプロンプトをPOST /api/v1/images/generateへ送信します。
- 返された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/generatemodel、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_IDtask_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'