はじめに
Relight は、写真の光を変えます。欲しい光を説明すると、その光で照らされた同じ人物と場面が返ります。夕方の窓からの光、ブルーアワー、頭上の硬いスポットライト、背後からの金色のリムなどです。フレームの他の部分は変わらないように設計されています。
主な機能とハイライト
一文で光を作る
光源、向き、色、硬さを書いてください。ツールは、dx8152 の Relight LoRA を付けた Qwen-Image-Edit-2509 を実行します。この LoRA は、光の前後を比べた組で学習されているため、絵を描き直すのではなく、光と影を動かします。
人物と構図はそのまま
すべてのテストで、顔、服、ポーズ、構図は変わりませんでした。変わったのは光、影、カラーグレードだけです。そのため、リライトした写真を元の写真と並べて、同じセットで使えます。
大きな雰囲気の変化
白いダンススタジオが、1 灯のスポットライトだけの暗い部屋になり、霧の夜明けの海岸が、リムライトの効いた金色の夕焼けになりました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | リライトする写真です。公開 HTTPS リンクまたはアップロード（JPEG、PNG、WebP、10 MB まで）。 1 文字以上 |
prompt | はい | 新しい光です。「Relight the image with ...」で始め、光源、向き、色、硬さを書きます。 1 文字以上 · 1000 文字以内 |
aspect_ratio | いいえ | 任意です。空のままにすると、写真の形を約 100 万画素で保ちます。 |
output_format | いいえ | 既定は JPEG です。必要なら PNG か WebP を選べます。 |
seed | いいえ | 同じ写真で 2 回の結果を比べたいときに、同じ数字をもう一度使います。0〜2147483647 の任意の整数です。 |
料金
$0.03 / 枚
出力画像 1 枚ごとに、定額料金で課金されます。比率と出力形式では料金は変わらず、失敗したリクエストには課金されません。
ユースケース
フラットな写真の補正
ソフトボックスの光や曇りの日で、のっぺりと見えてしまったポートレートや商品写真に、向きと雰囲気を加えます。
時間帯
場所に戻らなくても、場所の写真をブルーアワーやゴールデンアワーに変えられます。例えば、トラックのライトが点いたブルーアワーの塩原です。
セットの統一感
別々の光で撮った写真を、キャンペーン、ルックブック、カルーセルのために 1 つの一貫した雰囲気にそろえます。
プロンプトガイドと実践のヒント
「Relight the image with」で始める
そのあとに光源と、光がどこから来るかを書きます。具体的な方が、曖昧な言葉より効きます。「dramatic」より「a single hard spotlight from directly above」の方が良い結果になります。
古い影は先に取り除く
写真にすでに硬い影がある場合は、先に Shadow Remover を実行し、きれいになった結果をリライトしてください。
動機のある光には小道具が出ることがある
窓の光を求めると、場面に窓が追加されることがあります。新しい物を入れたくない場合は、光だけを説明してください（「warm light from the left」など）。
一回に一つだけ変える
一度に 1 つの照明の組み方だけを求めてください。結果が近いところまで来たら、seed を保ったまま、プロンプトの色か向きだけを調整すると、2 つの版を並べて比べられます。
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": "spicyapi/relight-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 リファレンスを参照してください。
