스프라이트 생성 V1

목적

업로드한 이미지를 기반으로 스프라이트 애니메이션을 생성합니다. 픽셀 아트 스타일 또는 일반 스타일로 스프라이트 시트를 만들 수 있습니다.

메서드 및 경로

POST /public/v1/sprite/make-sprite/v1

인증

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

필수 헤더:

Authorization: Bearer {your_api_key}

요청 필드

필드명	타입	필수	설명
image	file	예	스프라이트 생성의 기반이 될 이미지 파일
text	string	예	스프라이트 생성을 위한 텍스트 프롬프트
frame	integer	예	생성할 프레임 수. 반드시 25, 36, 49, 64, 81, 100, 121, 144, 169 중 하나여야 합니다
is_pixel	boolean	예	이미지가 픽셀 아트 스타일인지. true 또는 false

응답

성공 응답 (200 OK):

{
  "job_id": "uuid-string"
}

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

오류 / 유효성 검사 규칙

상황	HTTP 상태	에러 메시지
Invalid image file	400	"Invalid image file"
frame 값이 허용된 값이 아님	400	"frame should be one of 25, 36, 49, 64, 81, 100, 121, 144, 169"
인증 실패	401	유효하지 않은 API 키

허용된 프레임 값:

• 25, 36, 49, 64, 81, 100, 121, 144, 169

비동기 작업 동작

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

폴링 방법:

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

상태 흐름: Pending → Succeed 또는 Failed

요청 예시

cURL (픽셀 아트 스타일):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/character.png" \
-F "text=walking animation" \
-F "frame=64" \
-F "is_pixel=true"

cURL (일반 스타일):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/character.png" \
-F "text=running animation cycle" \
-F "frame=36" \
-F "is_pixel=false"