高画質化
Purpose
このエンドポイントはアップロードされた画像の画質を高解像度で向上させます。元画像を1K、2K、または4K解像度に拡張し、より鮮明で高品質の画像を生成します。ウェブアプリの「高画質化」ページと同じ機能で、ウェブアプリではデフォルトで 2K が選択されています。
クレジット消費: 5 (1K)、7 (2K)、10 (4K)
Method and Path
- HTTP Method:
POST - Path:
/public/v1/image-tune/upscale
Authentication
このエンドポイントはBearer Token認証が必要です。詳細については認証ガイドを参照してください。
必須ヘッダー:
Authorization: Bearer {your_api_key}
Request Fields
Form Data (multipart/form-data)
| フィールド名 | タイプ | 必須 | 説明 |
|---|---|---|---|
image | file | 必須 | 高画質化する元画像ファイル (PNG または JPEG) |
scale | string | 必須 | 目標解像度。可能な値: "1K", "2K", "4K" |
Scale Values
"1K": 1024px解像度に高画質化"2K": 2048px解像度に高画質化"4K": 4096px解像度に高画質化
Response
JobIdResponse
| フィールド名 | タイプ | 説明 |
|---|---|---|
job_id | UUID | 作成されたジョブの一意識別子。このIDでジョブ状態を照会します |
Error / Validation Rules
| HTTP状態コード | エラー状況 | 説明 |
|---|---|---|
400 Bad Request | Invalid image file | Invalid image file |
401 Unauthorized | 認証失敗 | 無効なAPIキーまたは欠落した認証ヘッダー |
404 Not Found | ユーザーなし | APIキーに関連付けられたユーザーが見つからない |
422 Unprocessable Entity | 検証失敗 | 必須フィールド欠落または無効なscale値 |
Async Job Behavior
このエンドポイントは非同期で処理されます。リクエスト即座にjob_idを返し、実際の高画質化処理はバックグラウンドで進行します。
ジョブフロー:
- 画像ファイルとscaleパラメータを送信すると即座に
job_idが返されます - バックグラウンドで高画質化処理が進行します
GET /job/{job_id}エンドポイントでポーリングして状態を確認しますstatusがSucceedに変更されるとimage_urlsで結果画像URLを確認します
ポーリング間隔: 1-2秒推奨
Example Request
cURL
curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/upscale" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "scale=2K"
Response Example
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}