PixVerse 이미지 업로드
이미지 파일이나 URL을 업로드하여 영상 생성과 이미지 템플릿에서 공통으로 사용할 이미지 ID를 받습니다.
POST
/openapi/v2/image/upload인증
bearerAuth 인증Bearer <token>
플랫폼 API Key를 Authorization: Bearer your-api-key 형식으로 사용합니다.
전달 위치: header
Header 매개변수
Ai-trace-id?string
선택적 고유 추적 값입니다. 생략하면 플랫폼에서 생성하며 멱등성 키가 아닙니다.
Accept-Language?string
리소스 API의 선택적 언어 설정입니다.
요청 본문
multipart/form-data
응답 본문
application/json
application/json
application/json
application/json
반환 결과 사용
image와 image_url 중 하나만 사용하며 모두 multipart 폼을 사용합니다. boundary는 클라이언트가 생성하도록 하고 직접 조합하지 마세요. 성공 후 Resp.img_id를 이미지로 동영상 생성, 시작·종료 프레임 또는 참조 생성에 사용하세요.
같은 Resp.img_id를 이미지 템플릿 생성의 img_ids에도 사용할 수 있습니다. 선택한 템플릿에서 요구하는 이미지 수와 순서를 따르세요.