Membuat video

Setiap video dimulai dengan satu panggilan: POST /v1/render. Halaman ini menjelaskan pilihan yang Anda buat dalam panggilan tersebut. Untuk setiap bidang dan batasannya, lihat referensi Buat render.

Rencana singkat atau adegan

Kirim salah satu ini.

Singkatan

brief adalah deskripsi video dalam bahasa sederhana, hingga 4.000 karakter. Reigniter merencanakan adegan, menulis narasi, dan memulai render.

{
  "brief": "A 30 second advert for Northwind Coffee's weekly subscription. Show the beans, the roasting, and a happy customer opening the box.",
  "kind": "ad",
  "duration_sec": 30,
  "brand_name": "Northwind Coffee",
  "category": "coffee"
}

Bidang yang membentuk rencana:

Lapangan	Gagal bayar	Apa yang dilakukan
kind	ad	ad untuk iklan, training untuk video pelatihan.
duration_sec	20 untuk ad, 60 untuk training	Total durasi target, 5 hingga 120 detik.
narrator	true	false membuat video tanpa suara latar.
brand_name	tidak ada	Nama merek yang harus digunakan oleh perencana.
category	tidak ada	Kategori produk, misalnya coffee atau saas.
title	ditulis untukmu	Judul untuk video tersebut.

Perencanaan menggunakan kredit. Jika perencanaan gagal, Anda mendapatkan 502 PLAN_FAILED dan kredit perencanaan akan dikembalikan. Jika Anda mengirim plan_notes kembali ke seseorang, mereka menjelaskan apa pun yang ditandai perencana dalam rencana mereka sendiri.

Rencana adegan

scene_plan adalah daftar Anda sendiri yang terdiri dari 1 hingga 12 adegan, dirender sesuai urutan, sesuai dengan yang diberikan. Gunakan saat Anda sudah tahu apa yang harus ditampilkan dan diisi setiap adegan.

{
  "title": "Northwind launch",
  "scene_plan": [
    {
      "type": "motion",
      "role": "hook",
      "prompt": "Fresh coffee, delivered weekly",
      "script": "Fresh coffee, delivered every week.",
      "motion": { "beat": "hook" }
    },
    {
      "type": "t2v_fast",
      "role": "body",
      "prompt": "Slow close-up of coffee beans tumbling out of a kraft paper bag onto a wooden table, soft morning light",
      "script": "Roasted in small batches, a few days before it reaches you."
    },
    {
      "type": "motion",
      "role": "cta",
      "prompt": "Order at northwind.example",
      "script": "Order today.",
      "motion": { "beat": "cta" }
    }
  ]
}

Jenis adegan:

type	Apa yang dirender
motion	Teks animasi yang jelas, angka, langkah, atau logo. Gunakan untuk apa pun yang harus mudah dibaca.
t2v_fast	Rekaman yang dihasilkan dari orang, tempat, atau objek, dari prompt.
i2v_fast	Rekaman yang dihasilkan yang dimulai dari gambar: adegan ref_image_url, atau foto produk Anda.
s2v	Seorang presenter yang berbicara ke kamera. Butuh wajah.
walk_talk	Seorang presenter yang berjalan dan berbicara. Butuh wajah.
footage	Klip Anda sendiri dari video_url, diputar apa adanya.

Setiap adegan mengambil prompt (apa yang dilihat kamera, atau salinan di layar untuk motion) dan script opsional (baris narator). Daftar lengkap field adegan ada di referensi.

Tips

Rekaman yang dihasilkan kurang baik dalam membaca teks. Masukkan layar, harga, langkah, dan slogan di adegan motion, dan simpan t2v_fast untuk dunia nyata.

Merek

Render API tidak pernah mengambil merek secara mandiri, bahkan jika akun Anda memiliki kit merek. Anda memilih merek di setiap permintaan:

• brand_logo_url: logo Anda, sebagai URL https publik atau URI data.
• brand_colors: opsional, hingga 12 warna heksagonal, seperti ["#3B2416", "#F4E9DC"].

{
  "brief": "A 20 second advert for Northwind Coffee.",
  "brand_logo_url": "https://example.com/northwind-logo.png",
  "brand_colors": ["#3B2416", "#F4E9DC"]
}

Tanpa logo, video akan ditampilkan tanpa logo dan tanpa kartu akhir. Untuk mengatakannya secara eksplisit, kirim brand_enabled: false.

Kit merek

