APIMaster.ai

Vidu Video Q4 Preview · API 레퍼런스

단일 이미지 또는 참조에서 비디오를 생성한 다음 APIMaster 작업을 폴링합니다.

단일 시작 이미지에 POST /v1/wand/vidu/image-to-video를 사용하거나 참조 유도 생성에 POST /v1/wand/vidu/reference-to-video를 사용합니다. GET /v1/wand/vidu/tasks/{task_id}로 투표하십시오. 모든 요청에 JSON 제출 및 Bearer 인증을 사용합니다. 이 모델에서는 텍스트 전용 생성 및 별도의 시작/끝 프레임 끝점을 사용할 수 없습니다.

필드 유형 설명
model string 필수입니다. vidu-video-q4-preview를 사용하십시오.
images string[] Image-to-video는 정확히 하나의 이미지가 필요합니다. Reference-to-video는 최대 15 이미지 또는 subjects를 허용합니다. PNG, JPEG/JPG 또는 WebP에서 공용 URLs 또는 데이터 URI를 사용합니다. 가로 세로 비율은 1:4에서 4:1 사이여야 합니다. 각 URL 이미지는 50 MB까지일 수 있습니다. Base64 이미지는 인코딩하기 전에 15 MB로 제한되며 20 MB는 합계로 인코딩됩니다.
subjects object[] images에 대안으로 reference-to-video를 위해. 각 항목의 name와 images를 1개에서 3개로 설정합니다. 프롬프트에서 @name를 가진 주제를 참조하십시오.
prompt string reference-to-video를 위해 필수. 직접적인 이미지 참고를 위한 2,000까지 특성 또는 주제와 image-to-video를 위한 5,000. Image-to-video는 is_rec가 켜져 있을 때 이 필드를 무시합니다.
auto_subjects boolean reference-to-video에 대한 제목 라이브러리 옵션. 기본값은 false입니다.
audio boolean 기본값은 image-to-video에 대한 true 및 reference-to-video에 대한 false입니다. 오디오가 포함된 참조 비디오에는 subjects와 명시적인 true 값이 필요합니다.
audio_type string 오디오가 활성화되면 all(기본값), speech_only 또는 sound_effect_only를 사용합니다.
is_rec boolean image-to-video를 위한 자동적인 신속한 권고. 이를 활성화하면 작업 사용량이 증가합니다.
duration integer 3에서 16 초로, 5를 기본값으로 사용합니다.
resolution string 540p, 720p (기본값), 1080p, 2K 또는 4K입니다.
aspect_ratio string Reference-to-video 전용. 16:9 (기본값), 9:16, 3:4, 4:3 또는 1:1를 사용하십시오. Image-to-video는 입력 이미지를 따릅니다.
seed integer 무작위 시드를 사용하려면 필드를 생략하거나 0으로 설정하세요.
payload string 1,048,576 문자까지 옵션 응용 프로그램 데이터.
watermark boolean 기본값은 false입니다.
wm_url string 선택적인 주문 워터마크 URL. 기본 워터마크가 왼쪽 상단에 나타납니다. API가 wm_position를 수락하지 않습니다.
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'

task_id와 같은 계정을 사용해 5–10초마다 상태를 조회하세요. 국가는 created, queueing, processing, success 및 failed입니다. creations[].url는 비디오이며 creations[].cover_url는 커버입니다. 12 시간 내에 임시 링크를 다운로드하십시오. 실패를 보고할 때 request_id를 유지하십시오.

사용 Idempotency-Key 또는 8–128 보이는 ASCII 제출물을 복구할 문자입니다. 같은 키와 매개변수를 사용하면 HTTP 202와 복구 영수증이 반환됩니다. 같은 키에 다른 매개변수를 사용하면 HTTP 409가 반환됩니다. 원래 요청 복구 가이드를 참조하십시오. 쿼리 시간 초과는 새 비디오를 만들지 않고 다시 시도할 수 있습니다.

게이트웨이는 세대를 한 번 정착시킵니다. tokenhub_usage.total_tokens는 청구 가능한 사용량을 보고합니다. 자세히 보기 Vidu Video Q4 Preview 모델 카드 현재에 대하여 For the Current APIMaster 가격.