이펙트 생성 V2

목적

이펙트 스타일의 결과를 비동기적으로 생성합니다. 이펙트 생성을 안내하기 위해 텍스트 설명을 제공하고, 선택적으로 이미지를 업로드할 수 있습니다.

메서드 및 경로

POST /public/v1/generate/effect/v2

인증

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

필수 헤더:

Authorization: Bearer {your_api_key}

요청 필드

필드명	타입	필수	설명
description	string	예	이펙트 설명
quality	string	예	품질: standard, pro
frame	number	예	프레임 수: 4, 9, 16
image	file	아니오	선택적 참조 이미지

응답

성공 응답 (200 OK):

{
  "job_id": "uuid-string"
}

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

오류 / 유효성 검사 규칙

상황	HTTP 상태	에러 메시지
Invalid image file	400	"Invalid image file"
인증 실패	401	유효하지 않은 API 키

비동기 작업 동작

이 엔드포인트는 비동기 작업을 생성합니다. 요청 즉시 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/generate/effect/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "description=apply a glowing fantasy aura" \
-F "quality=standard" \
-F "frame=4"

cURL (이미지 포함):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/effect/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "description=apply a neon cyberpunk effect" \
-F "quality=pro" \
-F "frame=16" \
-F "image=@/path/to/input.png"