Siirry sisältöön

Luma Ray 3.2 Image to Video

Integroi

Mallin tunniste luma/agent/ray/v3.2/image-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/luma/agent/ray/v3.2/image-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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Tämä pyyntö: 0,15 $ 150 API-krediittiä · ≈ 16,14 ₽ Suorita tällä sivulla

Hanki API-avain
Luma AI Kuvasta videoksi Huulisynkronointi5–10 senintään 1080p #stylized#transform#lipsync

Ray 3.2 kuvasta videoksi, päätekuvalla tai enintään 64 avainkuvalla, silmukoinnilla ja valinnaisella HDR/EXR-tulostuksella

Luma AI · Video

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen 88 / 6000

Luotavan kohtauksen tai liikkeen tekstikuvaus.

duration 5 s

Generoidun videon kesto. Yksittäinen image_url / end_image_url -ankkuri ei tue arvoa 10s; tämä kesto edellyttää useita keyframes / keyframe_indexes-parametreilla toimitettuja avainruutuja.

aspect_ratio oletus 16:9

Tulostevideon kuvasuhde.

resolution oletus 540p

Tulostevideon resoluutio.

Lisäasetukset image · end_image · loop · enable_safety_checker · keyframes · keyframe_indexes
image_url
Pudota tiedosto tai

image_url-parametrin kautta toimitettu ensimmäisen ruudun kuvan URL, joka mahdollistaa valinnaisen end_image_url-kumppanin. Tämä ankkurointitila sulkee avainruudut pois; valitse toinen tila, älä molempia.

end_image_url
Pudota tiedosto tai

Valinnainen viimeisen ruudun kuvan URL, joka mahdollistaa interpoloinnin image_url-arvosta end_image_url-arvoon vaihtoehtona avainruutujen käytölle.

Toimita 1–64 kuvan URL-osoitetta monen avainruudun image-to-video-ohjaimiksi sekä yhtä pitkä keyframe_indexes-lista, joka määrittää niiden sijainnit. Keyframes-parametrin käyttö mahdollistaa HDR:n ja 10s-generoinnin, mutta sulkee pois image_url-, end_image_url- ja loop-parametrit.

Keyframes-parametriin yhdistetyt ankkurisijainnit: alkio [i] sijoittaa keyframes[i]-arvon tulosteeseen, ja taulukoiden pituuksien on oltava samat. Sijaintien on oltava erillisiä ja ei-negatiivisia; duration × 24fps antaa alueet 0–120 arvolle 5s ja 0–240 arvolle 10s.

POST /run/luma/agent/ray/v3.2/image-to-video?wait=20 hinta → 0,15 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/luma/agent/ray/v3.2/image-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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Luma Ray 3.2 Image to Video

Animoi `image_url`-kuvan ensimmäiseksi kuvaksi, valinnaisesti `end_image_url`-kuvan kanssa, tai käyttää sen sijaan `keyframes`-kuvia ja `keyframe_indexes`-arvoja (1–64). Kuvasuhteet vaihtelevat välillä 3:4–21:9, resoluutio on 540p, 720p tai 1080p ja `duration` on 5s tai 10s; 10s edellyttää avainkuvia. `loop`, `hdr` ja `exr_export` ovat käytettävissä ilmoitetuilla ehdoilla. Kehotteen enimmäispituus on 6000 merkkiä.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
promptpakollinen
Tyyppistring
≤ 6 000 merkkiä
Luotavan kohtauksen tai liikkeen tekstikuvaus.
image_urlvalinnainen image
Tyyppiurl · image
image_url-parametrin kautta toimitettu ensimmäisen ruudun kuvan URL, joka mahdollistaa valinnaisen end_image_url-kumppanin. Tämä ankkurointitila sulkee avainruudut pois; valitse toinen tila, älä molempia.
end_image_urlvalinnainen end_image
Tyyppiurl · image
Valinnainen viimeisen ruudun kuvan URL, joka mahdollistaa interpoloinnin image_url-arvosta end_image_url-arvoon vaihtoehtona avainruutujen käytölle.
aspect_ratiovalinnainen
Tyyppienum
Oletus16:9
3:44:31:19:1616:921:9
Tulostevideon kuvasuhde.
resolutionvalinnainen
Tyyppienum
Oletus540p
540p720p1080p
Tulostevideon resoluutio.
durationvalinnainen
Tyyppienum
Oletus5s
5s10s
Generoidun videon kesto. Yksittäinen image_url / end_image_url -ankkuri ei tue arvoa 10s; tämä kesto edellyttää useita keyframes / keyframe_indexes-parametreilla toimitettuja avainruutuja.
loopvalinnainen
Tyyppiboolean
Oletusfalse
Saumattoman silmukan generointi, rajoitettu standardin dynaamisen alueen tulosteeseen; loppuruudun tai avainruutujen määrittäminen poistaa tämän vaihtoehdon käytöstä.
hdrvalinnainen
Tyyppiboolean
Oletusfalse
HDR-koodaus MP4-tulosteelle, saatavilla tarkkuuksilla 720p tai 1080p tileille, joilla on HDR-käyttöoikeus. Silmukointi on poistettava käytöstä tämän käyttämiseksi.
exr_exportvalinnainen
Tyyppiboolean
Oletusfalse
MP4-tiedoston mukana toimitettava EXR-vienti, joka on saatavilla vain, kun sekä HDR-käyttöoikeus että hdr=true ovat käytössä.
keyframesvalinnainen
Tyyppistring[]
≤ 64 kohdetta
Toimita 1–64 kuvan URL-osoitetta monen avainruudun image-to-video-ohjaimiksi sekä yhtä pitkä keyframe_indexes-lista, joka määrittää niiden sijainnit. Keyframes-parametrin käyttö mahdollistaa HDR:n ja 10s-generoinnin, mutta sulkee pois image_url-, end_image_url- ja loop-parametrit.
keyframe_indexesvalinnainen
Tyyppiinteger[]
≤ 64 kohdetta
Keyframes-parametriin yhdistetyt ankkurisijainnit: alkio [i] sijoittaa keyframes[i]-arvon tulosteeseen, ja taulukoiden pituuksien on oltava samat. Sijaintien on oltava erillisiä ja ei-negatiivisia; duration × 24fps antaa alueet 0–120 arvolle 5s ja 0–240 arvolle 10s.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Suodatusta voi höllentää asettamalla arvoksi false, jos kutsujalla on siihen valtuutus.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "luma/agent/ray/v3.2/image-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": 150,
    "usd": "0.15",
    "charged": 150,
    "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
    },
    "exr_file": {
      "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
video
object {url, content_type, file_name, file_size}Mallin tuottama video.
exr_file
object {url, content_type, file_name, file_size} | nullEXR-oheistiedosto Luma-viennin muodossa: joko yksi EXR-tiedosto tai ZIP-arkisto. Se generoidaan, kun exr_export on true.

Lisää malleja: Kuvasta videoksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/luma/agent/ray/v3.2/image-to-video.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt