はじめに
このエンドポイントの機能
写真 1 枚の目に見える損傷(傷、ほこりの斑点、フィルムの粒状感、ノイズ、ぼやけ)を修復し、PNG を返します。プロンプトは不要です。
主な入力
image_url が唯一のフィールドです。JPEG、PNG、WebP をアップロードするか、ファイルへの直接リンクを指定します。
返される結果
元の縦横比で約 1 メガピクセルの PNG を 1 枚返します。白黒やセピア写真の色調は維持されます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | 画像編集 |
| 補正対象 | 傷、ほこりの斑点、粒状感、ノイズ、ぼやけ |
| 色 | 送信時の色を維持、着色なし |
| 設定 | 写真以外の設定なし |
主な機能とハイライト
傷のあるセピアの肖像を 1 回できれいに
テストのスキャンには 4 本の傷、7 個のほこりの斑点、粒状感、ぼやけがありました。結果ではすべて除去され、構図はそのままに男性の目、ひげ、ジャケットの質感が鮮明になりました。
顔を置き換えずに修復
同じ範囲を拡大すると、髪のほこりと肌の粒状感が消え、表情や顔立ちはスキャンと一致しています。顔は修復で特に大切な部分なので、まず確認してください。
Photo Colorizer と組み合わせる
修復では元の色調を保ちます。白黒やセピアの写真は修復した PNG を Photo Colorizer に送ります。傷のある写真より、きれいな写真を着色するほうが色むらを抑えられます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 修復するスキャン写真。JPEG、PNG、WebP のアップロード、またはファイルへの直接リンクを指定します。 1 文字以上 |
料金
$0.048 / 枚
サイズにかかわらず、修復する写真 1 枚ごとの定額です。失敗したリクエストには課金されません。
ユースケース
家族のアルバムや保管していた写真に
祖父母の肖像、結婚写真、休暇のスナップのスキャンをきれいにして、スライドショー、写真集、家族のグループチャットに使えます。
アーカイブや地域史の活動に
傷やほこりが点在する収蔵写真のスキャンを修復し、ボランティアがレタッチよりも説明文の作成に時間を使えるようにします。
追悼や記念日の制作物に
大切な 1 枚を額装、式次第、追悼動画に使えるように整えます。レタッチの依頼は不要です。
プロンプトガイドと実践のヒント
プリントをスキャンまたは撮影します
プリントを平らにし、反射を避け、写真全体を画面に収めます。見える損傷を修復するため、顔にかかった反射は傷よりも補正が難しくなります。
image_urlを送信しますスキャンを JPEG、PNG、WebP でアップロードするか、ファイルへの直接リンクを渡します。リクエストはこれだけです。
顔を確認してから着色します
目や口を原本と等倍で比較します。白黒写真の場合は、修復した PNG を /models/photo-colorizer-v1 の Photo Colorizer に送ります。
はじめに
Old Photo Restorer はスキャンしたプリントを扱う、入力が 1 フィールドのエンドポイントです。image_url で写真を送ると、傷、ほこり、粒状感、ぼやけを除去して返します。着色はせず、プロンプトも不要です。
リクエスト
{
"image_url": "https://example.com/scan.jpg"
}
テストで確認した結果
屋上で撮影された肖像の 640×960 セピアスキャンに、長い傷 4 本、ほこり 7 個、粒状感、ぼやけ、強い JPEG 圧縮を加えました。約 17 秒後、傷とほこりがすべて消え、顔、ひげ、ジャケットが明らかに鮮明な 832×1248 の PNG が返りました。同じ男性だとはっきり分かる結果でした。薄い雲は均一な淡い空に平滑化され、セピアの色味は明るくなりました。
損傷のない 2048×1152 のカラー写真は 1360×768 になり、色は保たれ、肌が少し滑らかになりました。入力にかかわらず、出力は約 1 メガピクセルになることが分かります。
タスクの流れ
写真の修復は非同期で実行されます。タスクを作成し、完了までポーリングして、SpicyAPI ストレージから PNG をダウンロードします。1 リクエストにつき写真 1 枚を定額で処理し、失敗したリクエストは無料です。
ヒント
- 十分な解像度でスキャンし、送信前にアルバムの台紙や額縁を切り取ってください。
- 反射や映り込みは傷より除去が難しいため、プリントはフラッシュなしで撮影してください。
- 着色するには、修復した PNG を Photo Colorizer (
/models/photo-colorizer-v1) に送ります。 - 印刷用に大きなファイルが必要な場合は、修復後に Image Upscaler (
/models/image-upscaler-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-restorer-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 リファレンスを参照してください。




