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

PixVerse 오디오·동영상 업로드

오디오 또는 동영상 파일을 업로드하여 후속 작업에 사용할 미디어 ID를 받습니다.

POST/openapi/v2/media/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

반환 결과 사용

file과 file_url 중 하나를 multipart 폼으로 보내세요. 동영상은 MP4, MOV, WebM, 오디오는 MP3, WAV, M4A, AAC를 지원합니다. 후속 API의 제한도 적용됩니다.

Resp.media_type으로 오디오와 동영상을 구분하고 Resp.media_id를 저장하세요. 오디오는 사용자 지정 음성 생성이나 립싱크에, 동영상은 참조 생성, 연장, 화면 확장, 립싱크에 사용할 수 있습니다.

PixVerse 오디오·동영상 업로드 — 공식 문서해당 공급자 프로토콜 정의를 확인하세요.