레이어 분리
목적
이 엔드포인트는 업로드된 이미지를 레이어로 분리합니다. 키워드를 기반으로 이미지의 특정 요소를 분리하여 개별 레이어로 추출합니다.
메서드 및 경로
- HTTP 메서드:
POST - 경로:
/public/v1/image-tune/split-layer
인증
이 엔드포인트는 Bearer Token 인증이 필요합니다. 자세한 내용은 인증 가이드를 참조하세요.
필수 헤더:
Authorization: Bearer {your_api_key}
요청 필드
폼 데이터 (multipart/form-data)
| 필드명 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
image | file | 필수 | 레이어로 분리할 원본 이미지 파일 (PNG, JPG, JPEG 등) |
keyword | string | 필수 | 분리할 요소를 지정하는 키워드 |
키워드 가이드라인
- 분리하고자 하는 이미지 요소를 설명하는 키워드를 입력하세요
- 예:
"arm","body","leg"
응답
JobIdResponse
| 필드명 | 타입 | 설명 |
|---|---|---|
job_id | UUID | 생성된 작업의 고유 식별자. 이 ID로 작업 상태를 조회합니다 |
오류 / 유효성 검사 규칙
| HTTP 상태 코드 | 오류 상황 | 설명 |
|---|---|---|
400 Bad Request | Invalid image file | Invalid image file |
401 Unauthorized | 인증 실패 | 유효하지 않은 API 키 또는 누락된 인증 헤더 |
404 Not Found | 사용자 없음 | API 키에 연결된 사용자를 찾을 수 없음 |
422 Unprocessable Entity | 유효성 검사 실패 | 필수 필드 누락 |
비동기 작업 동작
이 엔드포인트는 비동기로 처리됩니다. 요청 즉시 job_id를 반환하고, 실제 레이어 분리 처리는 백그라운드에서 진행됩니다.
작업 흐름:
- 이미지 파일과 키워드를 전송하면 즉시
job_id가 반환됩니다 - 백그라운드에서 레이어 분리 처리가 진행됩니다
GET /job/{job_id}엔드포인트로 폴링하여 상태를 확인합니다status가Succeed로 변경되면image_urls에서 분리된 레이어 이미지 URL을 확인합니다
폴링 간격: 1-2초 권장
요청 예시
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"
응답 예시
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}