Seedream
Seedream 5.0 Pro の制限と、プロンプトに書いたピクセル座標とカラーコードで動かす精密な領域編集。
Seedream 5.0 Pro は ListenHub における ByteDance の画像モデルで、カタログの中で精密編集に対応する 唯一のモデルです — 全体を生成し直すのではなく、既存画像の指定した領域を変更します。共通の画像 エンドポイントで動作します。エンドポイント、リクエストスキーマ、非同期の流れ、エラーコードについては 画像生成の概要 を参照してください。本ページで扱うのは Seedream 固有の内容だけです。
モデル
| モデル | 表示名 | 主な用途 |
|---|---|---|
seedream-5-0-pro | Seedream 5.0 Pro | 指定した画像の特定の領域を編集する用途 |
provider: "bytedance" を指定します。
制限
| 制限項目 | 値 |
|---|---|
| 画像サイズ | 1K、2K — 4K は 400 が返ります |
| アスペクト比 | 極端な 4 種を含む 14 種すべて |
| デフォルトのアスペクト比 | リクエストスキーマ由来の 1:1 |
| 参照画像 | 最大 10 件 |
quality | 無視されます |
Seedream が検証するのはサイズで、比率ではありません。スキーマが受け付ける比率はすべて範囲内で、Nano
Banana では Flash でしか許可されない極端な 4 種も含みます。出力のピクセル数は、サイズの予算と送信した
aspectRatio から計算されます — その aspectRatio はスキーマのデフォルトで 1:1 になるため、元画像に
合わせて明示的に指定してください。唯一の厳格な制限はサイズで、4K は code: 29003 とともにそのまま
拒否され、黙って 2K に引き下げられることはありません。
精密編集
専用の編集エンドポイントはなく、マスクや領域のパラメータもありません。編集は同じ生成エンドポイントを使い、
元画像を referenceImages に入れ、「何をどう変えるか」を prompt に書きます。モデルは絶対ピクセル座標
（原点は画像の左上隅）と業界標準のカラーコードを、プロンプトのテキストから直接読み取ります。
{
"provider": "bytedance",
"model": "seedream-5-0-pro",
"prompt": "Treating the top-left corner as the coordinate origin, change the content inside top-left:(376,363) bottom-right:(701,638) to green, and leave everything else unchanged",
"referenceImages": [
{
"fileData": {
"fileUri": "https://assets.listenhub.app/your-source-image.png",
"mimeType": "image/png"
}
}
],
"imageConfig": { "imageSize": "2K", "aspectRatio": "1:1" }
}サーバーはプロンプトをそのまま渡すだけで、座標を解析しません。プロダクトが視覚的な編集操作（矩形選択、
なげなわ、矢印）を提供している場合は、prompt に書き込む前に、自前のフロントエンドで座標の文字列に
変換するか、注釈を参照画像に焼き込んでください。aspectRatio は元画像の実際の比率に合わせてください。
一致していないと、モデルが 1 つの領域を編集するのではなく画像全体を再構成することがあります。
料金
Seedream は画像サイズごとの固定クレジットコストで課金され（pricing.mode は fixed）、
requiresSubscription を設定することはありません。無料枠リソース（seedream-5-0-pro）があり、1K と
2K で使えます — 対応するすべてのサイズです。正確な数値は
POST /v1/images/generation/estimate-credits
を呼び出して取得してください。
例
curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/async" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "bytedance",
"model": "seedream-5-0-pro",
"prompt": "Treating the top-left corner as the coordinate origin, repaint the jacket inside top-left:(120,240) bottom-right:(520,880) in #1F4D3A, keep the face, hair and background unchanged",
"referenceImages": [
{ "fileData": { "fileUri": "https://example.com/portrait.png", "mimeType": "image/png" } }
],
"imageConfig": { "imageSize": "2K", "aspectRatio": "3:4" }
}'完全なパラメータ一覧と参照画像を含むリクエストの形式は、 画像生成の概要 を参照してください。