Zum Inhalt springen
Tecrübetecrube.com
Erste Schritte

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 Header Authorization: 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.

FunktionIm DashboardMCP-ToolREST-Endpunkt
Arten, Rezepte, Qualitätsstufen und PreiseFormular für neue Produktionget_production_optionsGET /production/overview · GET /production/formats
Vorschläge für den Einstieg (Hook)Formular › Einstiegsvorschlägesuggest_production_hooksPOST /production/hooks
Angebot: was, zu welchem Preis, bis wannPreis ansehenquote_productionPOST /production/quotes
Varianten (2–4)Formular › Anzahl der Variantenquote_production variationsPOST /production/quotes/batch
Angebot lesenAngebotskarteget_production_quoteGET /production/quotes/{id}
Bestätigtes Angebot startenBestätigen und produzierenstart_productionPOST /production/jobs · POST /production/jobs/batch
Einfache Produktion in einem Schritt (ohne Bestätigung)—generate_content—
Bibliothek: Suche, Filter, SeitenReiter Produktionenlist_productionsGET /production/jobs
Alles zu einer ProduktionProduktionskartelist_productions production_idGET /production/jobs/{id}
Wartenden Auftrag abbrechenKarte › Abbrechencancel_productionPOST /production/jobs/{id}/cancel
Fehlgeschlagenen Auftrag mit denselben Einstellungen wiederholenKarte › Erneut versuchenretry_productionPOST /production/jobs/{id}/retry
FavoritKarte › Sternset_production_favoritePUT /production/jobs/{id}/favorite
Löschen (auch mehrere)Karte › Löschen · Auswählen › Auswahl löschendelete_productionDELETE /production/jobs/{id}
Download (PNG / JPG / WEBP)Karte › Herunterladenget_production_downloadGET /production/jobs/{id}/download
Mit einer Produktseite beginnenMit Produktseite startenimport_production_from_urlPOST /production/import-url
Eigenes Bild hochladenBild hochladenupload_production_imagePOST /production/assets
An Werbeformate anpassenKarte › An Formate anpassenadapt_production_formatsPOST /production/jobs/{id}/formats
Prüfung vor der VeröffentlichungKarte › Prüfung vor Veröffentlichungproduction_preflightGET /production/jobs/{id}/preflight
Masterkopie für TV / Connected TVKarte › Sendequalitätget_production_masters · create_production_master · delete_production_masterGET / POST /production/jobs/{id}/masters · DELETE /production/masters/{id}
Szenen des Markenfilms und NeuschnittKarte › Szenen bearbeitenget_production_film · edit_production_filmGET /production/jobs/{id}/film · POST /production/jobs/{id}/film/edit
Eine einzelne Szene neu erzeugenSzenen › Diese Szene neu erzeugenquote_production recipe: scenePOST /production/quotes recipe: scene
Mehr davonWerbeergebnis › Mehr davonquote_production like_production_idGET /production/jobs/{id} → POST /production/quotes (hook, angle)
Prüf-Link, Entscheidung und KommentareKarte › Teilencreate_production_share · get_production_share · revoke_production_sharePOST / GET / DELETE /production/jobs/{id}/share
Charaktere (KI-Influencer, KI-Avatar)Reiter Charaktereget_production_options topic: characters · create_production_character · delete_production_characterGET / POST /production/characters · DELETE /production/characters/{id}
Guthaben, Credits und BuchungenGuthaben-Boxget_production_walletGET /production/wallet · GET /production/wallet/ledger
Monatliches AusgabenlimitGuthaben › Monatslimitset_production_monthly_limitPUT /production/wallet/limit
Produktion zu einer Kampagne hinzufügenChat · Kampagnen-Creativesadd_production_to_campaignPOST /production/jobs/{id}/campaign
Werbeergebnis und beste VarianteKarte › Werbeergebnis · Variantenlist_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.

