Aller au contenu
Tecrübetecrube.com
Outils de l'assistant · Commerce local et contenu

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édits

Bibliothè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ètreTypeDescription
production_idFacultatifstringone production with its full details (script, review, results)
statusFacultatifqueued | rendering | ready | needs_provider | failed | cancelled | draft—
kindFacultatifugc_video | short_video | image | voice | script—
searchFacultatifstringtext in the title or request
favoriteFacultatifbooleanonly starred productions
group_idFacultatifstringone variation group (batch.group of an item)
limitFacultatifinteger (1–60)newest first (default 10)
offsetFacultatifinteger (0–…)next_offset of the previous page

get_production_options

Lecture0 crédits

Options 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ètreTypeDescription
topicFacultatifoverview | characters | videos | formats—
platformFacultatifstringtopic=formats: meta | google | tiktok | linkedin | …
typeFacultatifimage | videotopic=formats

get_production_quote

Lecture0 crédits

Lit un devis de production : statut (ouvert, validé, expiré, annulé), prix, ce qu'il produira, validité et la production lancée. Lecture seule, gratuit.

ParamètreTypeDescription
quote_idObligatoirestring—

production_preflight

Lecture0 crédits

Contrô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ètreTypeDescription
production_idObligatoirestringproduction id (from list_productions or quote/start results)
format_idFacultatifinteger (1–…)ad placement to check against
profileFacultatiftv_pal | tv_ntsc | ctvbroadcast profile to check against

get_production_masters

Lecture0 crédits

Copies 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ètreTypeDescription
production_idObligatoirestringready video

get_production_film

Lecture0 crédits

Scènes d'un film de marque (clips enregistrés), options de montage et informations de version. Lecture seule, gratuit.

ParamètreTypeDescription
production_idObligatoirestringbrand 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ètreTypeDescription
production_idObligatoirestringproduction id (from list_productions or quote/start results)

get_production_wallet

Lecture0 crédits

Mode 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ètreTypeDescription
ledger_limitFacultatifinteger (1–200)—
beforeFacultatifinteger (1–…)next_before of the previous page

get_production_download

Lecture0 crédits

Adresse 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ètreTypeDescription
production_idObligatoirestringready production
formatFacultatifpng | jpg | webpimages: converted copy in this type

Outils d'écriture19 outils

suggest_production_hooks

Écriture1 crédits

5 à 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ètreTypeDescription
kindObligatoireugc_video | short_video | image—
briefObligatoirestring—

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ètreTypeDescription
kindFacultatifugc_video | short_video | image | voice | scriptwhat is produced (with like_production_id it may be omitted)
briefFacultatifstringwhat to produce: product / service, message, audience, style; for recipe=edit the change to make
titleFacultatifstring—
recipeFacultatifproduct | edit | persona | influencer | avatar | film | scene | dubbing | packready-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)
tierFacultatifstringquality 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)
resolutionFacultatif1K | 2K | 4Kimages only
aspectFacultatif1:1 | 4:5 | 3:4 | 2:3 | 9:16 | 16:9 | 3:2 | 4:3images: all; videos: 9:16 / 16:9
styleFacultatifstudio | lifestyle | outdoor | flatlay | handrecipe=product: scene preset
reference_idFacultatifstringproduction id of the source file (product photo, file to edit, video to dub, film)
character_idFacultatifstringrecipe=influencer / avatar: character id (get_production_options topic=characters)
scenesFacultatifinteger (0–12)film: scene count (0 = default)
captionsFacultatifbooleanfilm: on-screen captions (default true)
end_cardFacultatifbooleanfilm: closing card with logo (default true)
sceneFacultatifinteger (0–12)recipe=scene: number of the scene to regenerate (from 1)
languageFacultatiftr | en | de | es | fr | nl | pt | zh | pl | ja | ar | hi | it | ru | ko | bn | ur | id | vi | th | herecipe=dubbing: target language
formatsFacultatifarray<integer>recipe=pack: ad format ids (get_production_options topic=formats)
videoFacultatifbooleanrecipe=pack: also a short video from the main image
hookFacultatifstringopening line (suggest_production_hooks); recipe=scene + scene=1 changes only the film's opening
angleFacultatifproblem | moment | detail | directcreative angle (ignored with variations: each variation gets its own)
variationsFacultatifinteger (2–4)batch: N separate productions from one request, each with another angle; the TOTAL price is returned
hooksFacultatifarray<string>with variations: opening lines given to the variations in order
campaign_idFacultatifstringcampaign id or name to link the production to
like_production_idFacultatifstring"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ètreTypeDescription
quote_idFacultatifstring—
quote_idsFacultatifarray<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édits

