Saltar al cuntegna

Vidu · Q2 · Reference to Video · Pro

Integrar

ID dal model vidu/q2/reference-to-video/pro
# 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/q2/reference-to-video/pro?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"

Datotecas sco l'exempel: $0,30 300 credits API tias datotecas vegnan mesiradas avant l'execuziun Lantschar sin questa pagina

Obtegna ina clav API
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 / 2000

Instrucziuns textualas per generar in video, limitadas a 2000 caracters.

resolution standard 720p

Resoluziun dal video final.

standard 16:9

Definescha las proporziuns larghezza-altezza dal video cun auto, 16:9, 9:16, 1:1 u in'autra valur W:H.

standard 4

Durada dal video en secundas; 0 tscherna ina durada automatica.

Avanzà images · reference_video_urls · movement_amplitude · seed · bgm
reference_image_urls
Trametta in datoteca u

URLs da maletgs da referenza per l'apparientscha dal subject, limitadas a 7 maletgs senza inputs da video. Cun videos vegn il dumber da maletgs reducì a 4.

Trametta in datoteca u

Inputs da video da referenza furnids via URL, limitads a 2; els servan sco material d'editaziun u sco referenzas da moviment.

movement_amplitude standard auto

Dimensiun dal moviment da l'object entaifer il frame.

Seed che renda la generaziun reproducibla. Cun definir None vegn tschernì in seed casualmain.

POST /run/vidu/q2/reference-to-video/pro?wait=20 calculaziun → $0,30
# 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/q2/reference-to-video/pro?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"

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 · Q2 · Reference to Video · Pro

Generescha video d'in prompt da fin a 2000 caracters plus medias da referenza. `reference_image_urls` lubescha fin a 7 maletgs, u 4 sch'ins furnescha videos; `reference_video_urls` accepta fin a 2 videos per l'elavuraziun u sco referenza dal moviment. `duration` è da 1-8 secundas, `resolution` è 540p, 720p u 1080p, e `aspect_ratio` è liber. `bgm` è opziunal.

Parameters

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

NumTip StandardPermess Descripziun
promptobligatori
Tipstring
≤ 2 000 caracters
Instrucziuns textualas per generar in video, limitadas a 2000 caracters.
reference_image_urlsopziunal images
Tipurl[] · image
URLs da maletgs da referenza per l'apparientscha dal subject, limitadas a 7 maletgs senza inputs da video. Cun videos vegn il dumber da maletgs reducì a 4.
reference_video_urlsopziunal
Tipurl[] · video
Inputs da video da referenza furnids via URL, limitads a 2; els servan sco material d'editaziun u sco referenzas da moviment.
seedopziunal
Tipinteger | null
Seed che renda la generaziun reproducibla. Cun definir None vegn tschernì in seed casualmain.
durationopziunal
Tipinteger
Standard4
1 – 8
Durada dal video en secundas; 0 tscherna ina durada automatica.
resolutionopziunal
Tipenum
Standard720p
540p720p1080p
Resoluziun dal video final.
aspect_ratioopziunal
Tipstring
Standard16:9
Definescha las proporziuns larghezza-altezza dal video cun auto, 16:9, 9:16, 1:1 u in'autra valur W:H.
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/q2/reference-to-video/pro",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    }
  },
  "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 Q2 Pro, la generaziun dal qual vegn guidada da referenzas video u da maletgs.

Dapli models: Referenza a video

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