Langkau ke kandungan

Vidu · Q1 · Reference to Video

Integrasikan

ID model vidu/q1/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/q1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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"

Permintaan ini: ≈$0.40 400 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Vidu Rujukan ke Video Input rujukan #stylized#transform

Penjanaan video Q1 yang mengekalkan konsistensi subjek menggunakan sehingga 7 imej rujukan, dengan muzik latar pilihan

Vidu · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan 88 / 1500

Teks prompt penjanaan video, terhad kepada 1500 aksara.

•diperlukan reference_image_urls
Lepaskan fail, atau

Rujukan penampilan subjek yang dibekalkan sebagai URL imej, terhad kepada 7 imej untuk Q1 mengekalkan penampilan yang konsisten.

aspect_ratio lalai 16:9

Nisbah bidang video output.

Lanjutan movement_amplitude · seed · bgm
movement_amplitude lalai auto

Tahap pergerakan objek dalam bingkai.

Seed yang mengawal rawak semasa penjanaan.

POST /run/vidu/q1/reference-to-video?wait=20 sebut harga → $0.40
# 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/q1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# 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"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Vidu · Q1 · Reference to Video

Menjana klip daripada `prompt` teks (maksimum 1500 aksara) dan `reference_image_urls`, yang mengekalkan konsistensi penampilan subjek; sehingga 7 imej disokong. Pilih 16:9, 9:16 atau 1:1 dengan `aspect_ratio`, laraskan `movement_amplitude`, dan aktifkan `bgm` untuk menambah muzik latar.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 1,500 aksara
Teks prompt penjanaan video, terhad kepada 1500 aksara.
reference_image_urlsdiperlukan images
Jenisurl[] · image
Rujukan penampilan subjek yang dibekalkan sebagai URL imej, terhad kepada 7 imej untuk Q1 mengekalkan penampilan yang konsisten.
seedpilihan
Jenisinteger | null
Seed yang mengawal rawak semasa penjanaan.
aspect_ratiopilihan
Jenisenum
Lalai16:9
16:99:161:1
Nisbah bidang video output.
movement_amplitudepilihan
Jenisenum
Lalaiauto
autosmallmediumlarge
Tahap pergerakan objek dalam bingkai.
bgmpilihan
Jenisboolean
Lalaifalse
Mengawal sama ada video yang dijana menyertakan muzik latar.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "vidu/q1/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": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "reference_image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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
    }
  },
  "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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}Output video Q1 yang menggunakan imej rujukan untuk membimbing penampilan subjek agar kekal konsisten.

Lebih banyak model: Rujukan ke Video

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/vidu/q1/reference-to-video.md. Semua model dan panduan: https://doitong.com/developers/llms.txt