다시 그리기 V2

목적

프롬프트를 기반으로 이미지의 일부를 AI로 다시 그립니다. 이미지를 업로드하고 어떤 부분을 다시 그릴지 설명하세요. 웹 앱 "이미지 다시 그리기" 페이지의 V2 탭(기본 탭)과 동일한 기능입니다.

크레딧 비용: 3

메서드 및 경로

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

인증

인증 페이지를 참고하세요. Bearer 토큰이 필요합니다.

필수 헤더:

Authorization: Bearer {your_api_key}

요청 필드

요청은 multipart/form-data로 전송합니다.

필드명	타입	필수	설명
image	file	예	다시 그릴 원본 이미지 파일 (PNG 또는 JPEG)
prompt	string	예	어떤 부분을 다시 그릴까요? 프롬프트는 그대로 전달됩니다

프롬프트 가이드라인

• 다시 그릴 영역과 원하는 결과를 구체적으로 설명하세요
• 예: "Change background to blue sky", "Remove object in upper right corner"

응답

성공 응답 (200 OK):

{
  "job_id": "uuid-string"
}

필드	타입	설명
job_id	string	생성된 작업의 고유 식별자. 작업 상태 조회로 결과를 조회합니다

오류 / 유효성 검사 규칙

상황	HTTP 상태	에러 메시지
이미지가 유효한 PNG 또는 JPEG 파일이 아님	400	"Invalid image file"
유효하지 않은 API 키	401	"Invalid API key"
필드 누락	422	Validation error

비동기 작업 동작

이 엔드포인트는 비동기 작업을 생성합니다. 요청 즉시 job_id를 반환하고, 다시 그리기는 백그라운드에서 진행됩니다.

폴링 방법:

1. 응답으로 받은 job_id를 저장합니다
2. GET /public/v1/job/{job_id}를 폴링하여 상태를 확인합니다
3. 상태가 Succeed가 되면 image_urls에서 결과 이미지를 확인합니다

상태 흐름: Pending → Succeed 또는 Failed

요청 예시

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"
}