RezeptErgebnisArt (`kind`)Benötigt
—Grundarten: Bild, Kurzvideo, UGC-Video, Sprachaufnahme, Skript.image · short_video · ugc_video · voice · scriptbrief
productBild oder Video aus einem Produktfoto; das Produkt bleibt, die Szene (style) ändert sich.image · short_video · ugc_videoreference_id, style
editNeue Version einer fertigen Datei; brief ist die gewünschte Änderung.image · short_video · ugc_videoreference_id, brief
personaKI-Porträt, das als Charakter gespeichert wird.imagebrief
influencerEinheitliche Inhalte mit einem gespeicherten virtuellen Charakter.image · short_video · ugc_videocharacter_id (virtual)
avatarInhalte mit dem Charakter einer realen Person mit Einwilligung.image · short_video · ugc_videocharacter_id (real)
filmMarkenfilm mit mehreren Szenen, Untertiteln und Abschlusskarte mit Logo.short_videoscenes, captions, end_card
sceneEine Szene eines fertigen Films; nur diese Szene wird berechnet, scene: 1 + hook ändert nur den Einstieg.short_videoreference_id, scene, hook
dubbingEin fertiges Video in einer anderen Sprache.short_video · ugc_videoreference_id, language
packWerbeformate aus einem Hauptbild und optional ein Kurzvideo.imageformats, video

Komplett mit MCP

Natürliche Sprache genügt; der Assistent arbeitet in dieser Reihenfolge.

  1. Optionen: get_production_options liest Arten, Stufen und Preise (keine erfundenen Zahlen).
  2. Angebot: quote_production nennt, was produziert wird, und den Preis. Nichts wird produziert, keine Credits werden verbraucht.
  3. Bestätigung: Der Assistent zeigt Ihnen den Preis und wartet auf Ihre Zustimmung.
  4. Start: Nach Ihrer Bestätigung startet start_production das Angebot; der Preis wird in diesem Schritt reserviert.
  5. Status und Datei: list_productions liefert den Status und die Adresse der fertigen Datei; get_production_download erstellt 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
// 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" }

Rezeptbeispiele (MCP-Argumente)

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

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

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"

Beispiele weiterer Endpunkte

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>"}'

Preise und Credits

  • Abrechnungsart: Produktionen werden entweder mit Plan-Credits (pricing: credits) oder mit dem Produktionsguthaben (pricing: balance, USD) bezahlt; die aktive Art steht in get_production_options und GET /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_production und retry_production erstellen nur ein Angebot; sie produzieren und berechnen nichts.
  • start_production reserviert 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-Key dasselbe 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_id oder profile wird 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 liefern get_production_options oder GET /production/overview › tiers mit engine_name. Eine deaktivierte Engine wird mit engine_unavailable abgelehnt 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.
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 } }

Grenzen

ThemaGrenze
Bild-UploadPNG, 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
Varianten2–4 (die Plattformverwaltung kann das Maximum senken)
Einstiegsvorschläge5–8 pro Aufruf
FormatanpassungBis zu 12 Formate pro Anfrage
Mehrfach löschen (MCP)Bis zu 24 Produktionen pro Aufruf
Prüf-Link1–90 Tage (Standard 14)
MarkenfilmBis zu 12 Szenen; bis zu 12 Versionen pro Produktion
Sende-MasterkopieSpotlä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
CharaktereBis 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

CodeRESTBedeutung und was zu tun ist
credits_exhausted402Die Plan-Credits decken diesen Auftrag nicht; die Antwort nennt needed und remaining. Upgraden Sie oder kaufen Sie Zusatz-Credits auf dem Plan-Bildschirm.
insufficient_balance402Das Produktionsguthaben reicht nicht; laden Sie es auf dem Produktionsbildschirm auf.
monthly_limit402Ihr Monatslimit würde überschritten; ändern Sie es oder warten Sie auf den nächsten Monat.
quote_expired · quote_cancelled410 · 409Das Angebot ist abgelaufen oder storniert; holen Sie ein neues ein (der Preis kann sich geändert haben).
not_found404Die 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_only403Ein 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_limited429Das Stundenlimit ist erreicht; versuchen Sie es nach retry_after Sekunden erneut.
reference_required · reference · character_required · language · formats422Quelle, 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_ready409Ein 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.
consent422Die Rechteerklärung (Produktseite) oder die Einwilligungserklärung (reale Person) fehlt.
unsafe · unsafe_url422Interne oder lokale Adressen werden nicht gelesen; geben Sie eine öffentliche http(s)-Adresse an.

Nächste Schritte