Videos machen

Jedes Video beginnt mit einem Aufruf: POST /v1/render. Diese Seite erklärt die Entscheidungen, die Sie in diesem Aufruf treffen. Für jedes Feld und seine Grenzen siehe die Referenz Create render.

Kurzfassung oder Szenenplan

Schick so eins.

Eine Kurzfassung

Ein brief ist eine einfache Beschreibung des Videos mit bis zu 4.000 Zeichen. Reigniter plant die Szenen, schreibt die Erzählung und beginnt mit dem Rendering.

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

Felder, die den Plan formen:

Spielfeld	Default	Was es bewirkt
kind	ad	ad für eine Anzeige, training für ein Schulungsvideo.
duration_sec	20 für ad, 60 für training	Ziellänge 5 bis 120 Sekunden.
narrator	true	false macht ein Video ohne Voice-over.
brand_name	Keine	Der Markenname, den der Planer verwenden sollte.
category	Keine	Die Produktkategorie, zum Beispiel coffee oder saas.
title	für dich geschrieben	Ein Titel für das Video.

Planung gibt Credits aus. Wenn die Planung scheitert, bekommst du 502 PLAN_FAILED und die Planungsgutschriften werden zurückerstattet. Wenn du plan_notes an eine Person zurückschickst, erklärt sie alles, was der Planer in seinem eigenen Plan markiert hat.

Ein Szenenplan

Ein scene_plan ist deine eigene Liste von 1 bis 12 Szenen, gerendert in der angegebenen Reihenfolge. Nutze es, wenn du schon weißt, was jede Szene zeigen und sagen soll.

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

Szenentypen:

type	Was es rendert
motion	Klarer animierter Text, Zahlen, Schritte oder ein Logo. Nutze es für alles, was lesbar sein muss.
t2v_fast	Generierte Aufnahmen von Menschen, Orten oder Objekten aus prompt.
i2v_fast	Generiertes Material, das mit einem Bild beginnt: dem ref_image_url der Szene oder Ihrem Produktfoto.
s2v	Ein Moderator, der mit der Kamera spricht. Braucht ein Gesicht.
walk_talk	Ein Moderator, der läuft und spricht. Braucht ein Gesicht.
footage	Dein eigener Clip von video_url, so abgespielt, wie er ist.

Jede Szene nimmt einen prompt (was die Kamera sieht, oder die Bildschirmkopie für motion) und eine optionale script (die Zeile des Erzählers). Die vollständige Liste der Szenenfelder ist in der Referenz enthalten.

Tipp

Generiertes Filmmaterial ist schlecht lesbaren Text. Setze Bildschirme, Preise, Schritte und Slogans in motion Szenen und behalte t2v_fast für die reale Welt.

Marke

Ein API Render erkennt nie eine Marke von selbst, selbst wenn dein Account Markenkits enthält. Du wählst die Marke bei jeder Anfrage aus:

• brand_logo_url: Ihr Logo, als öffentliche https-URL oder Daten-URI.
• brand_colors: optional, bis zu 12 Hex-Farben, wie ["#3B2416", "#F4E9DC"].

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

Ohne Logo wird das Video ohne Logo und ohne Endkarte gerendert. Um das explizit zu sagen: Senden Sie brand_enabled: false.

Markenbausätze

brand_kit_id nennt eines deiner gespeicherten Markenkits. Für den Moment schicke es zusammen mit brand_logo_url. Ein brand_kit_id allein wird mit 422 BRAND_REQUIRED abgelehnt. Ein Kit, das einem anderen Konto gehört, wird nie verwendet.

Produktfoto

product_image_url ist ein Foto Ihres Produkts (eine öffentliche https-URL oder eine Daten-URI). Es behält das Produkt in jeder Szene gleich, anstatt das Modell eines erfinden zu lassen.

Manche Formate verkaufen ein Produkt und benötigen ein Foto. Wenn Sie ein solches route setzen (zum Beispiel product-ad, unboxing, ugc-ad oder app-demo) und der Plan das Produkt zeigt, wird ein Rendering ohne Foto mit 400 PRODUCT_IMAGE_REQUIRED abgelehnt. Um absichtlich ohne Foto zu rendern, senden Sie product_enabled: false.

Moderator

s2v und walk_talk Szenen zeigen eine Person, die spricht. Sie brauchen ein Gesicht: avatar_preset_id für das ganze Video oder ref_image_url auf der Szene. Ein Plan mit einer sprechenden Szene ohne Gesicht wird mit 400 PRESENTER_REQUIRED abgelehnt. Damit Reigniter einen Stock-Moderator verwenden kann, schicken Sie presenter_enabled: false.

Nichts, was das Video verankert

Wenn Sie eine route setzen und keine Marke, kein Produktfoto und keinen Moderator senden und der Plan alle seine Bilder generiert, wird das Rendering mit 422 NO_ANCHOR abgelehnt. Ohne Anker erfindet das Model das Produkt und die Menschen, und sie passen nicht zu Ihrer Marke.

Füge eines der drei hinzu oder schicke product_enabled: false oder presenter_enabled: false trotzdem zum Rendern.

Briefings werden vor diesen Prüfungen geplant

Bei einem brief erfolgt zuerst die Planung und wird berechnet. Wenn der geplante Render dann von einer der oben genannten Schecks abgelehnt wird, werden die Planungsgutschriften nicht zurückerstattet. Schick die Marke, das Produktfoto oder den Präsentierenden mit dem Briefing, damit die Überprüfung beim ersten Mal besteht.

Aussehen und Klang

Spielfeld	Werte	Default
aspect	9:16, 16:9, 1:1, 4:5, 4:3, 3:4	9:16
quality	draft, standard, premium	draft
language	Ein Sprachcode wie 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	Gesetzt durch das Format
voice_preset_id	eine Erzähler-Stimm-ID	eine Standardstimme
upscale	true oder false	Festgelegt durch Format und Qualität

Höhere quality und upscale mehr Credits kosten und dauern länger.

Trainingsvideos

Setze kind: "training" mit einem brief ein, ein Schulungsvideo statt einer Werbung zu planen. Der Planer schreibt Schritte und eine Zusammenfassung und verwendet motion Szenen für Anweisungen auf dem Bildschirm.

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

Wiederversuche und Idempotenz

Senden Sie bei jedem Rendern einen Idempotency-Key-Header mit einem eindeutigen Wert, wie zum Beispiel einer UUID. Wenn Ihre Anfrage abläuft und Sie es mit demselben Schlüssel erneut versuchen, lehnt Reigniter die Wiederholung ab und rendert oder berechnet kein zweites Mal.

• Die Wiederholung wird abgelehnt, daher wird das ursprüngliche job_id nicht zurückgegeben. Speichern Sie die job_id von der ersten Antwort, wann immer Sie eine erhalten.
• Mit einem scene_plan, ergibt die Wiederholung 409 DUPLICATE_REQUEST.
• Mit einem brief, kann die Wiederholung 402 mit der Nachricht This request was already submitted zurückgeben. Behandle es wie ein 409.
• Verwenden Sie für jedes neue Video einen neuen Schlüssel. Die Wiederverwendung eines Schlüssels für ein anderes Video verhindert dieses Video.

Ohne den Header ist jeder Anruf ein neuer Render und eine neue Ladung.

Wasserzeichen

Die Render-Antwort hat ein watermarked Feld. Auf dem Agency Plan erstellten Videos sind nicht wassermarkiert.

Ausgabe

Wenn der Auftrag erfolgreich ist, video_url auf GET /v1/job/{id} ist ein direkter Link zum MP4. Lade ihn herunter und bewahre deine eigene Kopie auf.