Tworzenie filmów

Każdy film zaczyna się od jednego połączenia: POST /v1/render. Ta strona wyjaśnia wybory, które podejmujesz podczas tego połączenia. Dla każdego pola i jego ograniczeń zobacz odniesienie do renderowania Create.

Krótki plan lub plan sceny

Wyślij jeden z tych.

Krótki opis

brief to prosty opis wideo, do 4 000 znaków. Reigniter planuje sceny, pisze narrację i rozpoczyna renderowanie.

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

Dziedziny kształtujące plan:

Pole	Domyślność	Co robi
kind	ad	ad reklamę, training film szkoleniowy.
duration_sec	20 za ad, 60 za training	Całkowita długość celu: 5 do 120 sekund.
narrator	true	false nagrywa wideo bez lektora.
brand_name	Brak	Nazwa marki, którą powinien używać planist.
category	Brak	Kategoria produktu, na przykład coffee lub saas.
title	napisane dla ciebie	Tytuł filmu.

Planowanie wydaje kredyty. Jeśli planowanie się nie powiedzie, dostajesz 502 PLAN_FAILED i zwrot punktów za planowanie. Jeśli odesłasz plan_notes z powrotem do osoby, wyjaśnia ona wszystko, co planista zaznaczył w swoim planie.

Plan sceny

scene_plan to twoja własna lista od 1 do 12 scen, wyrenderowanych w kolejności, zgodnie z określonymi. Używaj jej, gdy już wiesz, co każda scena powinna pokazać i powiedzieć.

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

Typy scen:

type	Co renderuje
motion	Wyraźny animowany tekst, liczby, kroki lub logo. Używaj go do wszystkiego, co musi być czytelne.
t2v_fast	Wygenerowane nagrania ludzi, miejsc lub przedmiotów z prompt.
i2v_fast	Wygenerowane nagranie zaczynające się od obrazu: ref_image_url sceny lub zdjęcia produktu.
s2v	Prezenter rozmawiający do kamery. Potrzebuje twarzy.
walk_talk	Prelegent chodzący i mówiący. Potrzebuje twarzy.
footage	Twój własny fragment z video_url, pokazany tak, jak jest.

Każda scena wymaga prompt (to, co widzi kamera, lub kopia na ekranie dla motion) oraz opcjonalny script (kwestia narratora). Pełna lista pól scen znajduje się w referencji.

Wskazówka

Wygenerowane ujęcia są słabe w czytelnym tekście. Umieść ekrany, ceny, kroki i slogany w motion scenach, a t2v_fast zachowaj na rzeczywisty świat.

Marka

Render API nigdy nie wykrywa marki samodzielnie, nawet jeśli twoje konto ma zestawy marki. W każdym żądaniu wybierasz markę:

• brand_logo_url: Twoje logo, jako publiczny adres URL https lub adres URI danych.
• brand_colors: opcjonalnie, do 12 kolorów sześciokątnych, takich jak ["#3B2416", "#F4E9DC"].

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

Bez logo wideo jest wyświetlane bez logo i bez karty końcowej. Mówiąc wprost, wyślij brand_enabled: false.

Zestawy markowe

brand_kit_id wymienia jeden z Twoich zapisanych zestawów marki. Na razie wyślij go razem z brand_logo_url. Samodzielny brand_kit_id jest odrzucany z 422 BRAND_REQUIRED. Zestaw należący do innego konta nigdy nie jest używany.

Zdjęcie produktu

product_image_url jest zdjęcie Twojego produktu (publiczny adres URL https lub URI danych). Utrzymuje produkt taki sam w każdej scenie, zamiast pozwalać modelowi wymyślić własny.

Niektóre formaty sprzedają produkt i wymagają zdjęcia. Jeśli ustawisz taki route (np. product-ad, unboxing, ugc-ad lub app-demo) i plan pokazuje produkt, render bez zdjęcia jest odrzucany 400 PRODUCT_IMAGE_REQUIRED. Aby celowo renderować bez zdjęcia, wyślij product_enabled: false.

Prezenter

s2v i walk_talk sceny pokazują osobę mówiącą. Potrzebują twarzy: avatar_preset_id na cały film lub ref_image_url na scenie. Plan z sceną mówioną i bez twarzy jest odrzucany 400 PRESENTER_REQUIRED. Aby Reigniter użyć prezentera stockowego, wyślij presenter_enabled: false.

Nic, co mogłoby zakotwiczyć wideo

Gdy ustawiasz route i nie wysyłasz żadnej marki, zdjęcia produktu ani prezentera, a plan generuje wszystkie zdjęcia, render jest odrzucany 422 NO_ANCHOR. Bez kotwicy model wymyśla produkt i ludzi, którzy nie będą pasować do Twojej marki.

Dodaj jedną z tych trzech albo wyślij product_enabled: false lub presenter_enabled: false do renderowania mimo wszystko.

Przed tymi kontrolami planowane są przygotowania

W przypadku brief planowanie odbywa się najpierw i jest naliczane opłatą. Jeśli planowany render zostanie odrzucony przez jedną z powyższych weryfikacji, kredyty planistyczne nie są zwracane. Wyślij markę, zdjęcie produktu lub prezentera wraz z briefem, aby test przeszedł za pierwszym razem.

Wygląd i dźwięk

Pole	Wartości	Domyślność
aspect	9:16, 16:9, 1:1, 4:5, 4:3, 3:4	9:16
quality	draft, standard, premium	draft
language	kod językowy, taki jak 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	Ustalona przez format
voice_preset_id	Identyfikacja głosu narratora	domyślny głos
upscale	true czy false	Ustalane przez format i jakość

Wyższe quality i upscale kosztują więcej kredytów i zajmują więcej czasu.

Filmy szkoleniowe

Ustaw kind: "training" brief na zaplanowanie filmu szkoleniowego zamiast reklamy. Planista pisze kroki i podsumowanie, a motion sceny wykorzystuje do instrukcji na ekranie.

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

Próby powtórne i idempotencja

Wyślij nagłówek Idempotency-Key z unikalną wartością, na przykład UUID, przy każdym renderowaniu. Jeśli Twoje żądanie skończy się i spróbujesz ponownie tym samym kluczem, Reigniter odmawia powtórzenia i nie renderuje ani nie pobiera opłaty po raz drugi.

• Powtórzenie jest odrzucane, więc nie zwraca oryginalnego job_id. Zapisz job_id z pierwszej odpowiedzi, gdy tylko ją otrzymasz.
• Przy scene_plan, powtórzenie zwraca 409 DUPLICATE_REQUEST.
• Przy brief powtórzenie może zwrócić 402 z wiadomością This request was already submitted. Traktuj to tak samo jak 409.
• Używaj nowego klucza do każdego nowego filmu. Ponowne użycie klucza do innego filmu odmawia temu wideo.

Bez nagłówka każde wywołanie to nowy render i nowa opłata.

Znaki wodne

Render response ma pole watermarked. Filmy nagrane na Agency planie nie są oznaczone znakiem wodnym.

Produkcja

Gdy zadanie się powiedzie, video_url na GET /v1/job/{id} jest bezpośrednim linkiem do MP4. Pobierz go i zachowaj własną kopię.