はじめに
このエンドポイントでできること
ByteDance の Seedream 4.5 による画像編集です。1 枚から 14 枚の画像と、それぞれから何を取り入れるかを書いたプロンプトを渡します。当社のテストでは、ある画像の赤いサテンのドレスを別の画像の女性に着せながら、彼女の顔、そばかす、赤い髪は保ちました。同じポートレートを新しい衣装で地中海のテラスに移し、1940 年代の白黒スチルにもリスタイルしました。ByteDance は、複数の画像で編集すると 4.5 は主要な被写体をより正確に認識すると説明しています。
大事な入力
prompt は 1〜3,000 文字です。画像は、アップロードした順に Image 1、Image 2 のように名付けてください。image_urls は JPEG、PNG、WebP の画像を 1〜14 枚、1 枚 30 MB までです。aspect_ratio は 8 種で、auto はありません。元画像に最も近いものを選んでください。resolution は 2k(約 400 万画素、既定)か 4k です。出力サイズは元画像にも少し左右されるので、ピクセル数を正確に当てにしないでください。
返ってくるもの
参照画像の枚数にかかわらず 1 リクエストにつき 1 枚を、プラットフォームのアセット URL で返します。1 枚 $0.04 です。当社のテストでは、編集はたいてい 30 秒未満で終わりました。失敗したリクエストには課金されません。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | テキストから画像、画像編集 |
| 提供元 | ByteDance の Seedream 4.5 |
| プロンプト | 1〜3,000 文字。英語でよく機能します |
| 参照画像 | 画像編集のみ:1〜14 枚、JPEG・PNG・WebP、1 枚 30 MB まで |
| アスペクト比 | 8 種:1:1(既定)、4:3、3:4、16:9、9:16、3:2、2:3、21:9 |
| 解像度 | 2k(約 400 万画素、既定)または 4k(約 1,600 万画素)。料金は同じです |
| シード | なし:同じリクエストでも毎回違う画像が返ります |
| コンテンツポリシー | プロンプトにも結果にも、プラットフォームのフィルターはかかりません |
主な機能とハイライト
6240 x 2656 のシネマティックなフレーム
21:9 の 4k フレーム。ブルーアワーのマンハッタンの屋上に立つ、エメラルド色のサテンのドレス姿の女性。ストリングライト、背後に広がる街並み、手すりの上のシャンパングラス。
綴りの正しいタイトルのポスター
タイトル THE VELVET HOUR と一行 IN CINEMAS THIS WINTER は、2k の 2:3 ポスターに引用どおり出ました。文字列はそれぞれ引用符で囲み、置く位置を書いてください。
一方の画像の女性に、もう一方の画像のドレス
Image 1 は女性、Image 2 は赤いサテンのドレスを提供しました。結果は彼女の顔、そばかす、赤い髪を保ち、ドレスのドレープ状のネックラインと細いストラップを写し取って、オペラハウスの階段に立たせています。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 1〜3,000 文字。必須。 1 文字以上 · 3000 文字以内 |
image_urls | はい | 1〜14 枚。必須。 1 件以上 · 14 件以内 |
aspect_ratio | いいえ | 1:1(既定)、4:3、3:4、16:9、9:16、3:2、2:3、21:9 のいずれか。auto はないので、元画像に最も近い比率を選んでください。 |
resolution | いいえ | 2k(約 400 万画素、既定)か 4k(約 1,600 万画素)。どちらも料金は同じです。 |
料金
$0.04 / 枚
1 枚 $0.04。参照画像の枚数、解像度(2k か 4k)、アスペクト比は料金を変えません。失敗したリクエストには課金されません。
ユースケース
ポスター、広告、商品写真
タイトルとキャッチコピーの入った映画ポスター、刻印入りの名前が映る香水瓶、4K のキャンペーン用フレーム。文字は引用符で囲み、位置を指定してください。
衣装と服の差し替え
ある画像の服を別の画像の人物に着せ、場所も新しい場所に移します。このページのオペラハウスの階段の編集例と同じ使い方です。
ポートレートのリスタイル
1 枚のポートレートを、夕暮れの海辺のテラスや 1940 年代の白黒スチルに変えます。本人の見分けはつくように保ちます。
フィルターなしの静止画
フィルターはかかりません。当社のテストでは、ほとんどの強度レベルが指定どおりに返りました。エディトリアルのフレーム、夜の場面、ドラマチックなポートレートも、ほかの題材と同じエンドポイントで作れます。
プロンプトガイドと実践のヒント
手元の素材でエンドポイントを選ぶ
言葉だけで描きたいアイデアはテキストから画像へ。変えたい、作り直したい、組み合わせたい既存の画像は画像編集へ。ファミリーの呼び出しでは、
image_urlsを含むリクエストは編集に、含まないリクエストはテキストから画像に振り分けられます。画像に入れたい文字は引用符で囲む
入れたい文字列はそれぞれ引用符で囲み、どこに置くか、どう見せるかを書いてください。このページのポスターや香水の例と同じ書き方です。当社のテストは英語で行いました。公開前に綴りを確認してください。
参照画像は番号で指定する
画像編集では、それぞれの画像の役割を書いてください。例:Image 1 の女性、Image 2 のドレス。参照画像はアップロードした順に番号が振られます。各画像に役割を与えたプロンプトなら、画像同士が混ざりにくくなります。
実行前にアスペクト比を選ぶ
編集には auto の比率がないため、元の画像に最も近い比率を選んで形を保ってください。気に入った結果があれば、プロンプトと設定も一緒に保存しておきましょう。シードがないので、同じリクエストでも毎回違う画像が返ります。
概要
Seedream 4.5 画像編集 は、ByteDance の画像モデル Seedream 4.5 で、プロンプトから画像を変更、リスタイル、組み合わせます。1 枚から 14 枚の参照画像を受け取り、Image 1、Image 2 のように名付けて指定します。返すのは 2K か 4K の 1 枚です。プラットフォームはコンテンツフィルターを加えていません。言葉だけで新しい画像を作るなら、Seedream 4.5 テキストから画像 を使ってください。
必要なものからモデルを選ぶ
| 必要なもの | モデル |
|---|---|
| 言葉だけで新しい画像を作る | Seedream 4.5 テキストから画像 |
| 最大 14 枚の画像を編集、リスタイル、組み合わせ | Seedream 4.5 画像編集(現在のページ) |
主な機能と特長
最大 14 枚の参照
当社のテストでは、ある画像の女性と別の画像のドレスを 1 枚にまとめられました。ByteDance は、複数画像の編集で 4.5 は主要な被写体をより正確に認識すると説明しています。
本人を見分けられる状態を保つ
当社のテストでは、顔、そばかす、赤い髪が新しい衣装や新しい場所に移っても保たれました。白黒のような大きなリスタイルでは、顔立ちがわずかに変わりました。
一律の料金
参照画像の枚数、2k か 4k にかかわらず 1 枚 $0.04 です。
フィルターなし
プラットフォームが拒否したりフィルターをかけたりすることはありません。当社のテストでは、強め・かなり強めは抑えられて返り、軽め・中程度・最大は指定どおりに返りました。
ユースケース
衣装の差し替え
ある画像の服を取り出して、別の画像の人物に着せます。
1 人の人物の新しい場面
同じポートレートを、テラス、階段、別の時間帯の街角に移します。
リスタイル
ポートレートを、時代、フィルムの雰囲気、照明の気分に変えます。
プロンプトガイドとプロのヒント
画像ごとに役割を与える
"the woman from Image 1" と "the gown from Image 2" のように書いてください。参照画像は並べた順に番号が振られます。
残すものを書く
残すべきもの(彼女の顔、そばかす、長い赤い髪)を名指しし、そのあとに変化(場所、衣装、光)を書いてください。
最も近い比率を選ぶ
auto の比率はありません。ポートレートなら 3:4 か 2:3、風景なら 4:3 か 3:2 で形が保たれます。
ピクセル数を当てにしない
2k の出力は約 400 万画素で、元画像にも少し左右されます。同じ 3:4 のリクエストでも 1776 x 2352 で返りました。
毎回新しい画像が出ると考える
シードはありません。気に入った結果は保存してください。
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-4.5/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"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 リファレンスを参照してください。













