はじめに
このエンドポイントでできること
ByteDance の Seedream 4.5 によるテキストから画像です。当社のテストでは、映画ポスターのタイトルと下の一行、香水瓶の刻印を一字違わず画像に入れ、1970 年代のプールに集まった 4 人の場面を描き、4k で 21:9 のフレーム（6240 x 2656）を返しました。プラットフォームによるコンテンツフィルターはありません。当社のテストでは、かなり強めは抑えられて返り、ほかの強度レベルは指定どおりに返りました。
大事な入力
prompt は 1〜3,000 文字です。文字はすべて引用符で囲み、置く位置を書いてください。aspect_ratio は 8 種で、既定は 1:1 です。resolution は 2k（約 400 万画素、既定）か 4k（約 1,600 万画素）です。2k の 3:4 画像は 1728 x 2304 です。シード、ネガティブプロンプト、出力形式の切り替えはありません。
返ってくるもの
1 リクエストにつき 1 枚を、プラットフォームのアセット URL で返します。比率や解像度にかかわらず 1 枚 $0.04 です。当社のテストでは 2k の画像はたいてい 30 秒未満、4k の画像は約 28 秒でした。失敗したリクエストには課金されません。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 画像 |
| エンドポイント | テキストから画像、画像編集 |
| 提供元 | 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 文字以内 |
aspect_ratio | いいえ | 1:1（既定）、4:3、3:4、16:9、9:16、3:2、2:3、21:9 のいずれか。2k では 16:9 は 2848 x 1600、4:3 は 2304 x 1728 です。 |
resolution | いいえ | 2k（約 400 万画素、既定）か 4k（約 1,600 万画素）。最も横長の比率を 4k で出したところ 6240 x 2656 で返りました。 |
料金
$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 枚の画像を 2K か 4K で描きます。8 種のアスペクト比から選べます。当社のテストでは、ポスターや商品広告に引用どおりの文字を入れられました。プラットフォームはコンテンツフィルターを加えていないため、NSFW のプロンプトも拒否されません。画像の変更や組み合わせには、Seedream 4.5 画像編集 を使ってください。
必要なものからモデルを選ぶ
| 必要なもの | モデル |
|---|---|
| 言葉だけで新しい画像を作る | Seedream 4.5 テキストから画像（現在のページ） |
| 最大 14 枚の画像を編集、リスタイル、組み合わせ | Seedream 4.5 画像編集 |
主な機能と特長
引用どおりに出る文字
映画ポスターのタイトルと下の一行、刻印入りの香水瓶の名前は、当社のテストで正しく綴られました。ByteDance は 4.5 で文字の描画が改善したと説明しています。試したのは英語だけです。
2K と 4K を同じ料金で
2k は約 400 万画素、4k は約 1,600 万画素です。21:9 の 4k フレームは 6240 x 2656 で返り、どちらの解像度も $0.04 です。
8 種の比率
21:9 から 9:16 まで。2k では 16:9 は 2848 x 1600、3:2 は 2496 x 1664、1:1 は 2048 x 2048 です。
フィルターなし
プラットフォームが拒否したりフィルターをかけたりすることはありません。当社のテストでは、軽め・中程度・強め・最大は指定どおりに返り、かなり強めは抑えられて返りました。
ユースケース
ポスターと広告
タイトル、キャッチコピー、商品名を 1 枚に。文字はそれぞれ引用符で囲み、置く位置を書いてください。
シネマティックなフレーム
レンズ、色味、光源を指定した、横長の 21:9 や 16:9 のスチル。
グループの場面とポートレート
プールのそばの 4 人の友人、身を寄せて踊るカップル、古いジムのボクサー。それぞれ違う服装の複数の人物を 1 枚のフレームに収められます。
プロンプトガイドとプロのヒント
文字は引用し、位置を指定する
"NOIR VELOURS" を引用符で囲み、どこに置くか、どう見せるかを書きます。刻印は金色、と書くように。選んだサイズで読める長さに文字列を抑えてください。
光とレンズを指定する
左からの温かい金色の一筋の光、50mm、浅い被写界深度、フィルムグレイン。これらの細部は、形容詞よりも結果を左右します。
人物ごとに一文を与える
グループの場面では、4 人の友人のプロンプトのように、人物ごとに服装と動作を順に書いてください。
結果が毎回違うことを前提にする
シードがないため、同じプロンプトでも毎回違う画像が返ります。気に入った画像は、プロンプトと一緒に保存してください。
描きたいものを書く
ネガティブプロンプトはありません。画面に入れたいものを書き、除きたいものは書かないでください。
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"aspect_ratio": "1:1"
}
}'
# 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 リファレンスを参照してください。
