API
Seedream 5.0 Pro API
画像Seedream 5.0 Pro API は、テキストからの画像生成と参照画像の編集に対応し、柔軟なアスペクト比と 1K・2K 出力を提供します。
ボディ
application/jsonmodelstring必須seedream-5-0-proinput.promptstring必須作成したい画像、または参照画像に加えたい変更内容を記述します。前後の空白は除去されます。
input.imagesstring[]任意任意の参照画像 URL。一般公開されている HTTPS URL のみを使用してください。テキストから画像を生成する場合は省略できます。
最大 16 件。
input.aspect_ratiostring任意出力画像のアスペクト比。デフォルトは 1:1 です。
デフォルト: 1:1
input.resolutionstring任意出力画像の解像度。小文字の 1k または 2k を使用します。デフォルトは 1k です。
デフォルト: 1k
リクエスト例
POST /api/v1/createcurl -X POST https://nanobanana.io/api/v1/create \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-0-pro",
"input": {
"prompt": "未来的なバナナ型カメラを写したシネマティックな商品写真",
"aspect_ratio": "1:1",
"resolution": "1k"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "seedream-5-0-pro",
"status": "processing",
"credits": 50
}
}返されたタスク ID を使い、タスクが完了または失敗するまでこのエンドポイントをポーリングしてください。最新状態を確認するため、5 秒ごとのポーリングを推奨します。
POST /api/v1/check{
"task_id": "task_example"
}レスポンス
POST /api/v1/checkが返すタスクの状態です。以下のID、URL、タイムスタンプは例です。
idstring必須data.idはタスクの識別子で、状態確認リクエストのtask_idと一致します。
statusstring必須failed_reasonstring任意statusがfailedの場合にのみ返され、失敗の理由を示します。completedとprocessingではこの項目は含まれません。
完了 · completed
ダウンロードURLはdata.data.resultsにあります。
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "seedream-5-0-pro",
"status": "completed",
"data": {
"results": [
"https://example.com/generated.png"
],
"processing_time": 18
}
}
}その他の状態
processingまたはfailedではdata.dataはnullです。以下はfailedの例です。failed_reasonはfailedの場合にのみ含まれます。processingでは状態確認を続け、failedでは停止してください。
POST /api/v1/check · HTTP 200{
"data": {
"id": "task_example",
"created_at": 1791244800,
"model": "seedream-5-0-pro",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}消費クレジット
1回のリクエストで画像を1枚生成する場合の消費クレジットです。
| 解像度 | 1K | 2K |
|---|---|---|
| 画像1枚 | 50 | 100 |
任意のパラメータを省略: 50 クレジット
該当する料金を適用するには、表に記載されたinputパラメータを明示的に指定してください。複数の画像を生成するリクエストでは、消費クレジットが増える場合があります。
POST /api/v1/createのレスポンスに含まれるcreditsフィールドが、そのタスクで差し引かれたクレジット数を示します。