はじめに
このエンドポイントの機能
白黒、セピア、色あせた写真 1 枚を着色し、JPEG を返します。色は画像から推定され、プロンプトや配色の設定はありません。
主な入力
入力は image_url の 1 項目だけです。JPEG、PNG、WebP の写真をアップロードするか、直接リンクを指定します。
返される結果
入力の縦横の約 2~3 倍の JPEG を 1 枚返します。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | 画像編集 |
| 設定 | 写真以外の設定なし |
| 適した入力 | きれいなスキャン。損傷は先に修復 |
主な機能とハイライト
白黒の屋上ポートレートが夕景に
白黒写真から、温かみのある肌、茶色のジャケット、青からオレンジへ変わる夕空、街中の明るい窓を描きました。元のファイルにはなかった色で、形と明暗から推定されています。
傷のあるセピア写真からきれいなカラー写真へ
左は損傷したスキャン、中央は Old Photo Restorer で修復した同じスキャン、右はその結果を Photo Colorizer で着色したものです。きれいにした画像の着色では、肌の色むらと空のざらつきを抑えられました。
色は画像から推定されます
白黒写真に色情報はないため、すべての色はモデルによる場面の解釈です。自然な見た目の解釈として扱い、原本も一緒に残してください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 着色する白黒、セピア、色あせた写真。JPEG、PNG、WebP のアップロードまたは直接リンクを指定します。 1 文字以上 |
料金
$0.06 / 枚
着色する写真 1 枚ごとの定額で、出力の拡大に追加料金はかかりません。失敗したリクエストには課金されません。
ユースケース
家族の歴史を身近に
親や祖父母の肖像をカラーにして親族へ。アルバムや追悼ページで原本の横に並べられます。
歴史・ドキュメンタリーのコンテンツに
アーカイブ写真を動画エッセイ、博物館の解説、SNS 投稿向けに着色し、比較用の原本も併せて残します。
写真修復のワークフローに
Old Photo Restorer の後に続けて使います。まず修復、次に着色し、印刷用なら必要に応じて拡大します。
プロンプトガイドと実践のヒント
きれいなスキャンから始めます
傷やほこりのない写真で最もよく機能します。損傷がある場合は先に Old Photo Restorer (/models/photo-restorer-v1) を使い、その出力を着色します。
image_urlを送信します白黒やセピアの写真を JPEG、PNG、WebP でアップロードするか、ファイルに直接リンクします。
推定された色を確認します
髪、目、服の色は復元ではなく推定です。本来の色が分かっている場合は、結果を手作業で調整するための出発点として使ってください。
はじめに
Photo Colorizer は白黒、セピア、色あせた写真に自然な色を付けます。入力は image_url のみで、肌、髪、服、空、建物の色を画像の形や明暗から推定します。
リクエスト
{
"image_url": "https://example.com/grandparents-1958.jpg"
}
テストで確認した結果
屋上の男性を写した 768×1152 の白黒肖像は、約 17 秒後に 1664×2496 の JPEG になりました。温かみのある肌、茶色のジャケット、白い T シャツ、青い街並みの背後のオレンジ色の夕空が加わりました。バーの 2 人を写した 1024×576 の写真は 2848×1600 になり、緑と赤のワインボトルとクリーム色のセーターが描かれました。女性の髪は茶色になりましたが、白黒に変換する前のカラー写真では赤毛でした。このような推定を確認する必要があります。
傷のあるセピアスキャンを Old Photo Restorer で修復してから着色するテストも行いました。修復後に着色した肖像は、肌が均一で空もきれいでした。
タスクの流れ
呼び出しは非同期です。タスクを作成し、完了までポーリングして、SpicyAPI ストレージから JPEG をダウンロードします。料金は写真 1 枚ごとの定額で、失敗した処理には課金されません。
ヒント
- 損傷は着色の妨げになるため、先に Old Photo Restorer (
/models/photo-restorer-v1) で傷やほこりを修復します。 - 制服、車、ドレスなど確かな色が分かる場合は、後から手作業で修正します。
- 白黒の原本を残し、歴史的な画像を公開する際は着色版であることを明記します。
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/photo-colorizer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# 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 リファレンスを参照してください。




