メインコンテンツへスキップ
POST
Text-to-Image: generate an image from a text prompt
右側のインタラクティブなPlaygroundを使用すると、APIを直接呼び出すことができます。Authorizationにご自身のAPIキーを設定し(形式:Bearer sk-xxx)、promptを入力し、モデルとサイズを選択して送信を押してください。
適用範囲:このページでは純粋なテキストからの画像生成(imageフィールドなし)について説明します。参照画像編集、複数画像の合成、またはバッチシーケンス生成については、画像編集を参照してください — 同じエンドポイントで、パラメータのみが異なります。
🖥️ ブラウザPlaygroundの制限事項(b64_jsonモードのみ)デフォルトのresponse_format: "url"モードでは、Playgroundは正常に動作します(レスポンスは一時的なBytePlus TOSリンクのみです)。response_format: "b64_json"に切り替えると、レスポンスには数MBのbase64文字列が含まれ、ブラウザのPlaygroundに请求时发生错误: unable to complete requestが表示される場合があります — リクエスト自体は正常に成功しています。ブラウザがこれほど長いbase64文字列を描画できないだけです。推奨されるワークフロー:
  • 画像を確認したいだけの場合:デフォルトのurlモードのままにしてください — Playgroundが直接リンクを返します(24時間以内にご自身のストレージにダウンロードすることを忘れないでください)。
  • b64_jsonが必要な場合:以下のコードサンプルをコピーしてローカルで実行してください — コードが自動的に画像をデコードしてファイルに保存します。
⚠️ バージョンによって解像度ティアが異なります
  • seedream-5-0-flash-260915 — プリセット1K / 1.5K / 2K、および総ピクセル数0.92M〜4.62Mの正確な幅×高さ(WxH)、アスペクト比最大16:1(3K/4Kプリセットなし。プリセット使用時はモデルがアスペクト比を選択します。sequential_image_generation / streamは受け付けられず、渡すと400が返されます。画像1枚あたり約15〜20秒、$0.018/リクエスト)
  • 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-260128 — 2K / 3Kのみ(4Kなし)
  • seedream-4-5-251128 — 2K / 4K
  • seedream-4-0-250828 — 1K / 2K / 4K
サポートされていないサイズは400を返します。正確なピクセル数は、総ピクセル数 ∈ [1280×720, 4096×4096] かつアスペクト比 ∈ [1/16, 16] を満たす必要があります。
すべての画像APIは同期処理です — ポーリング用のタスクIDは存在せず、クライアントの接続が切断された場合、リクエストの課金は発生したまま結果が失われます。このモデルには十分なタイムアウト値を設定してください。詳細については画像APIの基本とベストプラクティスを参照してください。

コード例

Python(OpenAI SDK)

Python(生の requests)

cURL

Node.js(fetch)

ブラウザ JavaScript

パラメータリファレンス

詳細なパラメータ制約、許容値、サンプルは右側の Playground パネルで確認できます。編集/複数画像のパラメータ(image、sequential_image_generation など)は、画像編集ページに記載されています。

レスポンス形式

⚠️ レスポンスフィールドの注意点
  • response_format=url の場合、data[].url は 一時的な署名付き BytePlus TOS URL です(通常は 24 時間有効です)。本番では、すぐにご自身のストレージへダウンロードしてください。
  • response_format=b64_json の場合、data[].b64_json は data: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,
seedream-5-0-flash-260915
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 / 5.0-pro / 5.0-flash
  • 1.5K (~1536×1536) — 5.0-flash 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. Not accepted by 5.0-pro / 5.0-flash (returns 400)

レスポンス

Image generated successfully

model
string
例:

"seedream-5-0-260128"

created
integer

Unix timestamp

例:

1768518000

data
object[]
usage
object