Langkau ke kandungan

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 pada halaman ini

Dapatkan kunci API
Luma AI Imej ke Video Lip-sync5–10 ssehingga 1080p #stylized#transform#lipsync

Imej-ke-video Ray 3.2 dengan bingkai akhir atau sehingga 64 bingkai utama, gelung dan output HDR/EXR pilihan

Luma AI · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan 88 / 6000

Penerangan teks tentang adegan atau gerakan untuk dicipta.

duration 5 s

Tempoh video yang dijana. Satu penambat image_url / end_image_url tidak menyokong 10s; tempoh tersebut memerlukan berbilang bingkai utama yang dibekalkan melalui keyframes / keyframe_indexes.

aspect_ratio lalai 16:9

Nisbah bidang untuk video yang terhasil.

resolution lalai 540p

Resolusi untuk video output.

Lanjutan image · end_image · loop · enable_safety_checker · keyframes · keyframe_indexes
image_url
Lepaskan fail, atau

URL imej bingkai pertama yang dibekalkan melalui image_url, yang membenarkan pasangan end_image_url pilihan. Mod penambatan ini mengecualikan bingkai utama; pilih satu mod sahaja, bukan kedua-duanya.

end_image_url
Lepaskan fail, atau

URL imej bingkai terakhir pilihan yang membolehkan interpolasi daripada image_url kepada end_image_url, sebagai alternatif kepada penggunaan bingkai utama.

Bekalkan 1–64 URL imej sebagai panduan image-to-video berbilang bingkai utama, digandingkan dengan senarai keyframe_indexes yang sama panjang dan menentukan kedudukannya. Menggunakan bingkai utama membolehkan HDR dan penjanaan 10s, tetapi tidak membenarkan image_url, end_image_url dan loop.

Kedudukan penambat yang digandingkan dengan bingkai utama: entri [i] menempatkan keyframes[i] dalam output, dan kedua-dua tatasusunan mesti mempunyai panjang yang sama. Kedudukan mesti berbeza dan tidak negatif; duration × 24fps memberikan julat 0–120 untuk 5s dan 0–240 untuk 10s.

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

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Luma Ray 3.2 Image to Video

Menganimasikan `image_url` sebagai bingkai pertama, secara pilihan dengan `end_image_url`, atau menggunakan `keyframes` bersama `keyframe_indexes` (1 hingga 64). Nisbah aspek berjulat daripada 3:4 hingga 21:9, resolusi ialah 540p, 720p atau 1080p, dan `duration` ialah 5s atau 10s, dengan 10s memerlukan bingkai utama. `loop`, `hdr` dan `exr_export` tersedia di bawah syarat yang dinyatakan. Had prompt ialah 6000 aksara.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
≤ 6,000 aksara
Penerangan teks tentang adegan atau gerakan untuk dicipta.
image_urlpilihan image
Jenisurl · image
URL imej bingkai pertama yang dibekalkan melalui image_url, yang membenarkan pasangan end_image_url pilihan. Mod penambatan ini mengecualikan bingkai utama; pilih satu mod sahaja, bukan kedua-duanya.
end_image_urlpilihan end_image
Jenisurl · image
URL imej bingkai terakhir pilihan yang membolehkan interpolasi daripada image_url kepada end_image_url, sebagai alternatif kepada penggunaan bingkai utama.
aspect_ratiopilihan
Jenisenum
Lalai16:9
3:44:31:19:1616:921:9
Nisbah bidang untuk video yang terhasil.
resolutionpilihan
Jenisenum
Lalai540p
540p720p1080p
Resolusi untuk video output.
durationpilihan
Jenisenum
Lalai5s
5s10s
Tempoh video yang dijana. Satu penambat image_url / end_image_url tidak menyokong 10s; tempoh tersebut memerlukan berbilang bingkai utama yang dibekalkan melalui keyframes / keyframe_indexes.
looppilihan
Jenisboolean
Lalaifalse
Penjanaan gelung lancar, terhad kepada output julat dinamik standard; menetapkan sama ada bingkai akhir atau bingkai utama menjadikan pilihan ini tidak tersedia.
hdrpilihan
Jenisboolean
Lalaifalse
Pengekodan HDR untuk output MP4, tersedia pada 720p atau 1080p kepada akaun dengan akses HDR. Gelung mesti dilumpuhkan untuk menggunakannya.
exr_exportpilihan
Jenisboolean
Lalaifalse
Eksport EXR tambahan yang disertakan bersama MP4, hanya tersedia dengan akses HDR dan hdr=true.
keyframespilihan
Jenisstring[]
≤ 64 item
Bekalkan 1–64 URL imej sebagai panduan image-to-video berbilang bingkai utama, digandingkan dengan senarai keyframe_indexes yang sama panjang dan menentukan kedudukannya. Menggunakan bingkai utama membolehkan HDR dan penjanaan 10s, tetapi tidak membenarkan image_url, end_image_url dan loop.
keyframe_indexespilihan
Jenisinteger[]
≤ 64 item
Kedudukan penambat yang digandingkan dengan bingkai utama: entri [i] menempatkan keyframes[i] dalam output, dan kedua-dua tatasusunan mesti mempunyai panjang yang sama. Kedudukan mesti berbeza dan tidak negatif; duration × 24fps memberikan julat 0–120 untuk 5s dan 0–240 untuk 10s.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan boleh dilonggarkan dengan menetapkannya kepada false, jika pemanggil dibenarkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan oleh model.
exr_file
object {url, content_type, file_name, file_size} | nullFail sampingan EXR dalam bentuk eksport Luma: sama ada satu fail EXR atau arkib ZIP. Ia dijana apabila exr_export ialah true.

Lebih banyak model: Imej ke Video

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