はじめに
このエンドポイントの役割
写真を 1 枚受け取り、大きい順に最大 3 つの顔を復元して鮮明にしたコピーを返します。顔以外の部分は元のまま残り、解像度も変わりません。prompt はありません。
大事な入力
image_url は写真です。JPEG、PNG、WebP のアップロード、または公開 URL を指定します。`Face Enhancer には元画像で十分な大きさがあり、はっきり見える実在の人物の顔を選んでください。Face Enhancer の静止画の顔ディテール修復では、遠い顔や隠れた顔よりも、こうした細部を生かせます。Face Enhancer には元画像で十分な大きさがあり、はっきり見える実在の人物の顔を選んでください。Face Enhancer の静止画の顔ディテール修復では、遠い顔や隠れた顔よりも、こうした細部を生かせます。
返ってくるもの
1 リクエストにつき、送ったものと同じ解像度の画像が 1 枚返ります。Face Enhancer には元画像で十分な大きさがあり、はっきり見える実在の人物の顔を選んでください。Face Enhancer の静止画の顔ディテール修復では、遠い顔や隠れた顔よりも、こうした細部を生かせます。画素数を増やしたい場合は /models/image-upscaler-v1 を使ってください。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | 画像編集 |
| 顔の数 | 大きい順に最大 3 つ |
| それ以外 | 元のまま残ります |
| 操作項目 | prompt なし。ファイル形式のみ |
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 復元する写真です。JPEG、PNG、WebP のアップロード、またはファイルへの公開リンクを指定します。 1 文字以上 |
output_format | いいえ | jpeg（既定）、png、webp から選びます。png は非可逆圧縮をもう一度かけるのを避けられますが、ファイルは大きくなります。 |
料金
$0.012 / 枚
1 枚ごとに定額で課金します。出力形式によって料金は変わらず、失敗したリクエストには課金されません。
ユースケース
リサイズと再圧縮を重ねた写真
チャットアプリ、SNS のフィード、何度かの保存を経た写真は、まず顔の細部が失われます。一度通すと、目、眉、髭、肌の質感が戻ります。
プロフィールとチーム写真
少しぼけたポートレートを、プロフィール、チームページ、登壇者の経歴に載せる前にきれいにします。構図、光、背景は撮ったままです。
大きなレイアウトに使う前に
まず顔をきれいにし、バナーや印刷にする際に画素数も必要なら、Image Upscaler（/models/image-upscaler-v1）を使ってください。
プロンプトガイドと実践のヒント
顔を確認する
Face Enhancer には元画像で十分な大きさがあり、はっきり見える実在の人物の顔を選んでください。Face Enhancer の静止画の顔ディテール修復では、遠い顔や隠れた顔よりも、こうした細部を生かせます。大きく隠れた顔、とても小さな顔、極端にぼけた顔、イラストやアニメの顔は改善が小さくなります。
image_urlを送るimage_urlには写真を指定します。JPEG、PNG、WebP のアップロード、または公開 URL が使えます。jpeg ではなく png や webp がよい場合は、output_formatを追加してください。ポーリングして比べる
呼び出しは非同期です。タスクを作成し、完了までポーリングしてから、プラットフォームのストレージから画像を取得します。目と肌のあたりを原寸で元の写真と比べてください。
はじめに
Face Enhancer は 1 枚の写真に写った顔を復元し、鮮明にします。大きい順に最大 3 つの顔を見つけ、圧縮、リサイズ、ぼけなどで失われた細部を組み直します。目、眉、髭、肌の質感が対象です。顔以外の部分は元のまま残り、写真は送ったのと同じ解像度で返ります。prompt はなく、調整できるのはファイル形式だけです。
リクエスト
{
"image_url": "https://example.com/portrait.jpg",
"output_format": "jpeg"
}
必須なのは image_url だけです。output_format の既定は jpeg で、必要なら png か webp に変えてください。
変わるものと変わらないもの
変わるのは顔だけで、写真のそれ以外は変わりません。テストでは、バーにいる男性を写した 720×404 の JPEG のポートレートを、あえてサイズを半分に縮小してから拡大し直し、強く圧縮して劣化させました。約 9 秒の処理で 720×404 のまま返りました。目、眉、髭、肌の質感がはっきり鮮明になり、それでも同じ人物だと分かります。肌は実際の写真より少しなめらかに仕上がり、背後のボトル棚は元の圧縮ブロックを残しました。背景には手を加えないためです。
サイズも変わりません。Face Enhancer は送られた解像度のまま顔を復元します。画素数も増やしたい場合は Image Upscaler（/models/image-upscaler-v1）を使ってください。
顔は、実在する人物で、ある程度大きくはっきり写っているほど改善が大きくなります。イラストやアニメの顔、とても小さな顔、大きく隠れている顔や極端にぼけている顔は、改善が小さくなります。
タスクの流れ
呼び出しは非同期です。Face Enhancer の静止画の顔ディテール修復の Face Enhancer タスクを作成し、その ID で完了まで照会してから SpicyAPI ストレージの完成ファイルをダウンロードしてください。1 リクエストで画像が 1 枚返り、料金は 1 枚ごとの定額です。失敗したリクエストには課金されません。
ヒント
- 顔がある程度大きく、はっきり写っている写真から始めてください。幅が数十ピクセルしかない顔は、組み直す材料が少なくなります。
- 大きい順に最大 3 つの顔が復元されます。それ以外の顔はそのまま残ります。
- 結果をさらに編集したり圧縮したりする場合は
pngを使ってください。非可逆圧縮の重ね掛けを避けられますが、ファイルは大きくなります。形式によって料金は変わりません。 - 結果は、目と肌のあたりを原寸で元の写真と比べてください。テストの結果は実際の写真よりわずかになめらかだったため、元ファイルは残しておいてください。
- 顔をきれいにするだけでなく画素数も増やしたい場合は、写真に 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/face-enhancer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg"
}
}'
# 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 リファレンスを参照してください。
