Seedream

Seedream は同期呼び出しのみに対応し、1 回に 1 枚を生成して、24 時間有効な画像リンクを返します。

利用できるモデル

選び方:1K を出力できるのは Pro だけで、Pro では1.5K は 1K と同価格で生成品質が上のため 1.5K を優先してください。Lite と 4.5 の最小出力は 2K です。「Seedance 海外版 · Seedream」で使えるのは seedream-5-0-pro のみです。

リクエストパラメータ

生成

POST /v1/images/generations に JSON ボディで送ります。image を加えると、1 枚の編集、複数画像の合成、部分編集になります。

モデル別の制限:

WIDTHxHEIGHT のアスペクト比は 1:16〜16:1 の範囲内にしてください。size が不正な場合は生成前に 400 が返り、課金されません。

image の各要素は http(s) URL または base64 の Data URL で、Data URL は 1 枚 30 MB 以下です。対応形式は JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF です。URL は送信時にダウンロードもサイズ確認もされないため、サーバーから取得できる公開アドレスにしてください。

部分編集にマスクは使いません。参照画像に直接注釈を描き込み、その座標 / bbox / 矢印 / 塗りつぶした領域をプロンプトで説明してください。

編集

POST /v1/images/edits は、既存の OpenAI Images 編集コード向けの互換入口です。multipart/form-data を推奨し、生成と同じ JSON も受け付けます。参照画像は 1 枚以上必要です。

mask フィールドがあると 400 になります(null でも同じ)。上表にない multipart フィールドは無視されます。

レスポンス

標準の OpenAI Images JSON で同期的に返り、画像は data[].url に入ります。

{
  "model": "seedream-5-0-pro",
  "created": 1760000000,
  "data": [
    {
      "url": "https://…/result.jpeg?X-Signature=…",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}

例

テキストから画像

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "ネオンに照らされた夜の未来都市、映画的な構図",
    "size": "2048x2048",
    "response_format": "url"
  }'

参照画像で編集

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "1 枚目のカップを右側へ移動し、他はそのまま",
    "image": ["https://example.com/source.png"],
    "size": "2K",
    "output_format": "png",
    "response_format": "url"
  }'

注意事項

• 1 回のリクエストで 1 枚だけ生成されるため、複数枚は分けて送ってください。
• 同期のみ:Prefer: respond-async は無視され、同期で返ります。
• 結果は url のみで、b64_json には対応していません。
• size は auto を受け付けず、Lite と 4.5 の最小出力は 2K です。
• seedream-4-5 の出力は JPEG のみです。
• 従来のマスクには対応しないため、部分編集は注釈付きの参照画像とプロンプトで指示してください。

よくあるエラー

パラメータが不正な場合は生成前に 400 が返り、課金されません。コンテンツの安全チェックで拒否された場合も 400 で課金されず、理由は error.message に入ります。

model seedream-5-0-pro only supports size 1K, 1.5K, 2K or a valid WIDTHxHEIGHT pixel size   # 例: "size": "auto"
model seedream-5-0-lite requires the total pixel count of size to be between 3686400 and 16777216
size aspect ratio must be between 1:16 and 16:1
missing prompt
response_format only supports url
only a single output is supported (n=1)
model seedream-4-5 only supports output_format jpeg
model seedream-5-0-lite only supports optimize_prompt_options.mode standard
optimize_prompt_options must be an object
image must be a URL/data URL string or an array of strings
every item in the image array must be a URL or data URL string
image must not be empty
at most 10 reference images are supported
reference image 1 is invalid: data URL must be base64-encoded
reference image 1 is invalid: unsupported image format image/svg+xml
reference image 1 is invalid: a single image must not exceed 30 MB
image edits require at least one image reference            # /v1/images/edits に画像がない
seedream does not accept a traditional mask; ...            # /v1/images/edits に "mask" があると拒否、null でも同じ

課金

出力枚数で課金され、5.0 Pro は参照画像 1 枚ごとにも課金されます。生成失敗と安全チェックによる拒否は課金されません。5.0 Pro は出力ピクセル数の段階で価格が決まり、1K と 1.5K は同価格です。

単価は各モデルカードとログイン後のモデルカタログを参照してください。

次のステップ

• 画像生成の概要
• GPT Image、Gemini 画像、Grok 画像、Kling 画像
• API リファレンス:画像の生成、画像の編集
• エラーが出たときはエラー早見表を参照してください