AGTCloud API Docs
가이드API 레퍼런스통합 및 리소스업데이트 및 도움말
비디오 생성PixVerse

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에도 사용할 수 있습니다. 선택한 템플릿에서 요구하는 이미지 수와 순서를 따르세요.

PixVerse 이미지 업로드 — 공식 문서해당 공급자 프로토콜 정의를 확인하세요.