PixVerse V6.0 / C1 · API 레퍼런스
텍스트, 이미지, 시작 및 끝 프레임 또는 참조에서 PixVerse 비디오를 생성합니다.
모델 ID로 pixverse-video-v6.0 또는 pixverse-video-c1를 사용합니다. Authorization: Bearer 헤더에 APIMaster API 키를 사용하여 JSON를 제출합니다.
| 작업 | 엔드포인트 |
|---|---|
| Text-to-video | POST /v1/wand/pixverse/text-to-video |
| Image-to-video | POST /v1/wand/pixverse/image-to-video |
| 프레임 시작/종료 | POST /v1/wand/pixverse/start-end-to-video |
| Reference-to-video | POST /v1/wand/pixverse/reference-to-video |
| 작업 상태 | GET /v1/wand/pixverse/tasks/{task_id} |
| 필드 | 유형 | 설명 |
|---|---|---|
model |
string | 필수입니다. 위의 모델 ID 중 하나를 사용하십시오. |
prompt |
string | 필수, 5,000 특성까지. 참조 프롬프트는 @ref_name를 사용할 수 있습니다. |
duration |
integer | 1–15 초, 1080p에서 포함. 기본값은 5 초입니다. |
quality |
string | 필수입니다. 360p, 540p, 720p, 또는 1080p입니다. |
aspect_ratio |
string | Text-to-video 및 reference-to-video에만 해당됩니다. 16:9 (과태), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 또는 21:9. 다른 경로는 입력 이미지를 따릅니다. |
seed |
integer | 0에서 2,147,483,647에. 무작위 시드를 사용하려면 필드를 생략하거나 0으로 설정하세요. |
generate_audio_switch |
boolean | 오디오에 대해 true를 설정합니다. 기본값은 false입니다. |
camera_movement |
string | text-to-video 및 image-to-video를 위한 zoom_in와 같은 선택적인 운동. |
generate_multi_clip_switch |
boolean | V6.0 text-to-video와 image-to-video를 위해 선택. 기본값은 false입니다. |
img_id |
string | image-to-video를 위해 필수. 공개 이미지 URL 또는 Base64. |
img_ids |
string[] | image-to-video 멀티 이미지 템플릿에 예약되어 있습니다. 표준 image-to-video 요청은 img_id를 사용합니다. |
first_frame_img, last_frame_img |
string | 시작/끝 프레임 요청에 필요합니다. 공용 URLs 또는 Base64를 사용합니다. 일치하는 가로 세로 비율을 사용합니다. |
image_references |
object[] | reference-to-video를 위해 필수. img_id를 가진 7개까지 품목, 선택적인 type (subject 또는 background), 및 30 특성까지의 ref_name. |
curl -X POST "https://apimaster.ai/v1/wand/pixverse/text-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"pixverse-video-v6.0","prompt":"A slow pan across a mountain lake","duration":5,"quality":"720p"}'
ErrCode=0 및 성공적인 HTTP 상태가 필요합니다. 응답에는 ErrMsg, Resp.video_id 및 request_id가 포함됩니다. 동일한 계정으로 모든 3–5 초를 투표하십시오. Resp.status는 성공을 위한 1, 가공을 위한 5, 삭제된을 위한 6, 내용 검토 실패를 위한 7, 및 발생 실패를 위한 8입니다. Resp.url는 최종 임시 다운로드 URL이며 12 시간까지 지속됩니다. 응답에는 치수, 크기, 시드, 스타일 및 타임스탬프도 포함될 수 있습니다.
상태를 조회해도 생성이 다시 실행되거나 요금이 다시 청구되지 않습니다. 사용 Idempotency-Key 또는 8–128 보이는 ASCII 제출물을 복구할 문자입니다. 같은 키와 매개변수를 사용하면 HTTP 202와 복구 영수증이 반환됩니다. 같은 키에 다른 매개변수를 사용하면 HTTP 409가 반환됩니다. 원래 요청 복구 가이드를 참조하십시오. API는 음수 프롬프트 매개 변수 또는 callback_url를 허용하지 않습니다.
tokenhub_usage.total_tokens는 청구 가능한 사용량을 보고합니다. 해상도 및 오디오 설정은 가격에 영향을 미칩니다. 자세히 보기 PixVerse V6입니다.0 그리고 PixVerse C1에서 현재를 위한 모형 카드 APIMaster 가격.
