Lompat ke konten

Luma Ray 3.2 Image to Video

Integrasikan

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

Permintaan ini: $0,15 150 kredit API · ≈ ₽16,14 Jalankan di halaman ini

Dapatkan kunci API
Luma AI Gambar ke Video Lip sync5–10 dtkhingga 1080p #stylized#transform#lipsync

Image-to-video Ray 3.2 dengan bingkai akhir atau hingga 64 bingkai kunci, pengulangan, dan output HDR/EXR opsional

Luma AI · Video

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib 88 / 6000

Deskripsi teks tentang adegan atau gerakan yang akan dibuat.

duration 5 s

Durasi video yang dihasilkan. Satu jangkar image_url / end_image_url tidak mendukung 10s; durasi tersebut memerlukan beberapa bingkai kunci yang disediakan melalui keyframes / keyframe_indexes.

aspect_ratio bawaan 16:9

Rasio aspek video hasil.

resolution bawaan 540p

Resolusi video output.

Lanjutan image · end_image · loop · enable_safety_checker · keyframes · keyframe_indexes
image_url
Jatuhkan file, atau

URL gambar bingkai pertama yang disediakan melalui image_url, yang memungkinkan pasangan end_image_url opsional. Mode penjangkaran ini mengecualikan bingkai kunci; pilih salah satu mode, bukan keduanya.

end_image_url
Jatuhkan file, atau

URL gambar bingkai terakhir opsional yang mengaktifkan interpolasi dari image_url ke end_image_url, sebagai alternatif penggunaan bingkai kunci.

Sediakan 1–64 URL gambar sebagai panduan image-to-video multi-bingkai-kunci, dipasangkan dengan daftar keyframe_indexes yang sama panjangnya untuk menentukan posisinya. Penggunaan bingkai kunci mengaktifkan HDR dan pembuatan 10s, tetapi meniadakan image_url, end_image_url, dan loop.

Posisi jangkar yang dipasangkan dengan bingkai kunci: entri [i] menempatkan keyframes[i] dalam output, dan kedua array harus memiliki panjang yang sama. Posisi harus berbeda dan non-negatif; durasi × 24fps menghasilkan rentang 0–120 untuk 5s dan 0–240 untuk 10s.

POST /run/luma/agent/ray/v3.2/image-to-video?wait=20 estimasi harga → $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"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Luma Ray 3.2 Image to Video

Menganimasikan `image_url` sebagai bingkai pertama, secara opsional dengan `end_image_url`, atau menggunakan `keyframes` dengan `keyframe_indexes` (1 hingga 64). Rasio aspek berkisar dari 3:4 hingga 21:9, resolusi adalah 540p, 720p, atau 1080p, dan `duration` adalah 5s atau 10s, dengan 10s yang memerlukan bingkai kunci. `loop`, `hdr`, dan `exr_export` tersedia dalam kondisi yang ditentukan. Batas prompt adalah 6000 karakter.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
≤ 6.000 karakter
Deskripsi teks tentang adegan atau gerakan yang akan dibuat.
image_urlopsional image
Tipeurl · image
URL gambar bingkai pertama yang disediakan melalui image_url, yang memungkinkan pasangan end_image_url opsional. Mode penjangkaran ini mengecualikan bingkai kunci; pilih salah satu mode, bukan keduanya.
end_image_urlopsional end_image
Tipeurl · image
URL gambar bingkai terakhir opsional yang mengaktifkan interpolasi dari image_url ke end_image_url, sebagai alternatif penggunaan bingkai kunci.
aspect_ratioopsional
Tipeenum
Bawaan16:9
3:44:31:19:1616:921:9
Rasio aspek video hasil.
resolutionopsional
Tipeenum
Bawaan540p
540p720p1080p
Resolusi video output.
durationopsional
Tipeenum
Bawaan5s
5s10s
Durasi video yang dihasilkan. Satu jangkar image_url / end_image_url tidak mendukung 10s; durasi tersebut memerlukan beberapa bingkai kunci yang disediakan melalui keyframes / keyframe_indexes.
loopopsional
Tipeboolean
Bawaanfalse
Pembuatan loop tanpa jeda, dibatasi pada output rentang dinamis standar; menentukan bingkai akhir atau bingkai kunci akan membuat opsi ini tidak tersedia.
hdropsional
Tipeboolean
Bawaanfalse
Encoding HDR untuk output MP4, tersedia pada 720p atau 1080p bagi akun dengan akses HDR. Loop harus dinonaktifkan untuk menggunakannya.
exr_exportopsional
Tipeboolean
Bawaanfalse
Ekspor EXR tambahan yang menyertai MP4, hanya tersedia jika akses HDR dan hdr=true sama-sama digunakan.
keyframesopsional
Tipestring[]
≤ 64 item
Sediakan 1–64 URL gambar sebagai panduan image-to-video multi-bingkai-kunci, dipasangkan dengan daftar keyframe_indexes yang sama panjangnya untuk menentukan posisinya. Penggunaan bingkai kunci mengaktifkan HDR dan pembuatan 10s, tetapi meniadakan image_url, end_image_url, dan loop.
keyframe_indexesopsional
Tipeinteger[]
≤ 64 item
Posisi jangkar yang dipasangkan dengan bingkai kunci: entri [i] menempatkan keyframes[i] dalam output, dan kedua array harus memiliki panjang yang sama. Posisi harus berbeda dan non-negatif; durasi × 24fps menghasilkan rentang 0–120 untuk 5s dan 0–240 untuk 10s.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Penyaringan dapat dilonggarkan dengan menetapkan false, jika pemanggil berwenang.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan model.
exr_file
object {url, content_type, file_name, file_size} | nullEXR sidecar dalam bentuk ekspor Luma: satu file EXR atau arsip ZIP. File ini dibuat saat exr_export bernilai true.

Model lainnya: Gambar ke Video

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/luma/agent/ray/v3.2/image-to-video.md. Semua model dan panduan: https://doitong.com/developers/llms.txt