Annule 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ètreTypeDescription
production_idObligatoirestringproduction 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édits

Pour 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ètreTypeDescription
production_idObligatoirestringproduction 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édits

Supprime 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ètreTypeDescription
production_idFacultatifstringproduction id (from list_productions or quote/start results)
production_idsFacultatifarray<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édits

Ajoute ou retire l'étoile d'une production (filtre des favoris de list_productions et du tableau de bord).

ParamètreTypeDescription
production_idObligatoirestringproduction id (from list_productions or quote/start results)
favoriteObligatoireboolean—

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édits

Partir 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ètreTypeDescription
urlObligatoirestringpublic product page (http / https)
confirm_rightsObligatoirebooleanthe 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édits

Ajoute 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ètreTypeDescription
image_base64FacultatifstringPNG / JPEG / WEBP, optionally a data: URL
source_urlFacultatifstringpublic http(s) image address to copy instead
titleFacultatifstring—

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édits

Adapte 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ètreTypeDescription
production_idObligatoirestringready image to adapt
formatsObligatoirearray<integer>ad format ids (get_production_options topic=formats)
headlineFacultatifstring—
ctaFacultatifstring—
logoFacultatifbooleanbrand 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édits

Demande 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ètreTypeDescription
production_idObligatoirestringready video
profileObligatoiretv_pal | tv_ntsc | ctv—
codecObligatoireprores | h264prores = ProRes 422 HQ .mov · h264 = H.264 High .mp4
secondsFacultatifinteger (0–60)exact spot length (0 = the source's length)
pillarboxFacultatifbooleanfit 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édits

Supprime définitivement une copie master et son fichier. Irréversible — uniquement si l'utilisateur le demande explicitement.

ParamètreTypeDescription
master_idObligatoirestringmaster 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édits

Remonte 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ètreTypeDescription
production_idObligatoirestringbrand film
orderFacultatifarray<integer>new scene order: every scene number once
captionsFacultatifboolean—
end_cardFacultatifboolean—

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édits

Cré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ètreTypeDescription
production_idObligatoirestringready image or video
daysFacultatifinteger (1–90)link lifetime in days (default 14)
scopeFacultatifsingle | groupsingle = 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édits

Ferme 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ètreTypeDescription
production_idObligatoirestringproduction 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édits

Enregistre 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ètreTypeDescription
nameObligatoirestring—
typeObligatoirevirtual | realvirtual = AI influencer · real = a real person (AI avatar)
image_idObligatoirestringready face image in the library (generated portrait or uploaded photo)
descriptionFacultatifstring—
consentFacultatifobjectrequired 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édits

Supprime un personnage (pour une personne réelle, retrait du consentement). Irréversible — uniquement si l'utilisateur le demande explicitement ; les fichiers produits restent.

ParamètreTypeDescription
character_idObligatoirestring—

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édits

Dé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ètreTypeDescription
monthly_limitFacultatifnumber (0–1000000)USD per month
clearFacultatifbooleanremove 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édits

Fait 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ètreTypeDescription
production_idObligatoirestringready file (or a script for a text card)
campaignObligatoirestringcampaign 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.