Réalisation de vidéos

Chaque vidéo commence par un appel : POST /v1/render. Cette page explique les choix que vous faites lors de cet appel. Pour chaque champ et ses limites, consultez la référence Create render.

Brève ou plan de scène

Envoie un de ceux-ci.

Un bref mémoire

Un brief est une description en langage simple de la vidéo, jusqu’à 4 000 caractères. Reigniter planifie les scènes, écrit la narration et commence le rendu.

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

Champs qui façonnent le plan :

Terrain	Par défaut	Ce que ça fait
kind	ad	ad pour une publicité, training pour une vidéo de formation.
duration_sec	20 pour ad, 60 pour training	Longueur totale de la cible, de 5 à 120 secondes.
narrator	true	false fait une vidéo sans voix off.
brand_name	aucun	Le nom de marque que le planificateur doit utiliser.
category	aucun	La catégorie de produits, par exemple coffee ou saas.
title	écrit pour toi	Un titre pour la vidéo.

La planification dépense des crédits. Si la planification échoue, vous recevez 502 PLAN_FAILED et les crédits d’urbanisme sont remboursés. Si vous renvoyez plan_notes à une personne, elle explique tout ce que l’urbaniste a signalé dans son propre plan.

Un plan de scène

Un scene_plan est votre propre liste de 1 à 12 scènes, rendues dans l’ordre, selon les indications. Utilisez-la quand vous savez déjà ce que chaque scène doit montrer et dire.

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

Types de scènes :

type	Ce qu’il rend
motion	Texte animé net, chiffres, pas ou logo. Utilisez-les pour tout ce qui doit être lisible.
t2v_fast	Des images générées de personnes, de lieux ou d’objets, à partir de prompt.
i2v_fast	Des séquences générées qui commencent à partir d’une image : la ref_image_url de la scène, ou la photo de votre produit.
s2v	Un présentateur qui parle à la caméra. Il a besoin d’un visage.
walk_talk	Un présentateur qui marche et parle. Il a besoin d’un visage.
footage	Votre propre extrait de video_url, lu tel quel.

Chaque scène prend un prompt (ce que la caméra voit, ou la copie à l’écran pour motion) et un script optionnel (la réplique du narrateur). La liste complète des champs de scène se trouve dans la référence.

Astuce

Les images générées sont mauvaises en matière de lisibilité. Mettez des écrans, des prix, des étapes et des slogans dans motion scènes, et gardez t2v_fast pour le monde réel.

Marque

Un rendu API ne détecte jamais une marque seul, même si votre compte contient des kits de marque. Vous choisissez la marque dans chaque demande :

• brand_logo_url: votre logo, en tant qu’URL de https publique ou URI de données.
• brand_colors: optionnel, jusqu’à 12 couleurs hexagonales, comme ["#3B2416", "#F4E9DC"].

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

Sans logo, la vidéo s’affiche sans logo ni carte de fin. Pour le dire explicitement, envoyez brand_enabled: false.

Kits de marque

brand_kit_id nomme l’un de vos kits de marque sauvegardés. Pour l’instant, envoyez-le avec brand_logo_url. Un brand_kit_id seul est refusé avec 422 BRAND_REQUIRED. Un kit appartenant à un autre compte n’est jamais utilisé.

Photo du produit

product_image_url est une photo de votre produit (une URL https publique ou un URI de données). Cela garde le produit identique dans chaque scène, au lieu de laisser le modèle en inventer un.

Certains formats vendent un produit et ont besoin d’une photo. Si vous définissez un tel route (par exemple product-ad, unboxing, ugc-ad ou app-demo) et que le plan montre le produit, un rendu sans photo est refusé avec 400 PRODUCT_IMAGE_REQUIRED. Pour rendre sans photo volontairement, envoyez product_enabled: false.

Présentateur

s2v et walk_talk scènes montrent une personne en train de parler. Ils ont besoin d’un visage : avatar_preset_id pour toute la vidéo, ou ref_image_url sur la scène. Un plan avec une scène parlante et sans visage est refusé avec 400 PRESENTER_REQUIRED. Pour Reigniter permettre d’utiliser un présentateur de stock, envoyez presenter_enabled: false.

Rien pour ancrer la vidéo

Quand vous définissez un route sans marque, sans photo produit, sans présentateur, et que le plan générerait toutes ses photos, le rendu est refusé avec 422 NO_ANCHOR. Sans ancre, le modèle invente le produit et les personnes, et ils ne correspondront pas à votre marque.

Ajoute l’un des trois, ou envoie product_enabled: false ou presenter_enabled: false pour rendre quand même.

Les briefs sont prévus avant ces vérifications

Avec un brief, la planification a lieu en premier et est facturée. Si le rendu prévu est ensuite refusé par l’un des chèques ci-dessus, les crédits de planification ne sont pas remboursés. Envoyez la marque, la photo du produit ou le présentateur avec le brief, afin que le chèque soit validé du premier coup.

Apparence et son

Terrain	Valeurs	Par défaut
aspect	9:16, 16:9, 1:1, 4:5, 4:3, 3:4	9:16
quality	draft, standard, premium	draft
language	un code de langage, tel que 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	Défini par le format
voice_preset_id	une identification vocale du narrateur	une voix par défaut
upscale	true ou false	Défini par le format et la qualité

Des quality et upscale plus élevées coûtent plus de crédits et prennent plus de temps.

Vidéos d’entraînement

Configurez kind: "training" avec un brief pour planifier une vidéo de formation au lieu d’une publicité. Le planificateur écrit les étapes et un résumé, et utilise motion scènes pour les instructions à l’écran.

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

Réessais et idempotence

Envoyez un en-tête Idempotency-Key avec une valeur unique, comme un UUID, sur chaque rendu. Si votre requête expire et que vous réessayez avec la même clé, Reigniter refuse la répétition et ne se rend ni ne facture une seconde fois.

• La répétition est refusée, donc elle ne retourne pas la job_id originale. Sauvegardez la job_id de la première réponse chaque fois que vous en recevrez une.
• Avec un scene_plan, la répétition retourne 409 DUPLICATE_REQUEST.
• Avec un brief, la répétition peut renvoyer 402 avec le message This request was already submitted. Traitez-le comme un 409.
• Utilisez une nouvelle clé pour chaque nouvelle vidéo. Réutiliser une clé pour une autre vidéo refuse cette vidéo.

Sans l’en-tête, chaque appel est un nouveau rendu et une nouvelle charge.

Filigranes

La réponse de rendu comporte un champ watermarked. Les vidéos réalisées sur le plan Agency ne sont pas filigranées.

Production

Quand le travail réussit, video_url sur GET /v1/job/{id} est un lien direct vers le MP4. Téléchargez-le et conservez votre propre copie.