ListenHubDocs
API リファレンス画像生成

Seedream

Seedream 5.0 Pro と 5.5 のモデル、サイズ制限、参照画像、クレジット料金。

Seedream 5.0 Pro と Seedream 5.5 は ListenHub の ByteDance 画像モデルです。共通の画像エンドポイントで テキストと参照画像から画像を生成できます。下記の精密編集の例では Seedream 5.0 Pro を使用します。 エンドポイント、リクエストスキーマ、非同期処理、エラーコードは 画像生成の概要 を参照してください。

モデル

モデル表示名主な用途
seedream-5-0-proSeedream 5.0 Pro指定した画像の特定の領域を編集する用途
seedream-5-5Seedream 5.5テキストと参照画像からの画像生成

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 つの領域を編集するのではなく画像全体を再構成することがあります。

料金

両モデルともサイズ別の固定料金(pricing.mode: "fixed")で、1K は 6 クレジット、2K は 15 クレジットです。 サブスクリプションは不要です。seedream-5-0-pro の無料枠を利用できるのは Seedream 5.0 Pro のみです。 Seedream 5.5 はこの無料枠を共有しません。 現在の見積もりは 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" }
  }'

完全なパラメータ一覧と参照画像を含むリクエストの形式は、 画像生成の概要 を参照してください。

このページの内容