İçeriğe geç

Luma Ray 3.2 Video to Video

Entegre et

Model kimliği luma/agent/ray/v3.2/video-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/video-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",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

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

Bu istek: $0,72 720 API kredisi · ≈ ₽77,27 Bu sayfada çalıştır

API anahtarı al
Luma AI Videodan Videoya Dudak senkronizasyonu5–10 s1080p değerine kadar #stylized#transform#lipsync

Düzenleme gücü ön ayarları, kontroller ve anahtar karelerle kaynak videoyu yeniden stillendiren Ray 3.2 video düzenleme

Luma AI · Video

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli 88 / 6000

Kaynak videoyu düzenlemeye yönelik metin talimatları.

•gerekli video_url
Dosyayı bırakın veya

Düzenlenecek videonun URL'si.

duration 5 s

Düzenleme sonrasındaki video uzunluğu.

resolution varsayılan 540p

Düzenleme sonrasındaki çıktı çözünürlüğü.

Gelişmiş image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Dosyayı bırakın veya

Düzenlenen video için ilk kare geçersiz kılma değeri; isteğe bağlı bir görsel URL'si olarak sağlanır. Belirtilmezse model bu kareyi kaynak videodan türetir. Örneğin kaynaktan yeniden stillendirilmiş bir açılış görseli sağlamak, düzenlemenin görünümüne rehberlik edebilir.

İsteği gönderen son kullanıcıyı tanımlayan isteğe bağlı opak kimlik.

Düzenlemeler için kaynak koruma ayarı; yalnızca auto_controls kullanılmadığında kullanılabilir. Belirtilmemesi modelin varsayılanını seçer. En fazla ayrışmadan en sıkı uyuma doğru seçenekler 'reimagine_*', dengeli sonuç için 'flex_*' ve 'adhere_*' şeklindedir.

start_image_url yerine görsel URL'leri olarak sağlanan çoklu anahtar kare düzenleme kılavuzları. Her görseli kaynak video karesi konumuna sabitlemek için keyframes'i eşit uzunluktaki keyframe_indexes dizisiyle birlikte sağlayın; en fazla 64 URL'ye izin verilir.

Poz, derinlik, normaller, yörünge ve yüz için koşullandırmayı ayrı ayrı yapılandıran edit_strength'e ince ayarlı alternatif. Bu kontrollerin kullanılması auto_controls'u dışlar.

Keyframes ile bire bir eşleştirilmiş kaynak kare eşlemesi: [i] kaydı, keyframes[i] için sabitleme konumunu belirtir. Her iki dizi de eşit uzunlukta olmalı, konumlar farklı ve negatif olmayan değerler olmalıdır.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 fiyat → $0,72
# 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/video-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",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

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

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Luma Ray 3.2 Video to Video hakkında

