はじめに
Gigapixel で拡大できます
Gigapixel では精密な拡大と生成による再構成を選べます。プリセットを省略すると standard_v2 を使用します。
リクエストを設定します
image_url を送り、resolution に 2k ・ 4k ・ 8k を指定します。標準は 4k、出力形式の標準は JPEG です。
出力時の制約があります
透過素材には preset: transparent と output_format: png を組み合わせ、出力の輪郭を確認してください。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| 入力形式 | JPEG ・ PNG ・ WebP |
| 標準プリセット |
|
| 標準出力区分 | 4K |
| 出力形式 | JPEG または PNG、透過は常に PNG |
| 課金単位 | プリセットと出力区分に応じた画像単位 |
主な機能とハイライト
画素数を増やすだけでは目元は鮮明になりません
左から入力、Standard V2、Wonder 4 です。Standard はぼけもそのまま拡大します。今回の Wonder 4 は顔全体の印象を保ちながら、目元などをより明瞭に再構成しています。
鮮明さと一緒に顔立ちも確認してください
Redefine では男性が若く見え、顔立ちも変わっています。Recover 3 と Standard MAX も細部を再構成し、Detail は今回の強いぼけを残しています。いずれも 1 枚の画像で確認した結果です。
バラを拡大しても背景の透明度を保持できます
黄橙色のバラを切り抜いた 400×301 の PNG が、アルファを保持した 2360×1776 の PNG になりました。花びらの先端はピンク色で水滴が付き、短い緑の茎と葉も見えます。比較図の暗い背景は表示用です。作例ファイル自体は透明のままです。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | Gigapixel で拡大する 1 枚の JPEG ・ PNG ・ WebP を指定します。 1 文字以上 |
preset | いいえ | 精密タイプ 5 種、生成タイプ 6 種、透過 PNG 用の |
resolution | いいえ |
|
output_format | いいえ | 標準は |
料金
Gigapixel は処理した画像ごとに、preset と resolution に応じて課金します。output_format を変えても料金は変わりません。
| 解像度 | スタイルプリセット: cgi | スタイルプリセット: detail | スタイルプリセット: high_fidelity_v3 | スタイルプリセット: low_resolution_v2 | スタイルプリセット: standard_v2 | スタイルプリセット: text_refine | スタイルプリセット: transparent | スタイルプリセット: wonder_3_5 | スタイルプリセット: wonder_4 | スタイルプリセット: recover_3 | スタイルプリセット: redefine | スタイルプリセット: standard_max |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.24 / 枚 | $0.24 / 枚 | $0.24 / 枚 |
| $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.12 / 枚 | $0.36 / 枚 | $0.36 / 枚 | $0.60 / 枚 | $0.60 / 枚 | $0.60 / 枚 |
| $0.36 / 枚 | $0.36 / 枚 | $0.36 / 枚 | $0.36 / 枚 | $0.36 / 枚 | $0.36 / 枚 | $0.36 / 枚 | $1.08 / 枚 | $1.08 / 枚 | $2.04 / 枚 | $2.04 / 枚 | $2.04 / 枚 |
ユースケース
AI 画像の印刷準備
必要な出力区分を選び、印刷前に顔や細かな模様を確認できます。
ロゴや切り抜き素材の拡大
文字や図形には text_refine、背景を透明のまま使う PNG には transparent を選べます。
プロンプトガイドと実践のヒント
元画像を指定します
JPEG ・ PNG ・ WebP の写真やイラストを
image_urlに指定します。再構成の方針を決めます
元の内容を保つ拡大には
standard_v2、失われた細部の再構成にはwonder_4などを選びます。出力を設定します
resolutionと形式を指定します。transparentではoutput_format: pngを明示します。
Gigapixel で拡大できます
Gigapixel のプリセットを写真や図形に適用し、選んだ画素区分へ拡大します。透過素材は PNG で返します。
リクエストを設定します
{
"image_url": "https://example.com/blurred-portrait.jpg",
"preset": "standard_v2",
"resolution": "2k",
"output_format": "jpeg"
}
プリセットを選べます
preset | 適した用途 |
|---|---|
standard_v2 | 一般的な写真向けの標準精密モデルです |
high_fidelity_v3 | すでに鮮明な高解像度素材向けです |
low_resolution_v2 | 小さい画像や圧縮の強い画像向けです |
cgi | イラストやレンダリング画像向けです |
text_refine | 文字・ロゴ・図形向けです |
wonder_4 | 新しい汎用生成拡大モデルです |
wonder_3_5 | Wonder 3.5 で細部を再構成します |
recover_3 | 大きく劣化した写真向けです |
standard_max | 細部を生成して再構成します |
redefine | 新しい細部を加え、顔立ちを変える場合があります |
detail | AI で作った顔の肌をより写実的にします |
transparent | アルファを保持して PNG を拡大します |
実測結果を確認できます
左から入力、Standard V2、Wonder 4 です。Standard はぼけもそのまま拡大します。今回の Wonder 4 は顔全体の印象を保ちながら、目元などをより明瞭に再構成しています。
Redefine では男性が若く見え、顔立ちも変わっています。Recover 3 と Standard MAX も細部を再構成し、Detail は今回の強いぼけを残しています。いずれも 1 枚の画像で確認した結果です。
黄橙色のバラを切り抜いた 400×301 の PNG が、アルファを保持した 2360×1776 の PNG になりました。花びらの先端はピンク色で水滴が付き、短い緑の茎と葉も見えます。比較図の暗い背景は表示用です。作例ファイル自体は透明のままです。
出力時の制約があります
1 回のリクエストで 1 枚の画像に 1 種類のプリセットを適用します。生成タイプは顔立ちや細部を変える場合があるため、身分証や証拠資料の復元には適していません。8K はファイルが大きくなる場合があります。transparent と JPEG の組み合わせは拒否されます。
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": "topaz/gigapixel/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "standard_v2",
"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 リファレンスを参照してください。
