Saltar al cuntegna

Vidu · Q1 · Reference to Video

Integrar

ID dal 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"

Questa dumonda: ≈$0,40 400 credits API Lantschar sin questa pagina

Obtegna ina clav API
Vidu Referenza a video Inputs da referenza #stylized#transform

Generaziun da video Q1 che mantegn subjects consistents cun fin a 7 maletgs da referenza, cun musica da fund facultativa

Vidu · Video

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori 88 / 1500

Text dal prompt da generaziun video, limità a 1500 caracters.

•obligatori reference_image_urls
Trametta in datoteca u

Referenzas da l'apparientscha dal subject furnidas sco URLs da maletgs, limitadas a 7 maletgs per Q1 per mantegnir ina apparientscha consistenta.

aspect_ratio standard 16:9

Proporziun d'aspect dal video d'output.

Avanzà movement_amplitude · seed · bgm
movement_amplitude standard auto

Dimensiun dal moviment da l'object entaifer il frame.

Seed che controlla la casualitad durant la generaziun.

POST /run/vidu/q1/reference-to-video?wait=20 calculaziun → $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"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart Vidu · Q1 · Reference to Video

Generescha in clip dad in `prompt` textual (maximalmain 1500 caracters) e da `reference_image_urls`, che mantegnan consistenta l'apparientscha dal subject; fin a 7 maletgs èn sustegnids. Tscherna 16:9, 9:16 u 1:1 cun `aspect_ratio`, adatta `movement_amplitude`, ed activa `bgm` per agiuntar musica da fund.

Parameters

Invia u il num canonic u il num nativ, betg omaduas. Nums canonics

NumTip StandardPermess Descripziun
promptobligatori
Tipstring
≤ 1 500 caracters
Text dal prompt da generaziun video, limità a 1500 caracters.
reference_image_urlsobligatori images
Tipurl[] · image
Referenzas da l'apparientscha dal subject furnidas sco URLs da maletgs, limitadas a 7 maletgs per Q1 per mantegnir ina apparientscha consistenta.
seedopziunal
Tipinteger | null
Seed che controlla la casualitad durant la generaziun.
aspect_ratioopziunal
Tipenum
Standard16:9
16:99:161:1
Proporziun d'aspect dal video d'output.
movement_amplitudeopziunal
Tipenum
Standardauto
autosmallmediumlarge
Dimensiun dal moviment da l'object entaifer il frame.
bgmopziunal
Tipboolean
Standardfalse
Controlla sch'il video generà cuntegna musica da fund.
obligatori Num canonic, er acceptà

Ils parameters da datotecas acceptan ina URL publica https://, ina URI data: fin a 10 MB u il file_url d'ina chargiada. Datotecas

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"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
video
object {url, content_type, file_name, file_size}Video d'output da Q1, en il qual ils maletgs da referenza dirigian l'apparientscha dals subjects per la mantegnair consistenta.

Dapli models: Referenza a video

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/vidu/q1/reference-to-video.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt