背景削除
Purpose
アップロードされた画像から背景を削除し、透過PNGを返します。ウェブアプリの「背景削除」ページと同じ機能です。
クレジット消費: 1
Method and Path
POST /public/v1/image-tune/remove-background
Authentication
認証ページを参照してください。Bearerトークンが必要です。
必須ヘッダー:
Authorization: Bearer {your_api_key}
Request Fields
リクエストは multipart/form-data で送信します。
| フィールド名 | タイプ | 必須 | 説明 |
|---|---|---|---|
| image | file | はい | 背景を削除する画像 (PNG または JPEG) |
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を返し、背景削除はバックグラウンドで進行します。
ポーリング方法:
- レスポンスで受け取った
job_idを保存します GET /public/v1/job/{job_id}をポーリングして状態を確認します- 状態が
Succeedになるとimage_urlsで結果画像を確認します
状態フロー: Pending → Succeed または Failed
Example Request
cURL:
curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/remove-background" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/character.png"