Guide de production : tableau de bord, MCP et API
Comment chaque tâche de l'écran Production se fait dans le tableau de bord, dans les clients MCP comme Claude ou ChatGPT et via l'API REST : devis → confirmation → production → statut → téléchargement, recettes, prix et crédits, limites, codes d'erreur, consentement pour l'avatar d'une personne réelle.
Trois voies, les mêmes règles
- Tableau de bord : l'écran Production (
/uretim). Vous choisissez une carte, remplissez le formulaire puis utilisez « Voir le prix » et « Confirmer et produire ». - MCP : dans Claude, ChatGPT et les autres assistants, l'adresse du connecteur est
https://tecrube.com/mcp. Vous décrivez ce que vous voulez ; l'assistant appelle les outils ci-dessous. - API REST : les points de terminaison
https://tecrube.com/api/v1/production/...avec l'en-têteAuthorization: Bearer tk_.... Le tableau de bord utilise les mêmes points de terminaison. - Les trois appellent les mêmes fonctions internes : prix, contrôle des crédits, réservation du solde, limite mensuelle, limites de débit et validations sont identiques. Il n'existe aucune voie moins chère ou sans règles via MCP ou l'API.
Inventaire des fonctions
Chaque fonction de l'écran Production et ses équivalents. Les paramètres et crédits des outils sont générés depuis le code sur la page Outils de production ; les schémas des points de terminaison sont dans la référence OpenAPI.
| Fonction | Dans le tableau de bord | Outil MCP | Point de terminaison REST |
|---|---|---|---|
| Types, recettes, niveaux de qualité et prix | Formulaire de nouvelle production | get_production_options | GET /production/overview · GET /production/formats |
| Suggestions de phrase d'accroche (hook) | Formulaire › Suggestions d'accroche | suggest_production_hooks | POST /production/hooks |
| Devis : quoi, pour combien, jusqu'à quand | Voir le prix | quote_production | POST /production/quotes |
| Variantes (2 à 4) | Formulaire › Nombre de variantes | quote_production variations | POST /production/quotes/batch |
| Lire un devis | Carte du devis | get_production_quote | GET /production/quotes/{id} |
| Lancer un devis confirmé | Confirmer et produire | start_production | POST /production/jobs · POST /production/jobs/batch |
| Génération simple en une étape (sans confirmation) | — | generate_content | — |
| Bibliothèque : recherche, filtres, pagination | Onglet Productions | list_productions | GET /production/jobs |
| Tout sur une production | Carte de production | list_productions production_id | GET /production/jobs/{id} |
| Annuler une tâche en file d'attente | Carte › Annuler | cancel_production | POST /production/jobs/{id}/cancel |
| Relancer une tâche échouée avec les mêmes réglages | Carte › Réessayer | retry_production | POST /production/jobs/{id}/retry |
| Favori | Carte › Étoile | set_production_favorite | PUT /production/jobs/{id}/favorite |
| Supprimer (aussi en lot) | Carte › Supprimer · Sélectionner › Supprimer la sélection | delete_production | DELETE /production/jobs/{id} |
| Téléchargement (PNG / JPG / WEBP) | Carte › Télécharger | get_production_download | GET /production/jobs/{id}/download |
| Partir d'une page produit | Partir d'une page produit | import_production_from_url | POST /production/import-url |
| Importer votre propre image | Importer une image | upload_production_image | POST /production/assets |
| Adapter aux formats publicitaires | Carte › Adapter aux formats | adapt_production_formats | POST /production/jobs/{id}/formats |
| Contrôle avant diffusion | Carte › Contrôle avant diffusion | production_preflight | GET /production/jobs/{id}/preflight |
| Copie master TV / TV connectée | Carte › Qualité diffusion | get_production_masters · create_production_master · delete_production_master | GET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id} |
| Scènes du film de marque et nouveau montage | Carte › Modifier les scènes | get_production_film · edit_production_film | GET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit |
| Régénérer une seule scène | Scènes › Régénérer cette scène | quote_production recipe: scene | POST /production/quotes recipe: scene |
| En produire d'autres comme celui-ci | Résultat publicitaire › D'autres comme celui-ci | quote_production like_production_id | GET /production/jobs/{id} → POST /production/quotes (hook, angle) |
| Lien de relecture, décision et commentaires | Carte › Partager | create_production_share · get_production_share · revoke_production_share | POST / GET / DELETE /production/jobs/{id}/share |
| Personnages (influenceur IA, avatar IA) | Onglet Personnages | get_production_options topic: characters · create_production_character · delete_production_character | GET / POST /production/characters · DELETE /production/characters/{id} |
| Solde, crédits et mouvements | Encadré du solde | get_production_wallet | GET /production/wallet · GET /production/wallet/ledger |
| Limite de dépense mensuelle | Solde › Limite mensuelle | set_production_monthly_limit | PUT /production/wallet/limit |
| Ajouter une production à une campagne | Chat · créations de la campagne | add_production_to_campaign | POST /production/jobs/{id}/campaign |
| Résultat publicitaire et meilleure variante | Carte › Résultat publicitaire · Variantes | list_productions (performance, batch_result, review) | GET /production/jobs (performance, batch_result, review) |
Types et recettes
Cinq types de base et huit recettes prêtes ; toutes se demandent avec quote_production (MCP) et POST /production/quotes (REST). La recette est le champ recipe.
| Recette | Ce que vous obtenez | Type (`kind`) | Il faut |
|---|---|---|---|
| — | Types de base : image, vidéo courte, vidéo UGC, voix off, script. | image · short_video · ugc_video · voice · script | brief |
product | Image ou vidéo à partir d'une photo produit ; le produit reste, la scène (style) change. | image · short_video · ugc_video | reference_id, style |
edit | Nouvelle version d'un fichier prêt ; brief décrit la modification. | image · short_video · ugc_video | reference_id, brief |
persona | Portrait IA à enregistrer comme personnage. | image | brief |
influencer | Contenu cohérent avec un personnage virtuel enregistré. | image · short_video · ugc_video | character_id (virtual) |
avatar | Contenu avec le personnage d'une personne réelle ayant donné son consentement. | image · short_video · ugc_video | character_id (real) |
film | Film de marque en plusieurs scènes avec sous-titres et carte de fin avec votre logo. | short_video | scenes, captions, end_card |
scene | Une scène d'un film prêt ; seule cette scène est facturée, scene: 1 + hook ne change que l'ouverture. | short_video | reference_id, scene, hook |
dubbing | Une vidéo prête dans une autre langue. | short_video · ugc_video | reference_id, language |
pack | Formats publicitaires à partir d'une image principale, avec une vidéo courte en option. | image | formats, video |
De bout en bout avec MCP
Le langage courant suffit ; l'assistant procède dans cet ordre.
- Options :
get_production_optionslit les types, niveaux et prix (aucun chiffre inventé). - Devis :
quote_productionrenvoie ce qui sera produit et le prix. Rien n'est produit, aucun crédit n'est utilisé. - Confirmation : l'assistant vous montre le prix et attend votre accord.
- Lancement : après votre confirmation,
start_productionlance le devis ; le montant est réservé à cette étape. - Statut et fichier :
list_productionsdonne le statut et l'adresse du fichier prêt ;get_production_downloadcrée une adresse de téléchargement dans le type souhaité.
Exemple de demande : « Prépare une affiche d'automne au format 4:5, aux tons chauds, pour mon café. Donne-moi d'abord le prix et produis-la si je valide. »
// quote_production
{ "kind": "image", "brief": "Autumn coffee campaign poster, warm tones", "aspect": "4:5", "tier": "balanced" }
// result (nothing produced or charged yet)
{ "ok": true, "status": "awaiting_confirmation", "started": false,
"quote": { "quote_id": "6f0c…", "kind": "image", "pricing": "credits", "price": { "credits": 24 },
"credits_remaining": 5810, "enough_credits": true, "expires_at": "2026-11-18T10:30:00+00:00" },
"confirm_with": { "tool": "start_production", "arguments": { "quote_id": "6f0c…" } } }// start_production — only after the user confirmed the price
{ "quote_id": "6f0c…" }
// → { "ok": true, "production_id": "a1b2…", "status": "queued", … }
// list_productions — repeat until status is "ready"
{ "production_id": "a1b2…" }
// → { "items": [ { "id": "a1b2…", "status": "ready", "url": "https://tecrube.com/medya/…", "file": { "width": 1080, "height": 1350 } } ] }
// get_production_download — a JPG copy at a signed address that expires
{ "production_id": "a1b2…", "format": "jpg" }Exemples de recettes (arguments MCP)
// From a product page: page facts + the main image into the library
{ "url": "https://shop.example.com/product/123", "confirm_rights": true } // import_production_from_url
// Product video from that photo, three variations (the total price comes back)
{ "kind": "short_video", "recipe": "product", "reference_id": "<image id>", "brief": "…", "variations": 3 } // quote_production
// Dub a ready video into German
{ "kind": "short_video", "recipe": "dubbing", "reference_id": "<video id>", "language": "de" } // quote_production
// "More like this": the winner's settings, a new aspect
{ "like_production_id": "<winner id>", "aspect": "9:16" } // quote_productionDe bout en bout avec l'API REST
Le même parcours avec curl. L'id de la réponse au devis est l'identifiant du devis ; l'id de la réponse à POST /production/jobs est l'identifiant de la production.
API=https://tecrube.com/api/v1
KEY=tk_your_key
# 1) Quote — nothing is produced or charged (Idempotency-Key returns the same quote on retry)
curl -X POST $API/production/quotes \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -H "Idempotency-Key: autumn-poster-1" \
-d '{"kind":"image","brief":"Autumn coffee campaign poster, warm tones","aspect":"4:5","tier":"balanced"}'
# → {"id":"<quote_id>","mode":"credits","credits":24,"price_usd":0,"expires_at":"…",…}
# 2) Confirm and start (the same quote_id never starts a second production)
curl -X POST $API/production/jobs \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{"quote_id":"<quote_id>"}'
# 3) Status — repeat until "status":"ready" (running jobs carry "eta")
curl $API/production/jobs/<job_id> -H "Authorization: Bearer $KEY"
# 4) Download as JPG (png | jpg | webp; images only)
curl -o poster.jpg "$API/production/jobs/<job_id>/download?format=jpg" -H "Authorization: Bearer $KEY"Exemples d'autres points de terminaison
# Library: search, filter, paginate
curl "$API/production/jobs?q=autumn&kind=image&status=ready&favorite=true&limit=20&offset=0" -H "Authorization: Bearer $KEY"
# Variations: 2–4 quotes in one request, then one confirmation
curl -X POST $API/production/quotes/batch -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"kind":"image","brief":"New collection","variations":3,"hooks":["Autumn is here","New season"]}'
curl -X POST $API/production/jobs/batch -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"quote_ids":["<q1>","<q2>","<q3>"]}'
# Adapt a ready image to ad formats (format ids: GET /production/formats?platform=meta&type=image)
curl -X POST $API/production/jobs/<job_id>/formats -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"formats":[12,14],"headline":"New season","cta":"Shop now","logo":true}'
# Review link for 14 days, then read the decision and comments
curl -X POST $API/production/jobs/<job_id>/share -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{"days":14}'
curl $API/production/jobs/<job_id>/share -H "Authorization: Bearer $KEY"
# TV master copy (ProRes 422 HQ, 30 s, PAL)
curl -X POST $API/production/jobs/<job_id>/masters -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"profile":"tv_pal","codec":"prores","seconds":30}'
# Use it in a campaign
curl -X POST $API/production/jobs/<job_id>/campaign -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"campaign_id":"<campaign_id>"}'Prix et crédits
- Mode de facturation : les productions se paient soit avec les crédits du forfait (
pricing: credits), soit avec le solde de production (pricing: balance, USD) ; le mode actif figure dansget_production_optionsetGET /production/overview. - Le prix d'abord : chaque devis indique ce qui sera produit, le montant et sa validité (
expires_at). Un devis expiré ne peut pas être lancé ; un nouveau est calculé au prix du jour. - Quand c'est facturé : en mode solde, le montant est réservé au lancement et débité quand le fichier est prêt ; si la tâche échoue ou est annulée, la réservation est restituée. En mode crédits, le lancement vérifie que les crédits restants couvrent la tâche, et les crédits sont utilisés quand le fichier est produit.
- Insuffisant, pas de lancement : si les crédits ou le solde ne suffisent pas, ou si la limite mensuelle serait dépassée, la tâche ne démarre pas ; la réponse indique le montant nécessaire et le montant restant.
- Le même prix partout : les prix sont fixés pour que chaque tâche couvre son coût, et le tableau de bord, MCP et l'API appliquent le même prix.
- Frais des outils MCP : l'appel des outils de production ne coûte rien de plus (0 crédit) ; seules la lecture d'une page produit, l'import d'une image depuis une adresse et les suggestions d'accroche coûtent 1 crédit. Le prix de la production est le montant de son devis.
Confirmation : quand êtes-vous facturé ?
quote_productionetretry_productionne créent qu'un devis ; ils ne produisent et ne facturent rien.start_productionréserve le montant ou utilise des crédits ; l'assistant ne doit l'appeler qu'après que vous avez vu le prix et donné votre accord explicite. L'outil est signalé dans les clients comme demandant une confirmation (destructif).- Le chat du tableau de bord ne lance pas un devis obtenu dans le même tour (
confirmation_required) : l'accord doit venir après le message où vous avez vu le prix. - Lancer deux fois le même devis n'ouvre pas de seconde production ; la première est renvoyée. En REST,
Idempotency-Keyrenvoie le même devis.
Après la production
- Adapter aux formats : une image prête est convertie aux proportions de 12 emplacements au plus ; titre, appel à l'action et logo restent dans la zone sûre. Gratuit.
- Contrôle avant diffusion : sans cible, il liste les emplacements et les profils de diffusion ; avec
format_idouprofile, le fichier lui-même est mesuré et une liste réussi / attention / échec est renvoyée. - Qualité diffusion : à partir d'une vidéo prête, une copie master ProRes 422 HQ ou H.264 pour la TV PAL (1080p25, −23 LUFS), la TV NTSC (1080p29,97, −24 LKFS) ou la TV connectée, avec un rapport technique. Gratuit ; l'acceptation par un diffuseur n'est pas garantie.
- Moteur vidéo : pour les vidéos, vous pouvez choisir le modèle par son nom au lieu d'un niveau de qualité (Seedance 2.0 et 2.5 en 1080p ; 2.5 Flash, 2.0 Fast et 2.0 Mini en 720p, tous avec son). Indiquez l'identifiant du modèle dans
tier, par ex.bytedance/seedance-2.0; la liste et les prix viennent deget_production_optionsouGET /production/overview›tiersavecengine_name. Un moteur désactivé est refusé avecengine_unavailableau lieu d'être facturé avec un autre modèle. - Film de marque : l'ordre des scènes, les sous-titres et la carte de fin sont remontés gratuitement en nouvelle version ; l'ancienne reste. Régénérer une seule scène est payant et passe par un devis.
- Partage : un lien de relecture sans connexion, valable de 1 à 90 jours ; l'adresse n'est affichée qu'une fois à la création et les liens précédents de la production sont fermés. Lisez la décision et les commentaires avec
get_production_share; fermez le lien quand vous voulez. - Ajouter à une campagne : la production devient une carte de création en brouillon de la campagne. Sur Meta et Google, le fichier est utilisé à la publication de la campagne ; une annonce en cours ne change pas d'elle-même.
- Résultat publicitaire : une production utilisée en publicité affiche les chiffres de la campagne (
performance) et, pour les variantes, la comparaison (batch_result). « Meilleur résultat » n'est indiqué que dans une comparaison équitable. - Suppression : définitive et irréversible. Le contenu utilisé dans une campagne (
in_use) ou encore en production (active) n'est pas supprimé. L'assistant ne doit utiliser les outils de suppression que si vous le demandez explicitement.
Avatar d'une personne réelle et consentement
- Pour un personnage virtuel (influenceur IA), une image de visage prête suffit.
- L'avatar d'une personne réelle n'est enregistré qu'avec une déclaration de consentement : le nom de la personne, le fondement (
self: vous êtes la personne sur la photo ·written: la personne a donné son accord écrit) et la confirmation explicite (confirmed: true). La déclaration est enregistrée avec votre compte et l'heure. - Vous seul faites cette déclaration. L'assistant ne peut pas remplir ces champs à votre place ; le chat du tableau de bord ne crée jamais le personnage d'une personne réelle et vous renvoie vers le formulaire.
- Supprimer le personnage retire le consentement ; les fichiers produits auparavant restent dans la bibliothèque.
// create_production_character (MCP) · POST /production/characters (REST)
{ "name": "Ayşe", "type": "real", "image_id": "<photo id>",
"consent": { "person_name": "Ayşe Yılmaz", "basis": "self", "confirmed": true } }Limites
| Sujet | Limite |
|---|---|
| Import d'image | PNG, JPEG ou WEBP ; jusqu'à 12 Mo ; côtés de 200 à 4 096 px ; jusqu'à 500 imports dans la bibliothèque |
Texte de la demande (brief) | Jusqu'à 2 000 caractères ; phrase d'accroche jusqu'à 160 caractères |
| Variantes | 2 à 4 (l'administration de la plateforme peut abaisser le maximum) |
| Suggestions d'accroche | 5 à 8 par appel |
| Adaptation aux formats | Jusqu'à 12 formats par demande |
| Suppression en lot (MCP) | Jusqu'à 24 productions par appel |
| Lien de relecture | 1 à 90 jours (14 par défaut) |
| Film de marque | Jusqu'à 12 scènes ; jusqu'à 12 versions par production |
| Copie master de diffusion | Durée du spot 10, 15, 20, 30, 45 ou 60 s ; la source est allongée de 3 s au plus ; vidéo source jusqu'à 185 s ; jusqu'à 8 copies par production |
| Personnages | Jusqu'à 50 par compte |
| Limites de débit (par heure et par compte) | Devis 120 · imports 60 · adaptation 120 · personnages 40 · copies master 20 · contrôle 180 · nouveau montage 30 · suggestions d'accroche 40 · page produit 20 · partage 60 · téléchargement 240 |
Codes d'erreur
| Code | REST | Signification et que faire |
|---|---|---|
credits_exhausted | 402 | Les crédits du forfait ne couvrent pas cette tâche ; la réponse indique needed et remaining. Passez à un forfait supérieur ou achetez des crédits sur l'écran Forfait. |
insufficient_balance | 402 | Le solde de production est insuffisant ; rechargez-le sur l'écran Production. |
monthly_limit | 402 | Votre limite mensuelle serait dépassée ; modifiez-la ou attendez le mois prochain. |
quote_expired · quote_cancelled | 410 · 409 | Le devis a expiré ou a été annulé ; demandez-en un nouveau (le prix a pu changer). |
not_found | 404 | L'identifiant n'existe pas dans ce compte (l'enregistrement d'un autre compte apparaît de la même façon). Prenez l'identifiant dans l'outil ou le point de terminaison de liste. |
read-only · read_only | 403 | Une clé en lecture ou le rôle lecteur ne peut pas effectuer de tâche d'écriture. |
needs_provider | — | C'est un statut de production : aucun fournisseur d'IA n'est connecté et seul le script a été écrit ; on peut réessayer une fois un fournisseur connecté. |
rate_limited | 429 | La limite horaire est atteinte ; réessayez après retry_after secondes. |
reference_required · reference · character_required · language · formats | 422 | La source, le personnage, la langue ou le format requis par la recette manque ou n'est pas valide ; hint dans la réponse indique quoi faire. |
rendering · in_use · active · not_ready | 409 | Une tâche déjà chez le fournisseur ne peut pas être arrêtée ; le contenu d'une campagne ou en production n'est pas supprimé ; un fichier non prêt n'est pas ajouté à une campagne. |
consent | 422 | La déclaration de droits (page produit) ou la déclaration de consentement (personne réelle) manque. |
unsafe · unsafe_url | 422 | Les adresses internes ou locales ne sont pas lues ; indiquez une adresse http(s) publique. |
Étapes suivantes
- Outils de productionImages, vidéos, voix off et scripts : devis et confirmation, toutes les recettes, bibliothèque, adaptation aux formats, qualité diffusion, liens de relecture et personnages.
- API et clientsAuthentification par clé d'API avec le forfait Enterprise : droits, limites de débit, référence OpenAPI, clients Python et JavaScript et connexion avec les SDK MCP.
- Crédits & utilisationChaque appel d'outil dépense quelques crédits : la lecture est bon marché, les modifications en direct coûtent plus. 100 crédits à vie dans l'offre Démarrage, crédits renouvelés chaque mois dans les offres payantes ; les appels échoués sont remboursés.