Outils de production
Images, vidéos, voix off et scripts : devis et confirmation, toutes les recettes, bibliothèque, adaptation aux formats, qualité diffusion, liens de relecture et personnages.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture9 outils
list_productions
Lecture0 créditsBibliothèque de production : images, vidéos, voix off et scripts (générés, importés, adaptés aux formats) avec statut, adresse du fichier une fois prêt, accroche et appel à l'action, raison de l'attente, temps restant d'une tâche en cours, possibilité de relancer une tâche échouée, favori, recette, groupe de variantes et comparaison, décision de relecture et nombre de commentaires, et résultat de la campagne en cas d'usage publicitaire. Filtres par statut, type, texte, favoris ou groupe ; paginé. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
production_idFacultatif | string | one production with its full details (script, review, results) |
statusFacultatif | queued | rendering | ready | needs_provider | failed | cancelled | draft | — |
kindFacultatif | ugc_video | short_video | image | voice | script | — |
searchFacultatif | string | text in the title or request |
favoriteFacultatif | boolean | only starred productions |
group_idFacultatif | string | one variation group (batch.group of an item) |
limitFacultatif | integer (1–60) | newest first (default 10) |
offsetFacultatif | integer (0–…) | next_offset of the previous page |
get_production_options
Lecture0 créditsOptions de l'écran Production : types et recettes ouverts, moteur et prix de chaque type par niveau de qualité (crédits du forfait ou solde en USD), mode de facturation et reste, résolutions, formats, styles et langues ; topic=characters personnages enregistrés, topic=videos vidéos doublables, topic=formats formats d'emplacements publicitaires. À appeler avant un devis plutôt que de deviner les prix. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
topicFacultatif | overview | characters | videos | formats | — |
platformFacultatif | string | topic=formats: meta | google | tiktok | linkedin | … |
typeFacultatif | image | video | topic=formats |
get_production_quote
Lecture0 créditsLit un devis de production : statut (ouvert, validé, expiré, annulé), prix, ce qu'il produira, validité et la production lancée. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
quote_idObligatoire | string | — |
production_preflight
Lecture0 créditsContrôle avant diffusion d'un fichier prêt : sans cible, il liste les emplacements et profils de diffusion ; avec format_id ou profile, il mesure le fichier lui-même (format, résolution, durée, poids, son et loudness, sous-titres et zone sûre, appel à l'action, ouverture, mention IA) et renvoie réussi / attention / échec. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | production id (from list_productions or quote/start results) |
format_idFacultatif | integer (1–…) | ad placement to check against |
profileFacultatif | tv_pal | tv_ntsc | ctv | broadcast profile to check against |
get_production_masters
Lecture0 créditsCopies master en qualité diffusion d'une vidéo prête : profils disponibles (TV PAL 1080p25 −23 LUFS, TV NTSC 1080p29,97 −24 LKFS, TV connectée), codecs, durées autorisées, mesures de la source et copies réalisées avec leurs rapports techniques. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | ready video |
get_production_film
Lecture0 créditsScènes d'un film de marque (clips enregistrés), options de montage et informations de version. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | brand film |
get_production_share
Lecture0 créditsÉtat de relecture d'une production : son dernier lien de relecture (expiration, portée), la décision des relecteurs (en attente, approuvé, modifications demandées) et leurs commentaires. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | production id (from list_productions or quote/start results) |
get_production_wallet
Lecture0 créditsMode de facturation de la production (crédits du forfait ou solde en USD), crédits restants, solde de production avec montant réservé et limite mensuelle, dépenses du mois et mouvements du solde (paginés). Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
ledger_limitFacultatif | integer (1–200) | — |
beforeFacultatif | integer (1–…) | next_before of the previous page |
get_production_download
Lecture0 créditsAdresse de téléchargement d'un fichier prêt. Sans format : l'adresse du fichier original ; avec format (images uniquement) : une copie PNG / JPG / WEBP à une adresse signée qui expire en quelques minutes. Lecture seule, gratuit.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | ready production |
formatFacultatif | png | jpg | webp | images: converted copy in this type |
Outils d'écriture19 outils
suggest_production_hooks
Écriture1 crédits5 à 8 suggestions de phrase d'accroche (hook) pour les premières secondes d'une vidéo ou le titre d'une image, à partir du profil de marque et de la demande ; sans modèle de texte, des modèles fondés sur des règles, jamais d'affirmations inventées. Passez la phrase choisie à quote_production hook (hooks avec des variantes). Ne produit rien.
| Paramètre | Type | Description |
|---|---|---|
kindObligatoire | ugc_video | short_video | image | — |
briefObligatoire | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
quote_production
Écriture0 créditsÉtape 1 d'une production : un DEVIS pour tout ce que fait l'écran Production — image, vidéo courte / UGC, voix off, script et toutes les recettes (photo produit, retouche, persona, influenceur IA, avatar IA, film de marque, scène unique, doublage, pack de campagne), avec niveau de qualité, format, résolution, fichier source, personnage, accroche et 2 à 4 variantes. Renvoie ce qui sera produit, le prix (crédits du forfait ou solde en USD ; le même prix que dans le tableau de bord) et sa validité. RIEN n'est produit ni facturé ici : montrez le prix à l'utilisateur, attendez sa confirmation explicite, puis appelez start_production avec l'identifiant du devis.
| Paramètre | Type | Description |
|---|---|---|
kindFacultatif | ugc_video | short_video | image | voice | script | what is produced (with like_production_id it may be omitted) |
briefFacultatif | string | what to produce: product / service, message, audience, style; for recipe=edit the change to make |
titleFacultatif | string | — |
recipeFacultatif | product | edit | persona | influencer | avatar | film | scene | dubbing | pack | ready-made flow: product = from a product photo (reference_id, style); edit = new version of a ready file (reference_id, brief = the change); persona = AI portrait to save as a character (kind=image); influencer = with a saved VIRTUAL character (character_id); avatar = with a consented REAL person's character (character_id); film = multi-scene brand film (kind=short_video, scenes, captions, end_card); scene = regenerate one scene of a ready film (reference_id = film, scene = number; only that scene is charged); dubbing = ready video in another language (reference_id, language); pack = campaign content pack (kind=image, formats, video) |
tierFacultatif | string | quality tier (economy / balanced / premium) or, for videos, a named video engine such as bytedance/seedance-2.0 (see the catalog: tiers with engine_name); changes the price (default: the route's model) |
resolutionFacultatif | 1K | 2K | 4K | images only |
aspectFacultatif | 1:1 | 4:5 | 3:4 | 2:3 | 9:16 | 16:9 | 3:2 | 4:3 | images: all; videos: 9:16 / 16:9 |
styleFacultatif | studio | lifestyle | outdoor | flatlay | hand | recipe=product: scene preset |
reference_idFacultatif | string | production id of the source file (product photo, file to edit, video to dub, film) |
character_idFacultatif | string | recipe=influencer / avatar: character id (get_production_options topic=characters) |
scenesFacultatif | integer (0–12) | film: scene count (0 = default) |
captionsFacultatif | boolean | film: on-screen captions (default true) |
end_cardFacultatif | boolean | film: closing card with logo (default true) |
sceneFacultatif | integer (0–12) | recipe=scene: number of the scene to regenerate (from 1) |
languageFacultatif | tr | en | de | es | fr | nl | pt | zh | pl | ja | ar | hi | it | ru | ko | bn | ur | id | vi | th | he | recipe=dubbing: target language |
formatsFacultatif | array<integer> | recipe=pack: ad format ids (get_production_options topic=formats) |
videoFacultatif | boolean | recipe=pack: also a short video from the main image |
hookFacultatif | string | opening line (suggest_production_hooks); recipe=scene + scene=1 changes only the film's opening |
angleFacultatif | problem | moment | detail | direct | creative angle (ignored with variations: each variation gets its own) |
variationsFacultatif | integer (2–4) | batch: N separate productions from one request, each with another angle; the TOTAL price is returned |
hooksFacultatif | array<string> | with variations: opening lines given to the variations in order |
campaign_idFacultatif | string | campaign id or name to link the production to |
like_production_idFacultatif | string | "more like this": copy the settings (kind, brief, recipe, character, tier, style, aspect, hook, angle) of this production; given arguments override them |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
start_production
ÉcritureIrréversible0 créditsÉtape 2 : lance la production d'un devis que l'utilisateur a CONFIRMÉ après avoir vu son prix. Le montant est réservé sur le solde ou les crédits du forfait sont utilisés (comme « Confirmer et produire » dans le tableau de bord) ; si les crédits ou le solde ne suffisent pas, rien ne démarre (credits_exhausted / insufficient_balance avec le montant nécessaire). À n'appeler que si l'utilisateur demande explicitement de continuer. Un même devis ne démarre jamais deux fois. Renvoie la production (en file / en cours / prête) ; les fichiers prennent quelques minutes, vérifiez avec list_productions.
| Paramètre | Type | Description |
|---|---|---|
quote_idFacultatif | string | — |
quote_idsFacultatif | array<string> | all quotes of one variation group, started with one confirmation |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
cancel_production
Écriture0 créditsAnnule une production en file d'attente qui n'a pas encore atteint le fournisseur ; le montant réservé est restitué. Un fichier déjà en cours chez le fournisseur ne peut pas être arrêté (erreur rendering).
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | production id (from list_productions or quote/start results) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
retry_production
Écriture0 créditsPour une production échouée ou annulée : un NOUVEAU devis avec les mêmes réglages au prix du jour. Ne facture rien ; lancez-le avec start_production après la confirmation du prix par l'utilisateur.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | production id (from list_productions or quote/start results) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_production
ÉcritureIrréversible0 créditsSupprime définitivement des productions et leurs fichiers (avec leurs versions de format). Irréversible — uniquement si l'utilisateur demande explicitement la suppression de ces fichiers. Un fichier utilisé dans une campagne (in_use) ou encore en production (active) n'est pas supprimé ; le résultat les détaille un par un.
| Paramètre | Type | Description |
|---|---|---|
production_idFacultatif | string | production id (from list_productions or quote/start results) |
production_idsFacultatif | array<string> | several productions at once (up to 24) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_production_favorite
Écriture0 créditsAjoute ou retire l'étoile d'une production (filtre des favoris de list_productions et du tableau de bord).
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | production id (from list_productions or quote/start results) |
favoriteObligatoire | boolean | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
import_production_from_url
Écriture1 créditsPartir d'une page produit : le serveur lit la page en toute sécurité (http(s) uniquement, réseau interne fermé, redirections revérifiées, taille limitée) et renvoie le titre, la description et le prix ; l'image principale est enregistrée dans la bibliothèque comme photo produit. L'utilisateur doit confirmer ses droits sur le contenu (confirm_rights=true) ; la confirmation est enregistrée. Utilisez l'image comme reference_id dans quote_production. 1 crédit.
| Paramètre | Type | Description |
|---|---|---|
urlObligatoire | string | public product page (http / https) |
confirm_rightsObligatoire | boolean | the user confirmed they may use the page's text and image |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_production_image
Écriture1 créditsAjoute une image de l'utilisateur à la bibliothèque de production : le type est vérifié à partir des octets, l'image est réencodée et les données de localisation (EXIF) supprimées ; PNG, JPEG ou WEBP jusqu'à 12 Mo. Depuis une adresse, seules les adresses publiques sont lues (les internes sont refusées). À utiliser comme reference_id ou avec adapt_production_formats. 1 crédit.
| Paramètre | Type | Description |
|---|---|---|
image_base64Facultatif | string | PNG / JPEG / WEBP, optionally a data: URL |
source_urlFacultatif | string | public http(s) image address to copy instead |
titleFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
adapt_production_formats
Écriture0 créditsAdapte une image prête aux formats des emplacements publicitaires choisis (jusqu'à 12) ; titre, appel à l'action et logo restent dans la zone sûre. Chaque version devient un fichier de la bibliothèque. Gratuit, sur notre propre serveur.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | ready image to adapt |
formatsObligatoire | array<integer> | ad format ids (get_production_options topic=formats) |
headlineFacultatif | string | — |
ctaFacultatif | string | — |
logoFacultatif | boolean | brand logo in the safe area (default true) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_production_master
Écriture0 créditsDemande une copie master de diffusion d'une vidéo prête avec rapport technique (encodée sur notre serveur, gratuite, débit limité). Préparation technique uniquement : l'acceptation par un diffuseur n'est pas garantie ; l'entrelacé et le XDCAM MXF ne sont pas produits.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | ready video |
profileObligatoire | tv_pal | tv_ntsc | ctv | — |
codecObligatoire | prores | h264 | prores = ProRes 422 HQ .mov · h264 = H.264 High .mp4 |
secondsFacultatif | integer (0–60) | exact spot length (0 = the source's length) |
pillarboxFacultatif | boolean | fit a vertical / square source into 16:9 with black side bars |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_production_master
ÉcritureIrréversible0 créditsSupprime définitivement une copie master et son fichier. Irréversible — uniquement si l'utilisateur le demande explicitement.
| Paramètre | Type | Description |
|---|---|---|
master_idObligatoire | string | master copy id (get_production_masters) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
edit_production_film
Écriture0 créditsRemonte un film de marque : ordre des scènes, sous-titres, carte de fin. Gratuit, sur notre serveur ; crée une nouvelle version et conserve l'ancienne. Régénérer une seule scène est payant et passe par quote_production recipe=scene.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | brand film |
orderFacultatif | array<integer> | new scene order: every scene number once |
captionsFacultatif | boolean | — |
end_cardFacultatif | boolean | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_production_share
Écriture0 créditsCrée un lien de relecture temporaire (1 à 90 jours) que clients ou équipe ouvrent sans compte : ils commentent, approuvent ou demandent des modifications. L'adresse n'est renvoyée qu'une fois ; les liens précédents de la production sont fermés.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | ready image or video |
daysFacultatif | integer (1–90) | link lifetime in days (default 14) |
scopeFacultatif | single | group | single = this production · group = its whole variation group |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
revoke_production_share
ÉcritureIrréversible0 créditsFerme d'un coup tous les liens de relecture ouverts d'une production ; un lien fermé ne peut pas être rouvert (en créer un nouveau). Uniquement si l'utilisateur le demande explicitement.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | production id (from list_productions or quote/start results) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_production_character
Écriture0 créditsEnregistre une image de visage prête comme personnage pour un contenu cohérent. type=virtual : un influenceur IA. type=real : l'avatar IA d'une personne réelle — uniquement avec la déclaration de consentement que l'UTILISATEUR donne avec ses propres mots (nom de la personne, fondement : soi-même ou accord écrit, confirmed=true) ; jamais remplie à la place de l'utilisateur. La déclaration est enregistrée avec le compte et l'heure.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
typeObligatoire | virtual | real | virtual = AI influencer · real = a real person (AI avatar) |
image_idObligatoire | string | ready face image in the library (generated portrait or uploaded photo) |
descriptionFacultatif | string | — |
consentFacultatif | object | required for type=real |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_production_character
ÉcritureIrréversible0 créditsSupprime un personnage (pour une personne réelle, retrait du consentement). Irréversible — uniquement si l'utilisateur le demande explicitement ; les fichiers produits restent.
| Paramètre | Type | Description |
|---|---|---|
character_idObligatoire | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_production_monthly_limit
Écriture0 créditsDéfinit ou supprime la limite de dépense mensuelle du solde de production (USD). Les productions qui la dépasseraient sont refusées (monthly_limit). Uniquement à la demande de l'utilisateur.
| Paramètre | Type | Description |
|---|---|---|
monthly_limitFacultatif | number (0–1000000) | USD per month |
clearFacultatif | boolean | remove the limit |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_production_to_campaign
Écriture0 créditsFait d'une production la création d'une campagne (carte de création en brouillon). Sur Meta et Google, le fichier est utilisé à la publication de la campagne ; une annonce en cours ne change pas d'elle-même. La carte de production affiche ensuite les résultats de la campagne.
| Paramètre | Type | Description |
|---|---|---|
production_idObligatoire | string | ready file (or a script for a text card) |
campaignObligatoire | string | campaign id or name |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.