brand_kit_id menyebutkan salah satu kit merek yang Anda simpan. Untuk saat ini, kirimkan bersama brand_logo_url. brand_kit_id sendiri ditolak bersama 422 BRAND_REQUIRED. Kit yang milik akun lain tidak pernah digunakan.

Foto produk

product_image_url adalah foto produk Anda (URL https publik atau URI data). Ini menjaga produk tetap sama di setiap adegan, bukan membiarkan model yang menciptakannya.

Beberapa format menjual produk dan membutuhkan foto. Jika Anda mengatur route seperti itu (misalnya product-ad, unboxing, ugc-ad, atau app-demo) dan rencana menampilkan produk, render tanpa foto ditolak dengan 400 PRODUCT_IMAGE_REQUIRED. Untuk render tanpa foto secara sengaja, kirim product_enabled: false.

Pembawa Acara

Adegan s2v dan walk_talk menunjukkan seseorang berbicara. Mereka butuh wajah: avatar_preset_id untuk seluruh video, atau ref_image_url di lokasi. Rencana dengan adegan berbicara tanpa wajah ditolak dengan 400 PRESENTER_REQUIRED. Untuk Reigniter menggunakan presenter stok, kirim presenter_enabled: false.

Tidak ada yang menjadi jangkar video

Ketika Anda mengatur route dan tidak mengirim merek, foto produk, dan tidak ada presenter, dan rencana akan menghasilkan semua gambarnya, render ditolak dengan 422 NO_ANCHOR. Tanpa jangkar, model menciptakan produk dan orang-orangnya, dan mereka tidak akan cocok dengan merek Anda.

Tambahkan salah satu dari ketiganya, atau kirim product_enabled: false atau presenter_enabled: false untuk dirender saja.

Brief direncanakan sebelum pemeriksaan ini

Dengan brief, perencanaan dilakukan terlebih dahulu dan dikenakan biaya. Jika hasil yang direncanakan kemudian ditolak oleh salah satu cek di atas, kredit perencanaan tidak akan dikembalikan. Kirimkan merek, foto produk, atau presenter beserta briefing, sehingga cek lolos pada percobaan pertama.

Penampilan dan suara

Lapangan	Nilai-nilai	Gagal bayar
aspect	9:16, 16:9, 1:1, 4:5, 4:3, 3:4	9:16
quality	draft, standard, premium	draft
language	kode bahasa, seperti en, fr, de	en
art_style	cinematic, stop_motion, mascot, watercolour, whimsy_3d	cinematic
music_style	upbeat-tech, cinematic-epic, lo-fi-chill, corporate-pop	diatur berdasarkan format
voice_preset_id	ID suara narator	suara default
upscale	true atau false	ditentukan oleh format dan kualitas

Biaya quality dan upscale lebih mahal dan memakan waktu lebih lama.

Video pelatihan

Atur kind: "training" dengan brief untuk merencanakan video pelatihan, bukan iklan. Perencana menulis langkah-langkah dan rangkuman, serta menggunakan motion adegan untuk instruksi di layar.

{
  "brief": "How to reset a password in the Acme admin panel. Three steps, then a recap.",
  "kind": "training",
  "duration_sec": 60,
  "aspect": "16:9",
  "brand_logo_url": "https://example.com/acme-logo.png"
}

Upaya ulang dan idempotensi

Kirim header Idempotency-Key dengan nilai unik, seperti UUID, pada setiap render. Jika permintaan Anda habis waktu dan Anda mencoba ulang dengan kunci yang sama, Reigniter menolak pengulangan dan tidak melakukan render atau mengisi daya untuk kedua kalinya.

• Pengulangan ditolak, jadi tidak mengembalikan job_id asli. Simpan job_id dari respons pertama setiap kali Anda mendapatkannya.
• Dengan scene_plan, pengulangan mengembalikan 409 DUPLICATE_REQUEST.
• Dengan brief, pengulangan dapat kembali 402 dengan pesan This request was already submitted. Perlakukan sama seperti 409.
• Gunakan kunci baru untuk setiap video baru. Menggunakan ulang kunci untuk video lain menolak video tersebut.

Tanpa header, setiap panggilan adalah render baru dan biaya baru.

Watermark

Respons render memiliki bidang watermarked. Video yang dibuat di rencana Agency tidak diberi watermark.

Output

Ketika pekerjaan berhasil, video_url pada GET /v1/job/{id} adalah tautan langsung ke MP4. Unduh dan simpan salinan Anda sendiri.