はじめに
このエンドポイントの役割
画像を 1 枚受け取り、選んだサイズ段階でより大きく鮮明なコピーを返します。構図、色、被写体は送ったままで、prompt はありません。
大事な入力
image_url は拡大する画像です。resolution でサイズ段階を選びます。2k（約 400 万画素）、4k（約 1,700 万画素、既定）、8k（約 6,700 万画素）です。縦横比は保たれ、元画像より小さい段階では縮小されます。output_format はファイル形式で、jpeg（既定）、png、webp から選びます。
返ってくるもの
1 リクエストにつき画像 1 枚が、タスク完了後にプラットフォームのストレージから配信されます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | アップスケール |
| サイズ段階 | 2K（約 4 MP）、4K（約 17 MP）、8K（約 67 MP） |
| 縦横比 | 元画像のまま |
| 操作項目 | prompt なし。サイズ段階とファイル形式のみ |
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 画像ファイルへの直接リンク（JPEG、PNG、WebP）です。構図と縦横比はそのまま引き継がれます。 1 文字以上 |
resolution | いいえ | 2k（約 4 MP）、4k（約 17 MP、既定）、8k（約 67 MP）で、縦横比は保たれます。元画像の画素数より上の段階を選んでください。 |
output_format | いいえ | 既定の jpeg はファイルが扱いやすく、テストでは最大の段階でも約 8 MB でした。png は可逆ですが数倍大きく、webp はその中間です。 |
料金
$0.012 / 枚
出力画像 1 枚ごとに課金します。サイズ段階とファイル形式で料金は変わりません。
ユースケース
AI 生成画像を印刷サイズに
多くの画像モデルが返すのは 100 万から 200 万画素ほどです。4k や 8k にすれば、気に入った 1 枚を作り直さずにポスターや印刷のサイズまで持っていけます。
商品写真とカタログ
ズーム表示や高精細な商品ページ向けに、ライティングやラベルを撮影時のまま商品写真を拡大できます。
小さな画像を新しいレイアウトに
サムネイル、Web 用サイズの写真、昔の素材を、ヒーローバナーやスライドが今求めるサイズまで引き上げます。
プロンプトガイドと実践のヒント
元画像のサイズを確認する
今の画素数より上の段階を選んでください。小さい段階を選ぶと縮小されます。後の工程で重いファイルを扱わずに済むよう、アップスケールは編集をすべて終えてから行います。
image_urlと resolution を送るimage_urlが対象の画像、resolution で 2k、4k（既定）、8k を選びます。jpeg 以外が必要なときだけoutput_formatで png か webp を指定します。ポーリングしてダウンロードする
呼び出しは非同期です。タスクを作成し、完了までポーリングしてから、プラットフォームのストレージからファイルを取得します。8k の jpeg は約 8 MB あるので、ダウンロード時間を見込んでください。
はじめに
Image Upscaler は仕上がった画像 1 枚を 2k、4k、8k のサイズ段階まで拡大し、同時に鮮明にします。絵そのものは変わらず、構図、色、被写体は送ったとおりに残ります。prompt はなく、調整するのはサイズとファイル形式だけです。
リクエスト
{
"image_url": "https://example.com/product.png",
"resolution": "4k",
"output_format": "jpeg"
}
必須は image_url だけです。resolution の既定は 4k、output_format の既定は jpeg です。
サイズ段階の挙動
段階は固定のキャンバスではなく画素数の目安で、縦横比は常に保たれます。1024×1536 の写真は 2k で 1672×2508、4k で 3344×5017、8k で 6689×10033 になり、どれも約 45 秒でした。すでに段階より大きい画像は縮小されます。3344×5017 の画像を 2k で送ると 1672×2509 で返りました。
タスクの流れ
呼び出しは非同期です。タスクを作成し、終了状態になるまでポーリングしてから、プラットフォームのストレージから画像をダウンロードします。1 リクエストで 1 枚が返ります。
ヒント
- 元画像の画素数より上の段階を選んでください。
- 後の工程で大きなファイルを扱わずに済むよう、アップスケールは編集をすべて終えてから行います。
- できるだけきれいな元画像から始めてください。圧縮ノイズやぶれも一緒に拡大されます。
- 可逆出力が必要でなければ
jpegを使ってください。8k の jpeg は約 8 MB でしたが、pngはその数倍になります。
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/image-upscaler-v1/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "4k"
}
}'
# 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 リファレンスを参照してください。
