다시 그리기 V1

목적

이 엔드포인트는 이미지의 특정 부분을 AI로 자연스럽게 변경합니다. 업로드된 이미지와 프롬프트를 기반으로 지정된 영역을 수정하여 원하는 결과물을 생성합니다.

메서드 및 경로

• HTTP 메서드: POST
• 경로: /public/v1/image-tune/inpaint/v1

인증

이 엔드포인트는 Bearer Token 인증이 필요합니다. 자세한 내용은 인증 가이드를 참조하세요.

필수 헤더:

Authorization: Bearer {your_api_key}

요청 필드

폼 데이터 (multipart/form-data)

필드명	타입	필수 여부	설명
image	file	필수	인페인트할 원본 이미지 파일 (PNG, JPG, JPEG 등)
prompt	string	필수	인페인트할 내용을 설명하는 텍스트 프롬프트

프롬프트 가이드라인

• 인페인트할 영역과 원하는 결과를 구체적으로 설명하세요
• 예: "배경을 푸른 하늘으로 변경", "오른쪽 상단의 물체를 제거"

응답

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를 반환하고, 실제 인페인트 처리는 백그라운드에서 진행됩니다.

작업 흐름:

1. 이미지 파일과 프롬프트를 전송하면 즉시 job_id가 반환됩니다
2. 백그라운드에서 인페인트 처리가 진행됩니다
3. GET /job/{job_id} 엔드포인트로 폴링하여 상태를 확인합니다
4. status가 Succeed로 변경되면 image_urls에서 결과 이미지 URL을 확인합니다

폴링 간격: 1-2초 권장

요청 예시

cURL

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/inpaint/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=배경을 푸른 하늘으로 변경"

응답 예시

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