描き直し V2

Purpose

プロンプトに基づいて画像の一部をAIで描き直します。画像をアップロードし、どの部分を描き直すかを説明してください。ウェブアプリの「画像を描き直す」ページの V2 タブ（デフォルトタブ）と同じ機能です。

クレジット消費: 3

Method and Path

POST /public/v1/image-tune/inpaint/v2

Authentication

認証ページを参照してください。Bearerトークンが必要です。

必須ヘッダー:

Authorization: Bearer {your_api_key}

Request Fields

リクエストは multipart/form-data で送信します。

フィールド名	タイプ	必須	説明
image	file	はい	描き直す元画像ファイル (PNG または JPEG)
prompt	string	はい	どの部分を描き直しますか？ プロンプトはそのまま送信されます

プロンプトのガイドライン

• 描き直す領域と望む結果を具体的に説明してください
• 例: "Change background to blue sky", "Remove object in upper right corner"

Response

成功レスポンス (200 OK):

{
  "job_id": "uuid-string"
}

フィールド	タイプ	説明
job_id	string	作成されたジョブの一意識別子。Get Job Statusで結果を照会します

Error / Validation Rules

状況	HTTP状態	エラーメッセージ
画像が有効な PNG または JPEG ファイルでない	400	"Invalid image file"
無効なAPIキー	401	"Invalid API key"
フィールド欠落	422	Validation error

Async Job Behavior

このエンドポイントは非同期ジョブを作成します。リクエスト即座にjob_idを返し、描き直しはバックグラウンドで進行します。

ポーリング方法:

1. レスポンスで受け取ったjob_idを保存します
2. GET /public/v1/job/{job_id}をポーリングして状態を確認します
3. 状態がSucceedになるとimage_urlsで結果画像を確認します

状態フロー: Pending → Succeed または Failed

Example Request

cURL:

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/inpaint/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=Change background to blue sky"

レスポンス例:

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}