콘텐츠로 건너뛰기

Vidu Q4 Reference to Video

통합

모델 id vidu/q4/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vidu/q4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

예시와 같은 파일: $0.333 333 API 크레딧 실행 전에 파일을 측정합니다 이 페이지에서 실행

API 키 받기
Vidu 참조 이미지를 동영상으로 4K 출력참조 입력3–16 s최대 4K #reference-to-video#multi-shot

최대 12개의 이미지와 3개의 음성 클립을 사용하는 Q4 reference-to-video, 3-16초, 최대 4K

Vidu · 동영상

첫 번째 결과가 여기에 표시됩니다

아래에서 요청을 작성하고 API 키로 실행하세요. 출력은 스토리지에 복사되며, 영구 보관하거나 7일 동안 무료로 보관할 수 있습니다.

요청 만들기

컨트롤은 모델 스키마에서 생성됩니다. 값을 변경하면 코드와 가격이 업데이트됩니다.

•필수 88 / 5000

5000자로 제한된 동영상 생성 프롬프트입니다. [@reference_image_1] 및 [@reference_image_2]처럼 목록 위치로 참조 이미지를 지정하고, 오디오 클립에는 [reference_audio_1] 및 [reference_audio_2]를 사용합니다. 이후 항목에는 번호를 계속 지정합니다.

aspect_ratio 기본값 16:9

출력 동영상의 화면 비율입니다.

resolution 기본값 720p

결과 동영상의 해상도입니다.

기본값 5

동영상 길이(초)이며 3~16 범위입니다.

고급 images · reference_audio_urls · seed · audio · enable_safety_checker
reference_image_urls
파일을 끌어다 놓거나

주제 일관성 유지를 위한 참조 이미지이며 URL 또는 base64 data URI로 제공합니다. png, jpeg, jpg 또는 webp 형식의 이미지 최대 12개를 허용합니다.

파일을 끌어다 놓거나

음성 일관성 유지를 위한 참조 오디오이며 URL 또는 base64 data URI로 제공합니다. 각각 3–12초 길이이고 최대 50 MB인 mp3 클립 최대 3개를 허용합니다.

생성을 재현 가능하게 하는 시드입니다. None으로 설정하면 무작위로 선택됩니다.

POST /run/vidu/q4/reference-to-video?wait=20 견적 → $0.333
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vidu/q4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

이 요청 실행

키는 이 브라우저에 유지됩니다. Doitong API로만 전송되며, 기억하기를 선택한 경우에만 localStorage에 저장됩니다. API 키 받기

Vidu Q4 Reference to Video 정보

최대 12개의 `reference_image_urls`와 `reference_audio_urls`의 최대 3개 mp3 클립(각 3-12초)을 사용해 캐릭터, 사물, 음성을 일관되게 유지합니다. 최대 5000자의 프롬프트에서는 위치로 참조를 지정합니다. `duration`은 3-16초, `resolution`은 최대 4K이며 `audio`는 기본적으로 꺼져 있습니다.

매개변수

표준 이름이나 네이티브 이름 중 하나만 보내세요. 표준 이름

이름유형 기본값허용됨 설명
prompt필수
유형string
≤ 5,000자
5000자로 제한된 동영상 생성 프롬프트입니다. [@reference_image_1] 및 [@reference_image_2]처럼 목록 위치로 참조 이미지를 지정하고, 오디오 클립에는 [reference_audio_1] 및 [reference_audio_2]를 사용합니다. 이후 항목에는 번호를 계속 지정합니다.
reference_image_urls선택 사항 images
유형url[] · image
주제 일관성 유지를 위한 참조 이미지이며 URL 또는 base64 data URI로 제공합니다. png, jpeg, jpg 또는 webp 형식의 이미지 최대 12개를 허용합니다.
reference_audio_urls선택 사항
유형url[] · audio
음성 일관성 유지를 위한 참조 오디오이며 URL 또는 base64 data URI로 제공합니다. 각각 3–12초 길이이고 최대 50 MB인 mp3 클립 최대 3개를 허용합니다.
duration선택 사항
유형integer
기본값5
3 – 16
동영상 길이(초)이며 3~16 범위입니다.
seed선택 사항
유형integer | null
생성을 재현 가능하게 하는 시드입니다. None으로 설정하면 무작위로 선택됩니다.
aspect_ratio선택 사항
유형enum
기본값16:9
16:99:164:33:41:1
출력 동영상의 화면 비율입니다.
resolution선택 사항
유형enum
기본값720p
540p720p1080p2K4K
결과 동영상의 해상도입니다.
audio선택 사항
유형boolean
기본값false
동영상 사운드트랙 토글입니다. false는 결과를 무음으로 유지하고, 활성화하면 동영상과 함께 대화와 음향 효과를 생성합니다.
enable_safety_checker선택 사항
유형boolean
기본값true
호출자에게 권한이 있으면 false로 설정해 검사를 완화할 수 있습니다.
필수 표준 이름, 사용 가능

파일 매개변수에는 공개 https:// URL, 최대 10 MB의 data: URI 또는 업로드의 file_url을 사용할 수 있습니다. 파일

출력

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "vidu/q4/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 333,
    "usd": "0.333",
    "charged": 333,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "cover_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
파일 보관 방식 선택모든 outputs[].url은 스토리지에 저장된 복사본입니다. 계정 설정 또는 ?storage=에 따라 영구 보관(GB-월 단위 과금)하거나 7일 동안 무료로 보관합니다.
모든 모델에서 동일한 구조이미지, 동영상, 오디오 모두 type, url, content_type, width, height 및 duration을 사용합니다. output은 모델 자체의 결과 객체입니다.
출력 필드
video
object {url, content_type, file_name, file_size}Q4 Preview 모델이 참조를 사용해 생성한 동영상입니다.
cover_image
object {url, content_type, file_name, file_size, width, height} | null결과 동영상의 커버 이미지입니다.
seed
integer생성 중 적용할 무작위 시드입니다.

더 많은 모델: 참조 이미지를 동영상으로

AI 에이전트용: 이 페이지의 Markdown 버전: https://doitong.com/ko/developers/models/vidu/q4/reference-to-video.md. 모든 모델 및 가이드: https://doitong.com/developers/llms.txt