リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
aspect_ratio | いいえ | 画面の形:横長、正方形、縦長。 auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · デフォルト: auto |
background | いいえ | 背景を残す・消す・差し替える。 opaque · transparent · デフォルト: opaque |
enable_thinking | いいえ | Run a thinking pass that refines the prompt before generating. Off is faster. デフォルト: true |
image_urls | はい | 編集・合成する写真。それぞれの役割をプロンプトに書きます。 |
output_format | いいえ | 結果のファイル形式。 jpeg · png · デフォルト: jpeg |
prompt | はい | Describe the image to produce from the source: subject, composition, style, and lighting. |
resolution | いいえ | 出力サイズ。大きいほど鮮明で、料金も上がります。 1k · 2k · デフォルト: 2k |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /枚 | ≈ USD |
|---|---|---|
| resolution 1K | 5.4 | $0.054 |
| resolution 2K | 10.8 | $0.11 |
タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 6クレジット/枚($0.06)です。
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Seedream 5.0 Pro API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を bytedance/seedream-5.0-pro/edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"resolution": "2k",
"output_format": "jpeg",
"background": "opaque"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Seedream 5.0 Pro API についての質問
Seedream 5.0 Pro API の料金はいくらですか?
Seedream 5.0 Proの最安は画像を編集で、6クレジット($0.06)/枚からです。オプション別の料金:1K 5.4クレジット/枚、2K 10.8クレジット/枚。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのSeedream 5.0 Proのモデル名は?
POST /jobs/createTask の model フィールドに 画像を作成は bytedance/seedream-5.0-pro/text-to-image;画像を編集は bytedance/seedream-5.0-pro/edit;レイヤー分割は bytedance/seedream-5.0-pro/layer-decomposition を指定します。
1 回の編集で参照画像は何枚まで使えますか?
最大 10 枚です。名指しのない素材は混ぜられるので、プロンプトで各枚に役割を割り当ててください。2 枚目以降の参照はすべて、送信前に表示される見積もりに乗ります。
出力サイズやアスペクト比を指定できますか?
はい。ただし自由なピクセル数ではなく、比率と段で指定します。aspect_ratio は 1:3 から 3:1 までの 15 種類、resolution は 1k か 2k です。text-to-image の既定は 1:1、編集の既定は auto で、1 枚目の参照に最も近い対応比率を選びます。幅*高さのプリセットで指定したい場合は Seedream 5.0 Lite を使ってください。
再現用の seed はありますか?
ありません。どちらのエンドポイントも公開していないので、同じリクエストを 2 回投げると 2 つの違うフレームが返ります。再利用の予定がある素材には、プロンプトを添えて保管してください。
JPEG と PNG のどちらを指定すべきですか?
レタッチや合成へ進み、可逆なエッジが効くなら png。確認のループや直接配信なら jpeg です。変わるのは受け取るファイルであって、生成された画像ではありません。
画像の中に文字を描けますか?
短い文字列がうまく入ることはありますが、このモデルの用途ではありません。看板、見出し、パッケージの文言には、画像内文字組のために作られたモデルを使ってください。
Seedream 5.0 Pro API の制限は?
解像度:1K · 2K;アスペクト比:auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 +10;参照画像:10;プロンプトの長さ(文字):5,000。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにSeedream 5.0 Proを試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでSeedream 5.0 Proを実行でき、実行ごとに対応するコードが表示されます。
すべての Seedream モデル
Seedream 5.0 Lite は2Kの固定サイズで動くので、シリーズものの統一感を保ちやすく、Seedream 5.0 Flash はより速く安い兄弟モデルです。最後の、最も作り込みたい1枚は Pro で。

