メインコンテンツへスキップ

レイヤー分離

Purpose​

このエンドポイントはアップロードされた画像をレイヤーに分離します。キーワードを基に画像の特定要素を分離し、個別レイヤーとして抽出します。

Method and Path​

  • HTTP Method: POST
  • Path: /public/v1/image-tune/split-layer

Authentication​

このエンドポイントはBearer Token認証が必要です。詳細については認証ガイドを参照してください。

必須ヘッダー:

Authorization: Bearer {your_api_key}

Request Fields​

Form Data (multipart/form-data)​

フィールド名タイプ必須説明
imagefile必須レイヤーに分離する元画像ファイル (PNG, JPG, JPEG等)
keywordstring必須分離する要素を指定するキーワード

Keyword Guidelines​

  • 分離したい画像要素を説明するキーワードを入力してください
  • 例: "arm", "body", "leg"

Response​

JobIdResponse​

フィールド名タイプ説明
job_idUUID作成されたジョブの一意識別子。このIDでジョブ状態を照会します

Error / Validation Rules​

HTTP状態コードエラー状況説明
400 Bad RequestInvalid image fileInvalid image file
401 Unauthorized認証失敗無効なAPIキーまたは欠落した認証ヘッダー
404 Not FoundユーザーなしAPIキーに関連付けられたユーザーが見つからない
422 Unprocessable Entity検証失敗必須フィールド欠落

Async Job Behavior​

このエンドポイントは非同期で処理されます。リクエスト即座にjob_idを返し、実際のレイヤー分離処理はバックグラウンドで進行します。

ジョブフロー:

  1. 画像ファイルとキーワードを送信すると即座にjob_idが返されます
  2. バックグラウンドでレイヤー分離処理が進行します
  3. GET /job/{job_id}エンドポイントでポーリングして状態を確認します
  4. statusがSucceedに変更されるとimage_urlsで分離されたレイヤー画像URLを確認します

ポーリング間隔: 1-2秒推奨

Example Request​

cURL​

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/split-layer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "keyword=character"

Response Example​

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