はじめに
このエンドポイントの役割
Seedream 5.0 Flash テキストから画像は、文章のブリーフから画像を 1 枚生成します。文字が正確に入るポスター、ポートレート、商品スチル、フィルターなしのエディトリアルシーンに対応し、どの解像度でも料金は同じです。
効いてくる入力
prompt は最大 5,000 文字で、被写体、衣装、光、レンズを一度に書き込めます。aspect_ratio は 1:3〜3:1 の 15 種類から選び、既定は 1:1 です。resolution は 1k、1.5k、2k から選び、既定は 2k です。output_format は jpeg か png を選びます。
シード項目はないため、同じリクエストでも毎回異なるフレームが返ります。
コンテンツについて
フィルターなしのシーンも、フラグなし・別エンドポイントなしで動きます。
返ってくるもの
1 リクエストにつき画像 1 枚で、プラットフォームの素材 URL として返ります。課金は、送信前に表示される見積もりに基づく画像 1 枚単位です。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| エンドポイント | テキストから画像、画像編集、レイヤー分解 |
| テキストと編集の入力 | プロンプトは最大 5,000 文字、編集では参照画像 1〜10 枚 |
| アスペクト比 | 1:3〜3:1 の 15 種類 |
| 解像度 | 1k、1.5k、2k（既定は 2k）。3 段階とも 1 枚あたりの料金は同じ |
| レイヤー分解 | 画像 1 枚を入力すると、ベース画像と最大 16 枚の透過 PNG レイヤーを出力（合計で最大 17 枚） |
| 再現性 | シード項目なし。同じリクエストでも毎回異なる結果になります |
主な機能とハイライト
綴りどおりに文字が入るポスター
このページのレトロ映画ポスターでは、クリーム色のセリフ体のタイトル、キャッチコピー、黄色い半券まで、指示どおりに描かれています。文言が決まっているなら引用符で囲み、置く位置も書いてください。軽量で低価格な段階でも、レイアウトの指示がきちんと通るかを確かめる最初のテストにおすすめです。
3 枚の写真から、顔・ドレス・場所を合成
編集エンドポイントは参照画像 1〜10 枚を順番どおりに読み込みます。この例では、1 枚目が顔と髪、2 枚目が背中の開いた赤いサテンのガウン、3 枚目がパリのバルコニーで、その役割をプロンプトに書きました。結果は、そのバルコニーで肩越しに振り返る 1 人の女性です。各画像の役割を書かないと、モデルは素材を混ぜてしまいます。
完成したポスターを、動かせるパーツに分ける
レイヤー分解では、切り出した要素の後ろまで背景を補修したきれいなベース画像と、名前と位置の枠が付いた要素ごとの透過 PNG が返ります。このポスターでは、ダイナー、遠くの車、ネオンサイン、女性、キャッチコピー、タイトル、半券が分かれ、どのパーツも元の位置にぴったり戻ります。文言の差し替え、パーツの削除、女性を別のデザインで再利用することもできます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 最大 5,000 文字。フレームに入る人物、衣装、光の来る方向、レンズの質感に使ってください。 1 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 既定は 1:1 で、ほかに 1:3〜3:1 の 14 種類から選べます（4:5、21:9、9:21 を含む）。テキストの側には自動モードがないため、納品する比率を指定してください。 |
resolution | いいえ | 1k、1.5k、2k から選び、既定は 2k です。3 段階とも 1 枚あたりの料金は同じなので、既定がいちばん高精細です。 |
output_format | いいえ | 既定は jpeg で、ほかに png。png は可逆で、レタッチや合成へ渡すのに安全です。 |
料金
$0.029 / 枚
ユースケース
文字がきちんと入るポスターと広告
レトロな映画ポスター、アクセント記号入りの香水ビジュアル、プロモーション用のタイルなど。文言は正確に引用符で囲み、位置を指定し、公開前に綴りを確認してください。
シーンをまたいだキャラクターの一貫性
あるカットの顔と、別のカットの衣装やロケ地を 1 回の編集にまとめて渡します。撮り直しなしで、同じ人物を新しい場面に置く近道です。
エディトリアルと閉店後のスチル
シルク、開いた襟元、閉店後のゆっくりしたダンス。フィルターなしの画像も、ほかのものと同じエンドポイントで動き、切り替えるスイッチは別にありません。
デザイン作業で使い回せるレイヤー
ポスターや広告をベース画像と要素に分け、見出しの差し替え、小物の色替え、パララックスの制作、被写体を新しいテンプレートに載せる、といった用途に使えます。
プロンプトガイドと実践のヒント
手元にあるものでエンドポイントを選ぶ
文章のアイデアならテキストから画像、変えたい・組み合わせたい写真なら画像編集、パーツごとに使いたい完成画像ならレイヤー分解です。画像を返す 2 つのエンドポイントは、1K・1.5K・2K のどれを選んでも同じ料金です。
形容詞ではなく、カットを書く
フレームに誰や何が入るか、何を着ているか、光がどこから来るか、レンズやフィルムの質感を書きます。このページの雨の窓辺のポートレートは、次のような指示から生まれました。30 代の女性が、深いエメラルド色のベルベットのドレス姿で、雨の筋が走る夜の窓辺にもたれている。ガラスと鎖骨にはピンクとティールの街のネオンが映り、彼女は半分微笑んでカメラを振り返る。35mm フィルムの質感。
タスクをポーリングし、プロンプトも保存する
タスクを作成し、終了状態になるまでポーリングして、プラットフォームのストレージから画像を取得します。シードがないため同じ画像を再現することはできません。残しておく結果には、必ずプロンプトも一緒に保存してください。
はじめに
Seedream 5.0 Flash テキストから画像は、文章のブリーフから新しい画像を生成します。本物の文字入りのポスター、ポートレート、商品や香水のスチル、エディトリアルや深夜の場面など、写真ではなく言葉から始めたいときにお使いください。
ByteDance が開発したモデルです（モデル ID は dola-seedream-5-0-flash-260915）。どの解像度でも 1 枚あたりの料金は同じなので、既定の 2K がいちばん高精細です。
出発点となる素材で Seedream 5.0 Flash のモードを選ぶ
| 出発点となる素材 | モード |
|---|---|
| 新しい画像のための文章 | Seedream 5.0 Flash テキストから画像 |
| 手直しや合成をしたい画像 1〜10 枚 | Seedream 5.0 Flash 画像編集 |
| パーツごとに使いたい完成画像 | Seedream 5.0 Flash レイヤー分解 |
主な特長
書いたとおりに出てくる文字
このページのレトロ映画ポスターには、クリーム色のセリフ体のタイトル、キャッチコピー、半券が、指示どおりの綴りで入っています。香水広告でも、アクセント記号入りの見出しが正しく描かれました。文言は正確に引用符で囲み、置く位置も書いてください。
15 種類の比率と、均一料金の 3 段階
aspect_ratio は 1:3〜3:1、resolution は 1k・1.5k・2k（既定は 2k）です。私たちの実行では、21:9 の 2K は 3136 × 1344、4:5 の 1.5K は 1376 × 1712 で返りました。
スイッチなしで使えるフィルターなしの画像
フィルターなしのプロンプトは、ほかと同じエンドポイントで動き、年齢区分のフラグはありません。
5,000 文字のブリーフ
被写体、衣装、光、レンズ、カラーグレーディングまで、1 つのプロンプトに収まる余裕があります。
ユースケース
映画ポスターと広告スチル
タイトルとキャッチコピーを引用符で囲み、その周りの構図を言葉で説明します。
キャラクターのポートレートシリーズ
まず 1 つ、しっかりした演出を書き、その顔を画像編集エンドポイントで新しい場面へ引き継ぎます。
ワイドバナー
このページのプールサイドの泳者のように、シネマティックなワイドフレームには 21:9 を指定します。
閉店後のエディトリアル
朝の柔らかな窓明かり、パリのバルコニーのシルク、ボールルームにたった二人で踊るダンサー。
プロンプトのコツ
カットを書く
フレームに誰や何が入るか、何を着ているか、光がどこから来るか、レンズやフィルムの質感を書きます。このページの雨の窓辺のポートレートは、35mm フィルムの質感と、ピンクとティールの街のネオンを使っています。
aspect_ratioで形を選びます。- 被写体、衣装、場所を描写します。
- 光の向き、色、硬さを書きます。
- 文字は正確に引用符で囲み、置く位置を書きます。
レトロな映画ポスター、縦 3:4。赤いトレンチコートの女性が、赤いネオンサインの下、雨の夜のダイナーのワゴンの前で紙コップのコーヒーを持っている。
上部いっぱいにクリーム色のセリフ体のタイトル「LATE SHIFT」。その下に小さめの 1 行「Some orders never get cancelled」。
右下には「ADMIT ONE」と書かれた黄色い半券。
指定した文字だけを使い、余計なバッジやロゴは入れない。
下書きは 1k、納品は 2k
どの段階も同じ料金なので、低い解像度で下書きしても節約にはなりませんが、構図を詰めている間は 1k のほうが確認が速くなります。
コンテンツに関する注意
Seedream 5.0 Flash · テキストから画像。 SpicyAPI はプラットフォーム側のコンテンツフィルターを追加していません。モデル側の制限は引き続き適用され、結果は保証されません。ご利用にあたっては、コンテンツポリシーを遵守してください。
フィルターなしのコンテンツに、別のスイッチや別のエンドポイントは必要ありません。未成年者を含む素材、同意のない性的な画像、実在する人物へのなりすましを目的とする素材は送信しないでください。これは利用上の禁止事項であり、すべてのリクエストを自動審査するという意味ではありません。
商用利用への適合性、必要な権利の確認、最終的な編集判断は、利用者の責任で行ってください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-flash/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
