Skip to main content
POST
Text-to-Image: generate an image from a text prompt
右側のインタラクティブなプレイグラウンドから、API を直接呼び出せます。Authorization に API キーを設定し(形式: Bearer sk-xxx)、prompt を入力して、モデルとサイズを選び、送信してください。
対象範囲: このページでは純粋な text-to-image のみを扱います(image フィールドなし)。参照画像の編集、複数画像の融合、またはバッチシーケンス生成については、Image Editing をご覧ください。— 同じ endpoint で、パラメータが異なるだけです。
🖥️ ブラウザのプレイグラウンドの制限(b64_json モードのみ)既定の response_format: "url" モードでは、プレイグラウンドは問題なく動作します(レスポンスは一時的な BytePlus TOS リンクになるだけです)。response_format: "b64_json" に切り替えると、レスポンスに複数 MB の base64 文字列が含まれ、ブラウザのプレイグラウンドで 请求时发生错误: unable to complete request が表示されることがあります。— リクエスト自体は成功しています。ブラウザがそのような長い base64 文字列をレンダリングできないだけです。推奨ワークフロー:
  • 画像を表示したいだけですか? 既定の url モードのままにしてください — プレイグラウンドはリンクを直接返します(24時間以内にご自身のストレージへダウンロードすることを忘れないでください)。
  • b64_json が必要ですか? 下のコードサンプルをコピーして、ローカルで実行してください — コードが自動的に画像をデコードしてファイルに保存します。
⚠️ 解像度の階層はバージョンによって異なります
  • seedream-5-0-pro-260628 — プリセット 1K / 2K に加え、合計ピクセル数 4.19M までの正確な WxH(16:9 では最長辺が 2720×1530 に達することを確認済み。3K/4K のプリセットはありません。sequential_image_generation / stream は受け付けられず、渡すと 400 が返ります。画像 1 枚あたり約 2 分)
  • seedream-5-0-2601282K / 3K のみ(4K なし)
  • seedream-4-5-2511282K / 4K
  • seedream-4-0-2508281K / 2K / 4K
サポートされていないサイズは 400 を返します。正確なピクセル値は、合計が [1280×720, 4096×4096]、アスペクト比が [1/16, 16] の範囲内である必要があります。
すべての image API は同期型です。ポーリングする task ID はなく、クライアントが切断されると、リクエストは課金されたまま結果が失われます。このモデルでは十分長いタイムアウトを設定してください。Image API の基本とベストプラクティス をご覧ください。

コード例

Python(OpenAI SDK)

Python(生の requests)

cURL

Node.js(fetch)

ブラウザ JavaScript

パラメータリファレンス

詳細なパラメータ制約、許可される値、例は右側の Playground パネルで確認できます。編集 / 複数画像パラメータ(imagesequential_image_generation など)は Image Editing ページで説明されています。

レスポンス形式

⚠️ レスポンスフィールドの注意点
  • response_format=url の場合、data[].url一時的な署名付き BytePlus TOS URL です(通常は 24 時間有効です)。本番では、すぐにご自身のストレージへダウンロードしてください。
  • response_format=b64_json の場合、data[].b64_jsondata:image/...;base64, プレフィックスのない プレーンな base64 文字列 です。ファイル出力用にデコードする(base64.b64decode)か、ブラウザ表示用にご自身でプレフィックスを付けてください。
  • data[].size実際の出力サイズ を反映しており、モデルのアスペクト比正規化後に要求した size とわずかに異なる場合があります。
usage.generated_images は課金対象の画像枚数を反映します。Seedream は画像ごとに課金されます。output_tokens / total_tokens はオブザーバビリティ指標であり、課金には影響しません。

承認

Authorization
string
header
必須

API Key obtained from APIYI Console

ボディ

application/json
model
enum<string>
デフォルト:seedream-5-0-260128
必須

Model ID

利用可能なオプション:
seedream-5-0-260128,
seedream-5-0-lite-260128,
seedream-4-5-251128,
seedream-4-0-250828,
seedream-5-0-pro-260628
prompt
string
必須

Prompt, supports both English and Chinese. Describe scene, style, and lighting in detail for better results.

:

"A serene Japanese garden with cherry blossoms, koi pond, traditional bridge, golden hour, ultra detailed"

size
string
デフォルト:2K

Output size. Preset tiers (vary by version):

  • 1K (~1024×1024) — 4.0 only
  • 2K (~2048×2048) — 5.0 / 4.5 / 4.0
  • 3K (~3072×3072) — 5.0 only
  • 4K (~4096×4096) — 4.5 / 4.0

Or exact pixel size WxH, total pixels ∈ [1280×720, 4096×4096], aspect ratio ∈ [1/16, 16]

:

"2K"

response_format
enum<string>
デフォルト:url

url returns a temp signed link (24h validity); b64_json returns plain base64 (no data: prefix)

利用可能なオプション:
url,
b64_json
output_format
enum<string>
デフォルト:jpeg

Output format. 5.0 supports png/jpeg; 4.5/4.0 only jpeg

利用可能なオプション:
png,
jpeg
seed
integer

Random seed. Note: officially supported only by seedream-3-0-t2i; ignored by the current 4.x / 5.x models

:

42

watermark
boolean
デフォルト:false

Whether to include the BytePlus watermark. Set to false for commercial use

stream
boolean
デフォルト:false

Enable streaming output. Useful for long prompts and high-resolution generation

レスポンス

Image generated successfully

model
string
:

"seedream-5-0-260128"

created
integer

Unix timestamp

:

1768518000

data
object[]
usage
object