Produktionsleitfaden: Dashboard, MCP und API
Wie jede Aufgabe des Produktionsbildschirms im Dashboard, in MCP-Clients wie Claude oder ChatGPT und über die REST-API erledigt wird: Angebot → Bestätigung → Produktion → Status → Download, Rezepte, Preise und Credits, Grenzen, Fehlercodes, Einwilligung beim Avatar einer realen Person.
Drei Wege, dieselben Regeln
- Dashboard: der Produktionsbildschirm (
/uretim). Sie wählen eine Karte, füllen das Formular aus und nutzen "Preis ansehen" und "Bestätigen und produzieren". - MCP: In Claude, ChatGPT und anderen Assistenten lautet die Connector-Adresse
https://tecrube.com/mcp. Sie beschreiben, was Sie möchten; der Assistent ruft die unten genannten Tools auf. - REST-API: die Endpunkte
https://tecrube.com/api/v1/production/...mit dem HeaderAuthorization: Bearer tk_.... Das Dashboard nutzt dieselben Endpunkte. - Alle drei rufen dieselben Kernfunktionen auf: Preis, Credit-Prüfung, Reservierung des Guthabens, Monatslimit, Ratenlimits und Prüfungen sind identisch. Über MCP oder die API gibt es keinen günstigeren oder regelfreien Weg.
Funktionsübersicht
Jede Funktion des Produktionsbildschirms und ihre Entsprechungen. Parameter und Credits der Tools werden auf der Seite Produktions-Tools aus dem Code erzeugt; die Schemas der Endpunkte stehen in der OpenAPI-Referenz.
| Funktion | Im Dashboard | MCP-Tool | REST-Endpunkt |
|---|---|---|---|
| Arten, Rezepte, Qualitätsstufen und Preise | Formular für neue Produktion | get_production_options | GET /production/overview · GET /production/formats |
| Vorschläge für den Einstieg (Hook) | Formular › Einstiegsvorschläge | suggest_production_hooks | POST /production/hooks |
| Angebot: was, zu welchem Preis, bis wann | Preis ansehen | quote_production | POST /production/quotes |
| Varianten (2–4) | Formular › Anzahl der Varianten | quote_production variations | POST /production/quotes/batch |
| Angebot lesen | Angebotskarte | get_production_quote | GET /production/quotes/{id} |
| Bestätigtes Angebot starten | Bestätigen und produzieren | start_production | POST /production/jobs · POST /production/jobs/batch |
| Einfache Produktion in einem Schritt (ohne Bestätigung) | — | generate_content | — |
| Bibliothek: Suche, Filter, Seiten | Reiter Produktionen | list_productions | GET /production/jobs |
| Alles zu einer Produktion | Produktionskarte | list_productions production_id | GET /production/jobs/{id} |
| Wartenden Auftrag abbrechen | Karte › Abbrechen | cancel_production | POST /production/jobs/{id}/cancel |
| Fehlgeschlagenen Auftrag mit denselben Einstellungen wiederholen | Karte › Erneut versuchen | retry_production | POST /production/jobs/{id}/retry |
| Favorit | Karte › Stern | set_production_favorite | PUT /production/jobs/{id}/favorite |
| Löschen (auch mehrere) | Karte › Löschen · Auswählen › Auswahl löschen | delete_production | DELETE /production/jobs/{id} |
| Download (PNG / JPG / WEBP) | Karte › Herunterladen | get_production_download | GET /production/jobs/{id}/download |
| Mit einer Produktseite beginnen | Mit Produktseite starten | import_production_from_url | POST /production/import-url |
| Eigenes Bild hochladen | Bild hochladen | upload_production_image | POST /production/assets |
| An Werbeformate anpassen | Karte › An Formate anpassen | adapt_production_formats | POST /production/jobs/{id}/formats |
| Prüfung vor der Veröffentlichung | Karte › Prüfung vor Veröffentlichung | production_preflight | GET /production/jobs/{id}/preflight |
| Masterkopie für TV / Connected TV | Karte › Sendequalität | get_production_masters · create_production_master · delete_production_master | GET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id} |
| Szenen des Markenfilms und Neuschnitt | Karte › Szenen bearbeiten | get_production_film · edit_production_film | GET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit |
| Eine einzelne Szene neu erzeugen | Szenen › Diese Szene neu erzeugen | quote_production recipe: scene | POST /production/quotes recipe: scene |
| Mehr davon | Werbeergebnis › Mehr davon | quote_production like_production_id | GET /production/jobs/{id} → POST /production/quotes (hook, angle) |
| Prüf-Link, Entscheidung und Kommentare | Karte › Teilen | create_production_share · get_production_share · revoke_production_share | POST / GET / DELETE /production/jobs/{id}/share |
| Charaktere (KI-Influencer, KI-Avatar) | Reiter Charaktere | get_production_options topic: characters · create_production_character · delete_production_character | GET / POST /production/characters · DELETE /production/characters/{id} |
| Guthaben, Credits und Buchungen | Guthaben-Box | get_production_wallet | GET /production/wallet · GET /production/wallet/ledger |
| Monatliches Ausgabenlimit | Guthaben › Monatslimit | set_production_monthly_limit | PUT /production/wallet/limit |
| Produktion zu einer Kampagne hinzufügen | Chat · Kampagnen-Creatives | add_production_to_campaign | POST /production/jobs/{id}/campaign |
| Werbeergebnis und beste Variante | Karte › Werbeergebnis · Varianten | list_productions (performance, batch_result, review) | GET /production/jobs (performance, batch_result, review) |
Arten und Rezepte
Fünf Grundarten und acht fertige Rezepte; alle werden mit quote_production (MCP) und POST /production/quotes (REST) angefragt. Das Rezept ist das Feld recipe.
| Rezept | Ergebnis | Art (`kind`) | Benötigt |
|---|---|---|---|
| — | Grundarten: Bild, Kurzvideo, UGC-Video, Sprachaufnahme, Skript. | image · short_video · ugc_video · voice · script | brief |
product | Bild oder Video aus einem Produktfoto; das Produkt bleibt, die Szene (style) ändert sich. | image · short_video · ugc_video | reference_id, style |
edit | Neue Version einer fertigen Datei; brief ist die gewünschte Änderung. | image · short_video · ugc_video | reference_id, brief |
persona | KI-Porträt, das als Charakter gespeichert wird. | image | brief |
influencer | Einheitliche Inhalte mit einem gespeicherten virtuellen Charakter. | image · short_video · ugc_video | character_id (virtual) |
avatar | Inhalte mit dem Charakter einer realen Person mit Einwilligung. | image · short_video · ugc_video | character_id (real) |
film | Markenfilm mit mehreren Szenen, Untertiteln und Abschlusskarte mit Logo. | short_video | scenes, captions, end_card |
scene | Eine Szene eines fertigen Films; nur diese Szene wird berechnet, scene: 1 + hook ändert nur den Einstieg. | short_video | reference_id, scene, hook |
dubbing | Ein fertiges Video in einer anderen Sprache. | short_video · ugc_video | reference_id, language |
pack | Werbeformate aus einem Hauptbild und optional ein Kurzvideo. | image | formats, video |
Komplett mit MCP
Natürliche Sprache genügt; der Assistent arbeitet in dieser Reihenfolge.
- Optionen:
get_production_optionsliest Arten, Stufen und Preise (keine erfundenen Zahlen). - Angebot:
quote_productionnennt, was produziert wird, und den Preis. Nichts wird produziert, keine Credits werden verbraucht. - Bestätigung: Der Assistent zeigt Ihnen den Preis und wartet auf Ihre Zustimmung.
- Start: Nach Ihrer Bestätigung startet
start_productiondas Angebot; der Preis wird in diesem Schritt reserviert. - Status und Datei:
list_productionsliefert den Status und die Adresse der fertigen Datei;get_production_downloaderstellt eine Download-Adresse im gewünschten Dateityp.
Beispiel-Prompt: "Erstelle für mein Café ein Herbstplakat im Format 4:5 in warmen Tönen. Nenne mir zuerst den Preis und produziere es, wenn ich zustimme."
// 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" }Rezeptbeispiele (MCP-Argumente)
// 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_productionKomplett mit der REST-API
Derselbe Ablauf mit curl. Die id in der Angebotsantwort ist die Angebots-ID; die id in der Antwort von POST /production/jobs ist die Produktions-ID.
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"Beispiele weiterer Endpunkte
# 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>"}'Preise und Credits
- Abrechnungsart: Produktionen werden entweder mit Plan-Credits (
pricing: credits) oder mit dem Produktionsguthaben (pricing: balance, USD) bezahlt; die aktive Art steht inget_production_optionsundGET /production/overview. - Zuerst der Preis: Jedes Angebot nennt, was produziert wird, den Betrag und die Gültigkeit (
expires_at). Ein abgelaufenes Angebot lässt sich nicht starten; ein neues gilt zum heutigen Preis. - Wann abgerechnet wird: Im Guthabenmodus wird der Betrag beim Start reserviert und bei fertiger Datei abgebucht; scheitert der Auftrag oder wird er abgebrochen, wird die Reservierung freigegeben. Im Credit-Modus prüft der Start, ob die restlichen Credits den Auftrag decken; die Credits werden verbraucht, wenn die Datei erzeugt ist.
- Reicht es nicht, startet nichts: Decken Credits oder Guthaben den Auftrag nicht oder würde das Monatslimit überschritten, startet er nicht; die Antwort nennt benötigten und verbleibenden Betrag.
- Überall derselbe Preis: Die Preise sind so festgelegt, dass jeder Auftrag seine Kosten deckt; Dashboard, MCP und API wenden denselben Preis an.
- MCP-Tool-Gebühr: Der Aufruf der Produktions-Tools kostet nichts zusätzlich (0 Credits); nur das Lesen einer Produktseite, das Hochladen eines Bildes von einer Adresse und Einstiegsvorschläge kosten 1 Credit. Der Preis der Produktion ist der Betrag im Angebot.
Bestätigung: wann wird berechnet?
quote_productionundretry_productionerstellen nur ein Angebot; sie produzieren und berechnen nichts.start_productionreserviert den Preis oder verbraucht Credits; der Assistent sollte es erst aufrufen, wenn Sie den Preis gesehen und ausdrücklich zugestimmt haben. Das Tool ist in Clients als bestätigungspflichtig (destruktiv) markiert.- Der Dashboard-Chat startet kein Angebot aus derselben Runde (
confirmation_required): Die Zustimmung muss nach der Nachricht kommen, in der Sie den Preis gesehen haben. - Wird dasselbe Angebot zweimal gestartet, entsteht keine zweite Produktion; die erste wird zurückgegeben. In REST liefert
Idempotency-Keydasselbe Angebot.
Nach der Produktion
- An Formate anpassen: Ein fertiges Bild wird in die Seitenverhältnisse von bis zu 12 Platzierungen umgewandelt; Überschrift, Handlungsaufforderung und Logo bleiben im sicheren Bereich. Kostenlos.
- Prüfung vor der Veröffentlichung: Ohne Ziel listet sie Platzierungen und Sendeprofile auf; mit
format_idoderprofilewird die Datei selbst gemessen und eine Liste mit bestanden / Hinweis / nicht bestanden zurückgegeben. - Sendequalität: Aus einem fertigen Video entsteht eine Masterkopie in ProRes 422 HQ oder H.264 für TV PAL (1080p25, −23 LUFS), TV NTSC (1080p29,97, −24 LKFS) oder Connected TV, mit technischem Bericht. Kostenlos; die Annahme durch einen Sender ist nicht garantiert.
- Video-Engine: Bei Videos können Sie statt einer Qualitätsstufe das Modell beim Namen wählen (Seedance 2.0 und 2.5 in 1080p; 2.5 Flash, 2.0 Fast und 2.0 Mini in 720p, alle mit Ton). Die Modell-ID gehört in
tier, z. B.bytedance/seedance-2.0; Liste und Preise liefernget_production_optionsoderGET /production/overview›tiersmitengine_name. Eine deaktivierte Engine wird mitengine_unavailableabgelehnt und nicht mit einem anderen Modell berechnet. - Markenfilm: Szenenfolge, Untertitel und Abschlusskarte werden kostenlos als neue Version neu geschnitten; die alte bleibt. Eine einzelne Szene neu zu erzeugen ist kostenpflichtig und läuft über ein Angebot.
- Teilen: ein Prüf-Link ohne Anmeldung, 1–90 Tage gültig; die Adresse wird nur einmal bei der Erstellung angezeigt, frühere Links der Produktion werden geschlossen. Entscheidung und Kommentare lesen Sie mit
get_production_share; den Link schließen Sie jederzeit. - Zur Kampagne hinzufügen: Die Produktion wird zur Entwurfs-Creative-Karte der Kampagne. Bei Meta und Google wird die Datei bei der Veröffentlichung der Kampagne verwendet; eine laufende Anzeige ändert sich nicht von selbst.
- Werbeergebnis: Eine in Anzeigen genutzte Produktion zeigt Kampagnenzahlen (
performance) und bei Varianten den Vergleich (batch_result). "Bestes Ergebnis" wird nur bei einem fairen Vergleich markiert. - Löschen: dauerhaft und nicht rückgängig zu machen. Inhalte in einer Kampagne (
in_use) oder in Produktion (active) werden nicht gelöscht. Der Assistent sollte Lösch-Tools nur aufrufen, wenn Sie es ausdrücklich verlangen.
Avatar einer realen Person und Einwilligung
- Für einen virtuellen Charakter (KI-Influencer) genügt ein fertiges Gesichtsbild.
- Der Avatar einer realen Person wird nur mit einer Einwilligungserklärung gespeichert: Name der Person, Grundlage (
self: Sie sind die Person auf dem Foto ·written: die Person hat schriftlich zugestimmt) und ausdrückliche Bestätigung (confirmed: true). Die Erklärung wird mit Ihrem Konto und dem Zeitpunkt gespeichert. - Die Erklärung geben nur Sie ab. Der Assistent darf diese Felder nicht in Ihrem Namen ausfüllen; der Dashboard-Chat legt keinen Charakter einer realen Person an und verweist Sie auf das Formular.
- Das Löschen des Charakters widerruft die Einwilligung; bereits erzeugte Dateien bleiben in der Bibliothek.
// 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 } }Grenzen
| Thema | Grenze |
|---|---|
| Bild-Upload | PNG, JPEG oder WEBP; bis 12 MB; Seiten 200–4.096 px; bis zu 500 Uploads in der Bibliothek |
Anfragetext (brief) | Bis 2.000 Zeichen; Einstiegssatz bis 160 Zeichen |
| Varianten | 2–4 (die Plattformverwaltung kann das Maximum senken) |
| Einstiegsvorschläge | 5–8 pro Aufruf |
| Formatanpassung | Bis zu 12 Formate pro Anfrage |
| Mehrfach löschen (MCP) | Bis zu 24 Produktionen pro Aufruf |
| Prüf-Link | 1–90 Tage (Standard 14) |
| Markenfilm | Bis zu 12 Szenen; bis zu 12 Versionen pro Produktion |
| Sende-Masterkopie | Spotlänge 10, 15, 20, 30, 45 oder 60 s; die Quelle wird höchstens um 3 s verlängert; Quellvideo bis 185 s; bis zu 8 Kopien pro Produktion |
| Charaktere | Bis zu 50 pro Konto |
| Ratenlimits (pro Stunde, pro Konto) | Angebote 120 · Uploads 60 · Anpassung 120 · Charaktere 40 · Masterkopien 20 · Prüfung 180 · Neuschnitt 30 · Einstiegsvorschläge 40 · Produktseite 20 · Teilen 60 · Download 240 |
Fehlercodes
| Code | REST | Bedeutung und was zu tun ist |
|---|---|---|
credits_exhausted | 402 | Die Plan-Credits decken diesen Auftrag nicht; die Antwort nennt needed und remaining. Upgraden Sie oder kaufen Sie Zusatz-Credits auf dem Plan-Bildschirm. |
insufficient_balance | 402 | Das Produktionsguthaben reicht nicht; laden Sie es auf dem Produktionsbildschirm auf. |
monthly_limit | 402 | Ihr Monatslimit würde überschritten; ändern Sie es oder warten Sie auf den nächsten Monat. |
quote_expired · quote_cancelled | 410 · 409 | Das Angebot ist abgelaufen oder storniert; holen Sie ein neues ein (der Preis kann sich geändert haben). |
not_found | 404 | Die ID gibt es in diesem Konto nicht (ein Datensatz eines anderen Kontos sieht genauso aus). Nehmen Sie die ID aus dem Listen-Tool oder -Endpunkt. |
read-only · read_only | 403 | Ein Schlüssel mit Lese-Scope oder die Betrachter-Rolle kann keine Schreibaufgaben ausführen. |
needs_provider | — | Ein Produktionsstatus: Kein KI-Anbieter ist verbunden, nur das Skript wurde geschrieben; nach Verbindung eines Anbieters kann es erneut versucht werden. |
rate_limited | 429 | Das Stundenlimit ist erreicht; versuchen Sie es nach retry_after Sekunden erneut. |
reference_required · reference · character_required · language · formats | 422 | Quelle, Charakter, Sprache oder Format, die das Rezept braucht, fehlen oder sind ungültig; hint in der Antwort sagt, was zu tun ist. |
rendering · in_use · active · not_ready | 409 | Ein Auftrag beim Anbieter lässt sich nicht stoppen; Inhalte in einer Kampagne oder in Produktion werden nicht gelöscht; eine nicht fertige Datei wird keiner Kampagne hinzugefügt. |
consent | 422 | Die Rechteerklärung (Produktseite) oder die Einwilligungserklärung (reale Person) fehlt. |
unsafe · unsafe_url | 422 | Interne oder lokale Adressen werden nicht gelesen; geben Sie eine öffentliche http(s)-Adresse an. |
Nächste Schritte
- Produktions-ToolsBilder, Videos, Sprachaufnahmen und Skripte: Angebot und Bestätigung, alle Rezepte, Bibliothek, Formatanpassung, Sendequalität, Freigabe-Links und Charaktere.
- API und ClientsAuthentifizierung per API-Schlüssel im Enterprise-Plan: Berechtigungen, Ratenlimits, OpenAPI-Referenz, Python- und JavaScript-Clients und die Anbindung mit den MCP-SDKs.
- Credits & NutzungJeder Tool-Aufruf verbraucht einige Credits: Lesen ist günstig, Live-Änderungen kosten mehr. 100 lebenslange Credits im Starter-Plan, monatlich erneuerte Credits in bezahlten Plänen; fehlgeschlagene Aufrufe werden erstattet.