Bir `video_url` değerini `prompt` doğrultusunda düzenler; ilk kareyi yönlendirmek için isteğe bağlı `start_image_url` kullanılabilir. `edit_strength`, 1 ile 3 arasında adhere, flex ve reimagine düzeyleri sunarken `auto_controls` veya bir `controls` nesnesi alternatif koşullandırma sağlar. En fazla 64 `keyframes`, `keyframe_indexes` ile sabitlenebilir. Çıktı 540p ile 1080p arasında, 5s veya 10s'tir; isteğe bağlı `hdr` ve `exr_export` desteklenir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
promptgerekli
Türstring
≤ 6.000 karakter
Kaynak videoyu düzenlemeye yönelik metin talimatları.
video_urlgerekli video
Türurl · video
Düzenlenecek videonun URL'si.
useristeğe bağlı
Türstring | null
İsteği gönderen son kullanıcıyı tanımlayan isteğe bağlı opak kimlik.
start_image_urlisteğe bağlı image
Türurl · image
Düzenlenen video için ilk kare geçersiz kılma değeri; isteğe bağlı bir görsel URL'si olarak sağlanır. Belirtilmezse model bu kareyi kaynak videodan türetir. Örneğin kaynaktan yeniden stillendirilmiş bir açılış görseli sağlamak, düzenlemenin görünümüne rehberlik edebilir.
resolutionisteğe bağlı
Türenum
Varsayılan540p
540p720p1080p
Düzenleme sonrasındaki çıktı çözünürlüğü.
durationisteğe bağlı
Türenum
Varsayılan5s
5s10s
Düzenleme sonrasındaki video uzunluğu.
edit_strengthisteğe bağlı
Türenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Düzenlemeler için kaynak koruma ayarı; yalnızca auto_controls kullanılmadığında kullanılabilir. Belirtilmemesi modelin varsayılanını seçer. En fazla ayrışmadan en sıkı uyuma doğru seçenekler 'reimagine_*', dengeli sonuç için 'flex_*' ve 'adhere_*' şeklindedir.
auto_controlsisteğe bağlı
Türboolean
Varsayılanfalse
Otomatik düzenleme koşullandırması: model, bu seçenekle birlikte edit_strength kabul etmek yerine programı belirlemek için kaynak videoyu kullanır.
hdristeğe bağlı
Türboolean
Varsayılanfalse
720p veya 1080p'de MP4 çıktısı için HDR kodlaması; yalnızca HDR erişimine sahip hesaplarda kullanılabilir.
exr_exportisteğe bağlı
Türboolean
Varsayılanfalse
MP4'e eşlik eden ek EXR dışa aktarımı; yalnızca hem HDR erişimi hem de hdr=true ile kullanılabilir.
controlsisteğe bağlı
Türobject
Poz, derinlik, normaller, yörünge ve yüz için koşullandırmayı ayrı ayrı yapılandıran edit_strength'e ince ayarlı alternatif. Bu kontrollerin kullanılması auto_controls'u dışlar.
controls.poseisteğe bağlı
Türobject
Poz veya iskelete dayalı koşullandırma.
controls.pose.enabledisteğe bağlı
Türboolean
Varsayılantrue
Düzenleme sırasında poz veya iskelet koşullandırması için açma-kapama seçeneği.
controls.pose.strengthisteğe bağlı
Türenum
precisecoarse
Poz koşullandırma hassasiyeti seçimi: belirtmeyerek varsayılanı koruyun, daha fazla özgürlük için 'coarse' seçin veya kaynak pozu sıkı biçimde izlemek için 'precise' kullanın.
controls.depthisteğe bağlı
Türobject
Derinlik veya sahne geometrisine dayalı koşullandırma.
controls.depth.enabledisteğe bağlı
Türboolean
Varsayılantrue
Düzenleme sırasında derinlik veya sahne geometrisi koşullandırması için açma-kapama seçeneği.
controls.depth.bluristeğe bağlı
Türnumber | null
0 – 1
Derinlik bulanıklığı ayarı; varsayılanı korumak için belirtilmez veya geometriye daha fazla özgürlük vermek için artırılır.
controls.normalsisteğe bağlı
Türobject
Yüzey normallerine dayalı koşullandırma.
controls.normals.enabledisteğe bağlı
Türboolean
Varsayılantrue
Düzenleme sırasında yüzey normali koşullandırması için açma-kapama seçeneği.
controls.normals.augmentationisteğe bağlı
Türnumber | null
0 – 1
Yüzey normali artırma ayarı; belirtmeyerek varsayılanı koruyun veya yüzey geometrisinin daha fazla yeniden yorumlanmasına izin vermek için artırın.
controls.trajectoryisteğe bağlı
Türobject
Hareket yörüngelerine dayalı koşullandırma.
controls.trajectory.enabledisteğe bağlı
Türboolean
Varsayılantrue
Düzenleme sırasında hareket yörüngesi koşullandırması için açma-kapama seçeneği.
controls.trajectory.sparsityisteğe bağlı
Türnumber | null
0 – 1
Hareket yörüngesi seyrekliği ayarı; varsayılanı korumak için belirtmeyin veya kullanılan hareket sabitleyicilerinin sayısını azaltmak için artırın.
controls.faceisteğe bağlı
Türobject
Yüz kimliğine dayalı koşullandırma.
controls.face.enabledisteğe bağlı
Türboolean
Varsayılantrue
Düzenleme sırasında yüz kimliği koşullandırması için açma-kapama seçeneği.
keyframesisteğe bağlı
Türstring[]
≤ 64 öğe
start_image_url yerine görsel URL'leri olarak sağlanan çoklu anahtar kare düzenleme kılavuzları. Her görseli kaynak video karesi konumuna sabitlemek için keyframes'i eşit uzunluktaki keyframe_indexes dizisiyle birlikte sağlayın; en fazla 64 URL'ye izin verilir.
keyframe_indexesisteğe bağlı
Türinteger[]
≤ 64 öğe
Keyframes ile bire bir eşleştirilmiş kaynak kare eşlemesi: [i] kaydı, keyframes[i] için sabitleme konumunu belirtir. Her iki dizi de eşit uzunlukta olmalı, konumlar farklı ve negatif olmayan değerler olmalıdır.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Çağıran yetkiliyse false ayarlanarak tarama gevşetilebilir.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "luma/agent/ray/v3.2/video-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": 720,
    "usd": "0.72",
    "charged": 720,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
video
object {url, content_type, file_name, file_size}Model tarafından üretilen video.
exr_file
object {url, content_type, file_name, file_size} | nullLuma'nın dışa aktardığı biçimde EXR yan dosyası: tek bir EXR dosyası veya ZIP arşivi. exr_export true olduğunda oluşturulur.

Daha fazla model: Videodan Videoya

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/luma/agent/ray/v3.2/video-to-video.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt