Aller au contenu
Tecrübetecrube.com
Premiers pas

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ête Authorization: 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.

FonctionDans le tableau de bordOutil MCPPoint de terminaison REST
Types, recettes, niveaux de qualité et prixFormulaire de nouvelle productionget_production_optionsGET /production/overview · GET /production/formats
Suggestions de phrase d'accroche (hook)Formulaire › Suggestions d'accrochesuggest_production_hooksPOST /production/hooks
Devis : quoi, pour combien, jusqu'à quandVoir le prixquote_productionPOST /production/quotes
Variantes (2 à 4)Formulaire › Nombre de variantesquote_production variationsPOST /production/quotes/batch
Lire un devisCarte du devisget_production_quoteGET /production/quotes/{id}
Lancer un devis confirméConfirmer et produirestart_productionPOST /production/jobs · POST /production/jobs/batch
Génération simple en une étape (sans confirmation)—generate_content—
Bibliothèque : recherche, filtres, paginationOnglet Productionslist_productionsGET /production/jobs
Tout sur une productionCarte de productionlist_productions production_idGET /production/jobs/{id}
Annuler une tâche en file d'attenteCarte › Annulercancel_productionPOST /production/jobs/{id}/cancel
Relancer une tâche échouée avec les mêmes réglagesCarte › Réessayerretry_productionPOST /production/jobs/{id}/retry
FavoriCarte › Étoileset_production_favoritePUT /production/jobs/{id}/favorite
Supprimer (aussi en lot)Carte › Supprimer · Sélectionner › Supprimer la sélectiondelete_productionDELETE /production/jobs/{id}
Téléchargement (PNG / JPG / WEBP)Carte › Téléchargerget_production_downloadGET /production/jobs/{id}/download
Partir d'une page produitPartir d'une page produitimport_production_from_urlPOST /production/import-url
Importer votre propre imageImporter une imageupload_production_imagePOST /production/assets
Adapter aux formats publicitairesCarte › Adapter aux formatsadapt_production_formatsPOST /production/jobs/{id}/formats
Contrôle avant diffusionCarte › Contrôle avant diffusionproduction_preflightGET /production/jobs/{id}/preflight
Copie master TV / TV connectéeCarte › Qualité diffusionget_production_masters · create_production_master · delete_production_masterGET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id}
Scènes du film de marque et nouveau montageCarte › Modifier les scènesget_production_film · edit_production_filmGET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit
Régénérer une seule scèneScènes › Régénérer cette scènequote_production recipe: scenePOST /production/quotes recipe: scene
En produire d'autres comme celui-ciRésultat publicitaire › D'autres comme celui-ciquote_production like_production_idGET /production/jobs/{id} → POST /production/quotes (hook, angle)
Lien de relecture, décision et commentairesCarte › Partagercreate_production_share · get_production_share · revoke_production_sharePOST / GET / DELETE /production/jobs/{id}/share
Personnages (influenceur IA, avatar IA)Onglet Personnagesget_production_options topic: characters · create_production_character · delete_production_characterGET / POST /production/characters · DELETE /production/characters/{id}
Solde, crédits et mouvementsEncadré du soldeget_production_walletGET /production/wallet · GET /production/wallet/ledger
Limite de dépense mensuelleSolde › Limite mensuelleset_production_monthly_limitPUT /production/wallet/limit
Ajouter une production à une campagneChat · créations de la campagneadd_production_to_campaignPOST /production/jobs/{id}/campaign
Résultat publicitaire et meilleure varianteCarte › Résultat publicitaire · Varianteslist_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.

RecetteCe que vous obtenezType (`kind`)Il faut
—Types de base : image, vidéo courte, vidéo UGC, voix off, script.image · short_video · ugc_video · voice · scriptbrief
productImage ou vidéo à partir d'une photo produit ; le produit reste, la scène (style) change.image · short_video · ugc_videoreference_id, style
editNouvelle version d'un fichier prêt ; brief décrit la modification.image · short_video · ugc_videoreference_id, brief
personaPortrait IA à enregistrer comme personnage.imagebrief
influencerContenu cohérent avec un personnage virtuel enregistré.image · short_video · ugc_videocharacter_id (virtual)
avatarContenu avec le personnage d'une personne réelle ayant donné son consentement.image · short_video · ugc_videocharacter_id (real)
filmFilm de marque en plusieurs scènes avec sous-titres et carte de fin avec votre logo.short_videoscenes, captions, end_card
sceneUne scène d'un film prêt ; seule cette scène est facturée, scene: 1 + hook ne change que l'ouverture.short_videoreference_id, scene, hook
dubbingUne vidéo prête dans une autre langue.short_video · ugc_videoreference_id, language
packFormats publicitaires à partir d'une image principale, avec une vidéo courte en option.imageformats, video

De bout en bout avec MCP

Le langage courant suffit ; l'assistant procède dans cet ordre.

  1. Options : get_production_options lit les types, niveaux et prix (aucun chiffre inventé).
  2. Devis : quote_production renvoie ce qui sera produit et le prix. Rien n'est produit, aucun crédit n'est utilisé.
  3. Confirmation : l'assistant vous montre le prix et attend votre accord.
  4. Lancement : après votre confirmation, start_production lance le devis ; le montant est réservé à cette étape.
  5. Statut et fichier : list_productions donne le statut et l'adresse du fichier prêt ; get_production_download cré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
// 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 · list_productions · get_production_download
// 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)

json
// 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_production

De 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.

bash
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

bash
# 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 dans get_production_options et GET /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_production et retry_production ne créent qu'un devis ; ils ne produisent et ne facturent rien.
  • start_production ré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-Key renvoie 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_id ou profile, 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 de get_production_options ou GET /production/overview › tiers avec engine_name. Un moteur désactivé est refusé avec engine_unavailable au 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.
json
// 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

SujetLimite
Import d'imagePNG, 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
Variantes2 à 4 (l'administration de la plateforme peut abaisser le maximum)
Suggestions d'accroche5 à 8 par appel
Adaptation aux formatsJusqu'à 12 formats par demande
Suppression en lot (MCP)Jusqu'à 24 productions par appel
Lien de relecture1 à 90 jours (14 par défaut)
Film de marqueJusqu'à 12 scènes ; jusqu'à 12 versions par production
Copie master de diffusionDuré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
PersonnagesJusqu'à 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

CodeRESTSignification et que faire
credits_exhausted402Les 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_balance402Le solde de production est insuffisant ; rechargez-le sur l'écran Production.
monthly_limit402Votre limite mensuelle serait dépassée ; modifiez-la ou attendez le mois prochain.
quote_expired · quote_cancelled410 · 409Le devis a expiré ou a été annulé ; demandez-en un nouveau (le prix a pu changer).
not_found404L'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_only403Une 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_limited429La limite horaire est atteinte ; réessayez après retry_after secondes.
reference_required · reference · character_required · language · formats422La 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_ready409Une 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.
consent422La déclaration de droits (page produit) ou la déclaration de consentement (personne réelle) manque.
unsafe · unsafe_url422Les adresses internes ou locales ne sont pas lues ; indiquez une adresse http(s) publique.

Étapes suivantes