Pereiti prie turinio

H3 Max Reference to Video

Integruoti

Modelio id minimax/h3-max/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/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",
    "prompt_expansion_mode": "balanced"
  }'

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

Failai kaip pavyzdyje: 0,40 $ 400 API kreditų jūsų failai išmatuojami prieš paleidimą Paleisti šiame puslapyje

Gauti API raktą
MiniMax · Vaizdo įrašas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma 88 / 50000

Vaizdo įrašo generavimo instrukcijos su nuorodomis, identifikuotomis pagal ištekliaus tipą ir vietą kiekviename nuorodų sąraše, naudojant tokias žymas kaip Audio 1, Video 1, Image 1, Image 2 ir t. t.

•privaloma

Raginio perrašymo pastangos prieš generavimą: „quality“ sukuria išsamesnį raginį per maždaug 30 s, o „balanced“ grąžina rezultatą maždaug per sekundę. Pasirinkite „disabled“, kad raginio išplėtimas būtų praleistas.

resolution numatytoji 768P

Generavimo raiškos pasirinkimas: 1080P raiškai reikia latentinio medžiagos, natūraliai sugeneruotos 768P raiška, tobulinimo, o ne natūralaus generavimo pasirinkta raiška.

aspect_ratio numatytoji adaptive

Išvesties vaizdo įrašo kraštinių santykis.

numatytoji 5

Prašoma trukmė sekundėmis, leidžianti faktinei vaizdo įrašo trukmei būti maždaug 0,7 s ilgesnei už prašytą.

Išplėstiniai images · reference_video_urls · reference_audio_urls · image · middle_image_url · end_image · middle_frame_time · seed · enable_safety_checker · reference_conditions
reference_image_urls
Įmeskite failą arba · iki 9

Subjekto arba stiliaus nuorodų vaizdų URL, dalijantis bendra 12 failų riba su visomis vaizdo ir garso nuorodomis. Raginime šiuos vaizdus nurodykite pagal vietą sąraše naudodami Image 1, Image 2 ir tolesnes žymas.

Įmeskite failą arba · iki 3

Judėjimo arba kitų nuorodų vaizdo įrašų URL, raginime identifikuojami pagal vietą sąraše naudojant Video 1, Video 2 ir tolesnes žymas. Bendra vaizdų, vaizdo įrašų ir garso nuorodų riba yra 12 failų; kiekvienas vaizdo klipas turi trukti 2–15 sekundžių, o bendra trukmė negali viršyti 15 sekundžių.

Įmeskite failą arba · iki 3

Pateikite nuorodų garsą kaip URL ir raginime identifikuokite klipus naudodami Audio 1, Audio 2 ir tolesnes žymas. Kiekvienas klipas turi trukti 2–15 sekundžių, o bendra garso trukmė negali viršyti 15 sekundžių. Bet kuris vaizdų, vaizdo įrašų ir garso nuorodų tipas gali būti pateiktas atskirai arba kartu, laikantis bendros 12 failų ribos.

image_url
Įmeskite failą arba

Pasirinktinis vaizdo URL, apibrėžiantis tikslų pradinį kadrą ir nustatantis išvesties drobę. Nuorodų ištekliai išlaiko subjekto nuoseklumą.

Įmeskite failą arba

Pasirinktinis vidurinį kadrą nurodantis vaizdas, pasiekiamas tik su natūraliu 480P arba 768P generavimu ir pateikus pradinį bei galinį vaizdą.

end_image_url
Įmeskite failą arba

Pasirinktinis galutinio vaizdo URL, nustatantis tikslų vaizdo įrašo pabaigos kadrą pagal pateiktą vaizdą.

Vidurinio vaizdo vietos laikas, naudojamas tik su middle_image_url ir apribotas padėtimis griežtai tarp prašomo vaizdo įrašo pirmo ir paskutinio kadrų. Pateikite nuo pradžios praėjusias sekundes; reikšmė suapvalinama iki artimiausio 24 fps kadro.

Atsitiktinio generavimo pradinis skaičius; jei nenurodytas, jis parenkamas atsitiktinai.

Nuorodų sąrašas, pateikiamas kaip alternatyva reference_*_urls ir niekada nenaudojamas kartu su jais. Eiliškumas tarp modalumų turi reikšmę, todėl seka išlaikoma viso apdorojimo metu.

POST /run/minimax/h3-max/reference-to-video?wait=20 kaina → 0,40 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/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",
    "prompt_expansion_mode": "balanced"
  }'

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie H3 Max Reference to Video

