はじめに
このエンドポイントの役割
Seedream 5.0 Flash 画像編集は、参照画像 1〜10 枚と指示を受け取り、画像を 1 枚返します。参照が 1 枚なら修正で、新しい衣装、新しい季節、新しい場所に変えられます。複数なら、顔、衣装、場所を 1 つのフレームに組み合わせます。
効いてくる入力
image_urls は画像 1〜10 枚（jpeg、png、webp、各 30 MB まで）を受け取り、その順番がプロンプトから参照する順番になります。prompt は最大 5,000 文字で、素材ごとに役割を書いてください。aspect_ratio は 15 種類の形から選び、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 文字以内 |
image_urls | はい | 参照画像 1〜10 枚（jpeg、png、webp、各 30 MB まで）。並び順に意味があり、プロンプトは 1 枚目、2 枚目、3 枚目と参照します。 1 件以上 · 10 件以内 |
aspect_ratio | いいえ | 1:3〜3:1 の 15 種類から選びます（4:5、21:9、9:21 を含む）。配置でフレームが決まるときに指定してください。 |
resolution | いいえ | 1k、1.5k、2k から選び、既定は 2k です。3 段階とも 1 枚あたりの料金は同じなので、既定がいちばん高精細です。 |
output_format | いいえ | 既定は jpeg で、ほかに png。png は可逆で、レタッチへ渡すのに安全です。 |
background | いいえ |
|
料金
$0.029 / 枚
ユースケース
文字がきちんと入るポスターと広告
レトロな映画ポスター、アクセント記号入りの香水ビジュアル、プロモーション用のタイルなど。文言は正確に引用符で囲み、位置を指定し、公開前に綴りを確認してください。
シーンをまたいだキャラクターの一貫性
あるカットの顔と、別のカットの衣装やロケ地を 1 回の編集にまとめて渡します。撮り直しなしで、同じ人物を新しい場面に置く近道です。
エディトリアルと閉店後のスチル
シルク、開いた襟元、閉店後のゆっくりしたダンス。フィルターなしの画像も、ほかのものと同じエンドポイントで動き、切り替えるスイッチは別にありません。
デザイン作業で使い回せるレイヤー
ポスターや広告をベース画像と要素に分け、見出しの差し替え、小物の色替え、パララックスの制作、被写体を新しいテンプレートに載せる、といった用途に使えます。
プロンプトガイドと実践のヒント
手元にあるものでエンドポイントを選ぶ
文章のアイデアならテキストから画像、変えたい・組み合わせたい写真なら画像編集、パーツごとに使いたい完成画像ならレイヤー分解です。画像を返す 2 つのエンドポイントは、1K・1.5K・2K のどれを選んでも同じ料金です。
形容詞ではなく、カットを書く
フレームに誰や何が入るか、何を着ているか、光がどこから来るか、レンズやフィルムの質感を書きます。このページの雨の窓辺のポートレートは、次のような指示から生まれました。30 代の女性が、深いエメラルド色のベルベットのドレス姿で、雨の筋が走る夜の窓辺にもたれている。ガラスと鎖骨にはピンクとティールの街のネオンが映り、彼女は半分微笑んでカメラを振り返る。35mm フィルムの質感。
タスクをポーリングし、プロンプトも保存する
タスクを作成し、終了状態になるまでポーリングして、プラットフォームのストレージから画像を取得します。シードがないため同じ画像を再現することはできません。残しておく結果には、必ずプロンプトも一緒に保存してください。
はじめに
Seedream 5.0 Flash 画像編集は、お渡しした画像を文章の指示に従って変更または合成します。参照画像を 1〜10 枚読み込むので、手直しにも、別々の写真から 1 つの場面を組み立てる用途にも使えます。
ByteDance が開発したモデルです（モデル ID は dola-seedream-5-0-flash-260915）。どの解像度でも 1 枚あたりの料金は同じです。
出発点となる素材で Seedream 5.0 Flash のモードを選ぶ
| 出発点となる素材 | モード |
|---|---|
| 新しい画像のための文章 | Seedream 5.0 Flash テキストから画像 |
| 手直しや合成をしたい画像 1〜10 枚 | Seedream 5.0 Flash 画像編集 |
| パーツごとに使いたい完成画像 | Seedream 5.0 Flash レイヤー分解 |
主な特長
人物はそのままに、ほかを変える
衣装替えのテストでは、顔、髪型、ポーズ、カップ、ベッドはそのままに、衣装が変わり、朝の光は午後の日差しに変わりました。
10 枚の参照、それぞれに役割
役割は並び順で割り当てます。あるテストでは 3 枚の写真を使いました。1 枚目は顔と髪、2 枚目は背中の開いた赤いサテンのガウン、3 枚目はパリのバルコニーです。結果は、そのバルコニーでそのガウンを着た 1 人の女性でした。
被写体を残したまま場面を変える
屋上のポートレートを雨のネオンの路地へ移しました。同じ男性、同じ前を開けたシャツとポーズのまま、濡れたシャツになり、ピンクとティールの看板が濡れた地面と肌に映っています。
フィルターなしの衣装作業
フィルターなしの衣装替えと再照明は、同じエンドポイントでフラグなしに動きます。
ユースケース
撮り直しなしで写真のスタイルを変える
衣装、天気、時間帯、場所を変え、残したいものを書き添えます。
顔、衣装、場所を組み合わせる
要素ごとに参照を 1 枚ずつ使い、どれが何かを書きます。
キャラクターセットを作る
同じ顔を使い回しながら、衣装や舞台を変えていきます。
完成したフレームのライティングをやり直す
新しい光源、向き、色を頼み、被写体は固定したままにします。
プロンプトのコツ
すべての参照に名前を付ける
image_urls には、プロンプトで使う順番に画像を並べます。それぞれが何を担い、何に手を付けないかを書いてください。
- 1 枚目：残したい人物。
- ほかの参照は、特定の役割があるときだけ加えます。
- 変えてはいけないものを書きます。
- 新しい場面と光を描写します。
画像 1 は残したい顔と髪型。画像 2 は背中の開いた赤いサテンのガウンだけを提供する。画像 3 はロケーション。
画像 1 と同じ女性が、画像 3 の鉄の手すりのそばに 1 人でいて、画像 2 のガウンを着て、素肩越しにカメラを振り返っている。背後には暖かな窓明かり。
元の画像から編集する
編集を何度も重ねると絵柄がずれていきます。元のフレームに戻り、1 回に 1 つだけ変えてください。
コンテンツに関する注意
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/edit",
"input": {
"aspect_ratio": "auto",
"background": "opaque",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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 リファレンスを参照してください。
