Video yapmak

Her video tek bir çağrı ile başlar: POST /v1/render. Bu sayfa, o çağrıda yaptığınız seçimleri açıklar. Her alan ve sınırları için Create render referansına bakınız.

Kısa veya sahne planı

Bunlardan birini gönder.

Bir özet

brief, videonun sade bir açıklamasıdır, 4.000 karaktere kadar olabilir. Reigniter sahneleri planlar, anlatımı yazar ve render başlatır.

{
  "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"
}

Planı şekillendiren alanlar:

Saha	Varsayılan	Ne yapar
kind	ad	ad reklam için training eğitim videosu için.
duration_sec	20 ad, 60 training	Hedef toplam uzunluğu, 5 ila 120 saniye.
narrator	true	false seslendirme olmadan bir video yapıyor.
brand_name	Hiçbiri	Planlayıcının kullanması gereken marka adı.
category	Hiçbiri	Örneğin ürün kategorisi coffee veya saas.
title	Senin için yazıldı	Videonun başlığı.

Planlama kredileri harcar. Planlama başarısız olursa 502 PLAN_FAILED alırsınız ve planlama kredileri iade edilir. Bir kişiye plan_notes geri gönderirseniz, planlayıcının kendi planında işaretlediği her şeyi açıklar.

Bir sahne planı

Bir scene_plan, 1 ila 12 sahneden oluşan kendi listenizdir, verilen sırayla render edilir. Her sahnenin ne göstermesi ve söylemesi gerektiğini zaten bildiğinizde kullanın.

{
  "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" }
    }
  ]
}

Sahne türleri:

type	Ne render ediyor
motion	Net animasyonlu metin, sayılar, adımlar veya logo. Okunması gereken her şey için kullanın.
t2v_fast	İnsanların, yerlerin veya nesnelerin görüntülerini prompt.
i2v_fast	Bir görüntüden başlayan görüntüler: sahnenin ref_image_url ya da ürün fotoğrafınız.
s2v	Kameraya konuşan bir sunucu. Bir yüze ihtiyacı var.
walk_talk	Yürüyen ve konuşan bir sunucu. Bir yüze ihtiyacı var.
footage	video_url’dan kendi klibiniz, olduğu gibi oynanıyor.

Her sahne bir prompt (kameranın gördüğü ya da ekrandaki kopya motion) ve isteğe bağlı bir script (anlatıcının repliği) alır. Sahne alanlarının tam listesi referansta yer alır.

İpucu

Oluşturulan görüntüler okunabilir metin açısından zayıf. motion sahnelere ekranlar, fiyatlar, adımlar ve sloganlar ekleyin ve t2v_fast gerçek dünya için kalın.

Marka

Bir API render, hesabınızda marka kitleri olsa bile kendi başına bir markayı asla seçmez. Her istekte markayı seçersiniz:

• brand_logo_url: logonuzu, kamuya açık https URL veya veri URI’si olarak.
• brand_colors: isteğe bağlı, 12 altıgen renge kadar, örneğin ["#3B2416", "#F4E9DC"].

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

Logo olmadan, video logo ve son kart olmadan render edilir. Bunu açıkça söylemek gerekirse, brand_enabled: false gönderin.

Marka kitleri

brand_kit_id, kaydettiğiniz marka kitlerinden birini adlandırıyor. Şimdilik, brand_logo_url ile birlikte gönderin. Tek başına bir brand_kit_id 422 BRAND_REQUIRED ile reddedilir. Başka bir hesaba ait bir kit asla kullanılmaz.

Ürün fotoğrafı

product_image_url, ürününüzün bir fotoğrafıdır (genel https URL’si veya veri URI’si). Ürünü her sahnede aynı tutar, modelin bir görüntü icat etmesine izin vermez.

Bazı formatlar ürünü satıyor ve fotoğraf gerektiriyor. Böyle bir route ayarlarsanız (örneğin product-ad, unboxing, ugc-ad veya app-demo) ve plan ürünü gösteriyorsa, fotoğrafsız bir render 400 PRODUCT_IMAGE_REQUIRED ile reddedilir. Kasıtlı olarak fotoğrafsız render yapmak için product_enabled: false gönderin.

Sunucu

s2v ve walk_talk sahnelerde bir kişi konuşur. Bir yüze ihtiyaçları var: tüm video için avatar_preset_id ya da sahnede ref_image_url bir yüz. Konuşma sahnesi olan ve yüz olmayan bir plan 400 PRESENTER_REQUIRED ile reddedilir. Stok sunucu Reigniter kullanmak için presenter_enabled: false gönderin.

Videoyu bağlayacak hiçbir şey yok

Bir route belirleyip marka, ürün fotoğrafı ve sunucu göndermediğinizde, plan tüm fotoğraflarını ürettiğinde, render 422 NO_ANCHOR ile reddedilir. Bir çapa olmadan model ürünü ve insanları icat eder ve onlar markanızla eşleşmezler.

Üçünden birini ekleyin ya da yine de render için product_enabled: false veya presenter_enabled: false gönderin.

Bu kontrollerden önce brifingler planlanıyor

Bir brief ile planlama önce yapılır ve ücret alınır. Planlanan render yukarıdaki çeklerden biriyle reddedilirse, planlama kredileri iade edilmez. Markaya, ürün fotoğrafına veya sunucuya brifingle birlikte gönderin, böylece çek ilk kez geçer.

Görünüm ve ses

Saha	Değerler	Varsayılan
aspect	9:16, 16:9, 1:1, 4:5, 4:3, 3:4	9:16
quality	draft, standard, premium	draft
language	bir dil kodu, örneğin 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	formata göre ayarlanır
voice_preset_id	anlatıcı ses kimliği	Varsayılan bir ses
upscale	true ya da false	format ve kaliteye göre ayarlanır

Daha yüksek quality ve upscale daha fazla kredi gerektirir ve daha uzun sürer.

Eğitim videoları

Bir kind: "training" bir brief ile reklam yerine eğitim videosu planlamayı önerir. Planlayıcı adımları ve özetleri yazar, motion sahneleri ekrandaki talimatlar için kullanır.

{
  "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"
}

Yeniden denemeler ve aynı potensi

Her render’de benzersiz bir değere sahip bir Idempotency-Key başlığı gönderin, örneğin UUID gibi. İsteğiniz zaman doluyorsa ve aynı anahtarla tekrar denerseniz, Reigniter tekrarı reddeder ve ikinci kez render etmez veya ücret almıyor.

• Tekrar reddedilir, bu yüzden orijinal job_id döndürmez. İlk yanıttan job_id aldığınızda kaydedin.
• Bir scene_plan ile tekrar, 409 DUPLICATE_REQUEST döner.
• Bir brief ile tekrar, 402 mesajını This request was already submitted ile geri getirebilir. Bunu bir 409 ile aynı şekilde ele alın.
• Her yeni video için yeni bir tuş kullanın. Farklı bir video için bir anahtarı tekrar kullanmak, o videoyu reddeder.

Başlık olmadan her çağrı yeni bir render ve yeni bir ücret anlamına gelir.

Su işaretleri

Render yanıtında watermarked bir alan var. Agency planında yapılan videolar su işareti değil.

Çıktı

İş başarılı olduğunda, GET /v1/job/{id} video_url doğrudan MP4bağlantı sağlar. İndirin ve kendi kopyanızı saklayın.