Generuoja vaizdo įrašą pagal orientyrus: iki 9 vaizdų, 3 vaizdo įrašų ir 3 garso įrašų, iš viso ne daugiau kaip 12 failų. Raginys juos nurodo kaip Image 1, Video 1, Audio 1 ir t. t. Pasirenkami pirmas, vidurinis (`middle_image_url` ties `middle_frame_time`) ir paskutinis kadrai nustato pradžią, vidurį ir pabaigą. `duration` yra nuo 0.92 iki 15 sekundžių, o `aspect_ratio` gali būti adaptive.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
promptprivaloma
Tipasstring
≤ 50 000 simbolių
Vaizdo įrašo generavimo instrukcijos su nuorodomis, identifikuotomis pagal ištekliaus tipą ir vietą kiekviename nuorodų sąraše, naudojant tokias žymas kaip Audio 1, Video 1, Image 1, Image 2 ir t. t.
reference_image_urlsneprivalomas images
Tipasurl[] · image
≤ 9 elementų
Subjekto arba stiliaus nuorodų vaizdų URL, dalijantis bendra 12 failų riba su visomis vaizdo ir garso nuorodomis. Raginime šiuos vaizdus nurodykite pagal vietą sąraše naudodami Image 1, Image 2 ir tolesnes žymas.
reference_video_urlsneprivalomas
Tipasurl[] · video
≤ 3 elementų
Judėjimo arba kitų nuorodų vaizdo įrašų URL, raginime identifikuojami pagal vietą sąraše naudojant Video 1, Video 2 ir tolesnes žymas. Bendra vaizdų, vaizdo įrašų ir garso nuorodų riba yra 12 failų; kiekvienas vaizdo klipas turi trukti 2–15 sekundžių, o bendra trukmė negali viršyti 15 sekundžių.
reference_audio_urlsneprivalomas
Tipasurl[] · audio
≤ 3 elementų
Pateikite nuorodų garsą kaip URL ir raginime identifikuokite klipus naudodami Audio 1, Audio 2 ir tolesnes žymas. Kiekvienas klipas turi trukti 2–15 sekundžių, o bendra garso trukmė negali viršyti 15 sekundžių. Bet kuris vaizdų, vaizdo įrašų ir garso nuorodų tipas gali būti pateiktas atskirai arba kartu, laikantis bendros 12 failų ribos.
image_urlneprivalomas image
Tipasurl · image
Pasirinktinis vaizdo URL, apibrėžiantis tikslų pradinį kadrą ir nustatantis išvesties drobę. Nuorodų ištekliai išlaiko subjekto nuoseklumą.
middle_image_urlneprivalomas
Tipasurl · image
Pasirinktinis vidurinį kadrą nurodantis vaizdas, pasiekiamas tik su natūraliu 480P arba 768P generavimu ir pateikus pradinį bei galinį vaizdą.
middle_frame_timeneprivalomas
Tipasnumber | null
> 0< 15
Vidurinio vaizdo vietos laikas, naudojamas tik su middle_image_url ir apribotas padėtimis griežtai tarp prašomo vaizdo įrašo pirmo ir paskutinio kadrų. Pateikite nuo pradžios praėjusias sekundes; reikšmė suapvalinama iki artimiausio 24 fps kadro.
end_image_urlneprivalomas end_image
Tipasurl · image
Pasirinktinis galutinio vaizdo URL, nustatantis tikslų vaizdo įrašo pabaigos kadrą pagal pateiktą vaizdą.
durationneprivalomas
Tipasnumber
Numatytoji reikšmė5
0,92 – 15
Prašoma trukmė sekundėmis, leidžianti faktinei vaizdo įrašo trukmei būti maždaug 0,7 s ilgesnei už prašytą.
resolutionneprivalomas
Tipasenum
Numatytoji reikšmė768P
480P768P1080P
Generavimo raiškos pasirinkimas: 1080P raiškai reikia latentinio medžiagos, natūraliai sugeneruotos 768P raiška, tobulinimo, o ne natūralaus generavimo pasirinkta raiška.
seedneprivalomas
Tipasinteger | null
Atsitiktinio generavimo pradinis skaičius; jei nenurodytas, jis parenkamas atsitiktinai.
enable_safety_checkerneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Saugos tikrintuvo aktyvinimas; true įjungia tikrinimą.
prompt_expansion_modeprivaloma
Tipasstring
Numatytoji reikšmėbalanced
Raginio perrašymo pastangos prieš generavimą: „quality“ sukuria išsamesnį raginį per maždaug 30 s, o „balanced“ grąžina rezultatą maždaug per sekundę. Pasirinkite „disabled“, kad raginio išplėtimas būtų praleistas.
aspect_rationeprivalomas
Tipasenum
Numatytoji reikšmėadaptive
adaptive21:916:94:31:13:49:16
Išvesties vaizdo įrašo kraštinių santykis.
reference_conditionsneprivalomas
Tipasobject[]
≤ 12 elementų
Nuorodų sąrašas, pateikiamas kaip alternatyva reference_*_urls ir niekada nenaudojamas kartu su jais. Eiliškumas tarp modalumų turi reikšmę, todėl seka išlaikoma viso apdorojimo metu.
reference_conditions[].typeprivaloma
Tipasenum
imagevideoaudio
Nuorodos modalumas; eiliškumas tarp sąrašo modalumų turi reikšmę.
reference_conditions[].urlprivaloma
Tipasstring
≥ 1 characters
Nuorodos medijos URL.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/h3-max/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",
    "prompt_expansion_mode": "balanced"
  },
  "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
    },
    "expanded_prompt": "string",
    "seed": 42,
    "timings": {}
  },
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
video
object {url, content_type, file_name, file_size}Modelio sukurtas vaizdo įrašas.
expanded_prompt
string | nullModeliui paruoštas išplėstas raginys arba null, jei išplėsto teksto nėra. null atvejai: išplėtimas išjungtas, išplėtimas nieko nepakeitė arba jį viduje apdorojo modelio priglobta API.
seed
integerBazinis pradinis skaičius, naudojamas sugeneruotam rezultatui atkurti.
timings
object | nullLaiko matavimai, išreikšti sekundėmis, pasiekiami tik maršrutuose, pateikiančiuose vidinės sistemos laikus; kitu atveju – null. Įrašas „inference“ matuoja, kiek laiko DiT triukšmo šalinimas truko GPU vidinėje sistemoje.

Daugiau modelių: Nuoroda į vaizdo įrašą

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/minimax/h3-max/reference-to-video.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt