Video's maken

Elke video begint met één aanroep: POST /v1/render. Deze pagina legt de keuzes uit die je in die aanroep maakt. Voor elk veld en zijn limieten, zie de referentie Create render.

Briefing of scèneplan

Stuur er een van deze.

Een korte samenvatting

Een brief is een eenvoudige beschrijving van de video, tot 4.000 tekens. Reigniter plant de scènes, schrijft de vertelling en begint met renderen.

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

Velden die het plan vormgeven:

Veld	Standaard	Wat het doet
kind	ad	ad voor een advertentie, training voor een trainingsvideo.
duration_sec	20 voor ad, 60 voor training	Doelwitlengte totaal, 5 tot 120 seconden.
narrator	true	false maakt een video zonder voice-over.
brand_name	Geen	De merknaam die de planner moet gebruiken.
category	Geen	De productcategorie, bijvoorbeeld coffee of saas.
title	geschreven voor jou	Een titel voor de video.

Planning geeft credits uit. Als planning mislukt, krijg je 502 PLAN_FAILED en worden de planningscredits terugbetaald. Als je plan_notes terugstuurt naar iemand, leggen ze alles uit wat de planner in zijn eigen plan heeft gemarkeerd.

Een scèneplan

Een scene_plan is je eigen lijst van 1 tot 12 scènes, gerenderd in volgorde, zoals gegeven. Gebruik het wanneer je al weet wat elke scène moet laten zien en zeggen.

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

Scènetypen:

type	Wat het rendert
motion	Scherpe geanimeerde tekst, cijfers, stappen of een logo. Gebruik het voor alles wat leesbaar moet zijn.
t2v_fast	Genereerde beelden van mensen, plaatsen of objecten uit prompt.
i2v_fast	Gegenereerd beeldmateriaal dat begint met een afbeelding: de ref_image_url van de scène of je productfoto.
s2v	Een presentator die tegen de camera praat. Heeft een gezicht nodig.
walk_talk	Een presentator die loopt en praat. Heeft een gezicht nodig.
footage	Je eigen clip uit video_url, afgespeeld zoals het is.

Elke scène neemt een prompt (wat de camera ziet, of de tekst op het scherm voor motion) en een optionele script (de zin van de verteller). De volledige lijst met scènevelden staat in de referentie.

Tip

Gegenereerd beeldmateriaal is slecht in leesbare tekst. Zet schermen, prijzen, stappen en slogans in motion scenes en bewaar t2v_fast voor de echte wereld.

Merk

Een API render pikt nooit een merk op zichzelf, zelfs niet als je account merkkits bevat. Je kiest het merk bij elk verzoek:

• brand_logo_url: je logo, als een openbare https URL of een data-URI.
• brand_colors: optioneel, tot 12 hexkleuren, zoals ["#3B2416", "#F4E9DC"].

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

Zonder logo wordt de video weergegeven zonder logo en zonder eindkaart. Om dat expliciet te zeggen, stuur brand_enabled: false.

Merkkits

brand_kit_id noemt een van je opgeslagen merkkits. Stuur het voorlopig samen met brand_logo_url. Een brand_kit_id op zichzelf wordt geweigerd met 422 BRAND_REQUIRED. Een kit die bij een ander account hoort, wordt nooit gebruikt.

Productfoto

product_image_url is een foto van je product (een openbare https URL of een data-URI). Het houdt het product in elke scène hetzelfde, in plaats van het model er zelf een te laten bedenken.

Sommige formaten verkopen een product en hebben een foto nodig. Als je zo’n route instelt (bijvoorbeeld product-ad, unboxing ugc-ad of app-demo) en het plan toont het product, wordt een rendering zonder foto geweigerd met 400 PRODUCT_IMAGE_REQUIRED. Om expres zonder foto te renderen, stuur product_enabled: false.

Presentator

s2v en walk_talk scènes tonen een persoon die praat. Ze hebben een gezicht nodig: avatar_preset_id voor de hele video, of ref_image_url op de scène. Een plan met een pratende scène zonder gezicht wordt geweigerd met 400 PRESENTER_REQUIRED. Om Reigniter een stockpresentator te laten gebruiken, stuur presenter_enabled: false.

Niets om de video te ankeren

Wanneer je een route instelt en geen merk, geen productfoto en geen presentator stuurt, en het plan genereert al zijn foto’s, wordt de rendering met 422 NO_ANCHOR geweigerd. Zonder een anker bedenkt het model het product en de mensen, en die zullen niet bij jouw merk passen.

Voeg er één van de drie toe, of stuur product_enabled: false of presenter_enabled: false toch naar rendering.

Briefings worden gepland vóór deze controles

Bij een brief vindt de planning eerst plaats en wordt deze in rekening gebracht. Als de geplande render vervolgens wordt geweigerd door een van de bovenstaande controles, worden de planningscredits niet terugbetaald. Stuur het merk, de productfoto of presentator met de opdracht, zodat de check de eerste keer wordt goedgekeurd.

Uiterlijk en geluid

Veld	Waarden	Standaard
aspect	9:16, 16:9, 1:1, 4:5, 4:3, 3:4	9:16
quality	draft, standard, premium	draft
language	een taalcode, zoals 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	ingesteld door het formaat
voice_preset_id	een verteller stem-ID	een standaardstem
upscale	true of false	Bepaald door het formaat en de kwaliteit

Hogere quality en upscale kosten meer credits en duren langer.

Trainingsvideo’s

Stel kind: "training" in met een brief om een trainingsvideo te plannen in plaats van een advertentie. De planner schrijft stappen en een samenvatting en gebruikt motion taferelen voor instructies op het scherm.

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

Herpogingen en idempotentie

Stuur bij elke rendering een Idempotency-Key header met een unieke waarde, zoals een UUID. Als je verzoek verloopt en je probeert het opnieuw met dezelfde sleutel, weigert Reigniter de herhaling en wordt er geen tweede keer weergegeven of geladen.

• De herhaling wordt geweigerd, dus het geeft niet de originele job_id terug. Sla de job_id op van het eerste antwoord wanneer je er een krijgt.
• Met een scene_plan, geeft de herhaling 409 DUPLICATE_REQUEST.
• Met een brief, kan de herhaling 402 teruggeven met de boodschap This request was already submitted. Behandel het hetzelfde als een 409.
• Gebruik een nieuwe sleutel voor elke nieuwe video. Het hergebruiken van een sleutel voor een andere video weigert die video.

Zonder de header is elke oproep een nieuwe render en een nieuwe lading.

Watermerken

De renderrespons heeft een watermarked veld. Video’s gemaakt op het Agency plan zijn niet gewatermerkt.

Output

Wanneer de klus slaagt, video_url op GET /v1/job/{id} is een directe link naar de MP4. Download het en bewaar je eigen exemplaar.