Produktions-Tools
Bilder, Videos, Sprachaufnahmen und Skripte: Angebot und Bestätigung, alle Rezepte, Bibliothek, Formatanpassung, Sendequalität, Freigabe-Links und Charaktere.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.
Lese-Tools9 Tools
list_productions
Lesen0 CreditsProduktionsbibliothek: Bilder, Videos, Sprachaufnahmen und Skripte (erzeugt, hochgeladen, an Formate angepasst) mit Status, Dateiadresse wenn fertig, Hook und CTA, Wartegrund, Restzeit laufender Aufträge, Wiederholbarkeit fehlgeschlagener Aufträge, Favorit, Rezept, Variantengruppe und Vergleich, Prüfentscheidung und Kommentarzahl sowie Kampagnenergebnis bei Nutzung in Anzeigen. Filter nach Status, Art, Text, Favoriten oder Gruppe; mit Seiten. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idOptional | string | one production with its full details (script, review, results) |
statusOptional | queued | rendering | ready | needs_provider | failed | cancelled | draft | — |
kindOptional | ugc_video | short_video | image | voice | script | — |
searchOptional | string | text in the title or request |
favoriteOptional | boolean | only starred productions |
group_idOptional | string | one variation group (batch.group of an item) |
limitOptional | integer (1–60) | newest first (default 10) |
offsetOptional | integer (0–…) | next_offset of the previous page |
get_production_options
Lesen0 CreditsOptionen des Produktionsbildschirms: offene Arten und Rezepte, Engine und Preis jeder Art je Qualitätsstufe (Plan-Credits oder USD-Guthaben), Abrechnungsart und Rest, Auflösungen, Seitenverhältnisse, Stile und Sprachen; topic=characters gespeicherte Charaktere, topic=videos synchronisierbare Videos, topic=formats Formate der Werbeplatzierungen. Vor einem Angebot aufrufen statt Preise zu raten. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
topicOptional | overview | characters | videos | formats | — |
platformOptional | string | topic=formats: meta | google | tiktok | linkedin | … |
typeOptional | image | video | topic=formats |
get_production_quote
Lesen0 CreditsLiest ein Produktionsangebot: Status (offen, bestätigt, abgelaufen, storniert), Preis, was es produziert, Gültigkeit und die gestartete Produktion. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
quote_idPflicht | string | — |
production_preflight
Lesen0 CreditsPrüfung einer fertigen Datei vor der Veröffentlichung: Ohne Ziel listet sie Platzierungen und Sendeprofile; mit format_id oder profile misst sie die Datei selbst (Seitenverhältnis, Auflösung, Länge, Größe, Ton und Lautheit, Untertitel und sicherer Bereich, Handlungsaufforderung, Einstieg, KI-Kennzeichnung) und liefert bestanden / Hinweis / nicht bestanden. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | production id (from list_productions or quote/start results) |
format_idOptional | integer (1–…) | ad placement to check against |
profileOptional | tv_pal | tv_ntsc | ctv | broadcast profile to check against |
get_production_masters
Lesen0 CreditsMasterkopien in Sendequalität eines fertigen Videos: verfügbare Profile (TV PAL 1080p25 −23 LUFS, TV NTSC 1080p29,97 −24 LKFS, Connected TV), Codecs, zulässige Längen, Messwerte der Quelle und erstellte Kopien mit technischen Berichten. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | ready video |
get_production_film
Lesen0 CreditsSzenen eines Markenfilms (gespeicherte Clips), Schnittoptionen und Versionsinfo. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | brand film |
get_production_share
Lesen0 CreditsPrüfstatus einer Produktion: letzter Prüf-Link (Ablauf, Umfang), Entscheidung der Prüfenden (offen, freigegeben, Änderungen gewünscht) und ihre Kommentare. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | production id (from list_productions or quote/start results) |
get_production_wallet
Lesen0 CreditsAbrechnungsart der Produktion (Plan-Credits oder USD-Guthaben), verbleibende Credits, Produktionsguthaben mit reserviertem Betrag und Monatslimit, Ausgaben des Monats und Guthabenbuchungen (mit Seiten). Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
ledger_limitOptional | integer (1–200) | — |
beforeOptional | integer (1–…) | next_before of the previous page |
get_production_download
Lesen0 CreditsDownload-Adresse einer fertigen Datei. Ohne format: die Adresse der Originaldatei; mit format (nur Bilder): eine PNG- / JPG- / WEBP-Kopie unter einer signierten Adresse, die nach Minuten abläuft. Nur lesend, kostenlos.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | ready production |
formatOptional | png | jpg | webp | images: converted copy in this type |
Schreib-Tools19 Tools
suggest_production_hooks
Schreiben1 Credits5–8 Vorschläge für den Einstiegssatz (Hook) der ersten Videosekunden oder die Überschrift eines Bildes, aus Markenprofil und Briefing; ohne Textmodell regelbasierte Muster, nie erfundene Behauptungen. Den gewählten Satz an quote_production hook (bei Varianten hooks) übergeben. Erzeugt nichts.
| Parameter | Typ | Beschreibung |
|---|---|---|
kindPflicht | ugc_video | short_video | image | — |
briefPflicht | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
quote_production
Schreiben0 CreditsSchritt 1 einer Produktion: ein ANGEBOT für alles, was der Produktionsbildschirm erstellt — Bild, Kurz- / UGC-Video, Sprachaufnahme, Skript und alle Rezepte (Produktfoto, Bearbeitung, Persona, KI-Influencer, KI-Avatar, Markenfilm, einzelne Szene, Synchronisation, Kampagnenpaket), mit Qualitätsstufe, Seitenverhältnis, Auflösung, Quelldatei, Charakter, Einstiegssatz und 2–4 Varianten. Liefert, was produziert wird, den Preis (Plan-Credits oder USD-Guthaben; derselbe Preis wie im Dashboard) und die Gültigkeit. Hier wird NICHTS produziert oder berechnet: Zeigen Sie dem Nutzer den Preis, warten Sie auf seine ausdrückliche Bestätigung und rufen Sie dann start_production mit der Angebots-ID auf.
| Parameter | Typ | Beschreibung |
|---|---|---|
kindOptional | ugc_video | short_video | image | voice | script | what is produced (with like_production_id it may be omitted) |
briefOptional | string | what to produce: product / service, message, audience, style; for recipe=edit the change to make |
titleOptional | string | — |
recipeOptional | product | edit | persona | influencer | avatar | film | scene | dubbing | pack | ready-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) |
tierOptional | string | quality 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) |
resolutionOptional | 1K | 2K | 4K | images only |
aspectOptional | 1:1 | 4:5 | 3:4 | 2:3 | 9:16 | 16:9 | 3:2 | 4:3 | images: all; videos: 9:16 / 16:9 |
styleOptional | studio | lifestyle | outdoor | flatlay | hand | recipe=product: scene preset |
reference_idOptional | string | production id of the source file (product photo, file to edit, video to dub, film) |
character_idOptional | string | recipe=influencer / avatar: character id (get_production_options topic=characters) |
scenesOptional | integer (0–12) | film: scene count (0 = default) |
captionsOptional | boolean | film: on-screen captions (default true) |
end_cardOptional | boolean | film: closing card with logo (default true) |
sceneOptional | integer (0–12) | recipe=scene: number of the scene to regenerate (from 1) |
languageOptional | tr | en | de | es | fr | nl | pt | zh | pl | ja | ar | hi | it | ru | ko | bn | ur | id | vi | th | he | recipe=dubbing: target language |
formatsOptional | array<integer> | recipe=pack: ad format ids (get_production_options topic=formats) |
videoOptional | boolean | recipe=pack: also a short video from the main image |
hookOptional | string | opening line (suggest_production_hooks); recipe=scene + scene=1 changes only the film's opening |
angleOptional | problem | moment | detail | direct | creative angle (ignored with variations: each variation gets its own) |
variationsOptional | integer (2–4) | batch: N separate productions from one request, each with another angle; the TOTAL price is returned |
hooksOptional | array<string> | with variations: opening lines given to the variations in order |
campaign_idOptional | string | campaign id or name to link the production to |
like_production_idOptional | string | "more like this": copy the settings (kind, brief, recipe, character, tier, style, aspect, hook, angle) of this production; given arguments override them |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
start_production
SchreibenUnumkehrbar0 CreditsSchritt 2: startet die Produktion eines Angebots, das der Nutzer nach Ansicht des Preises BESTÄTIGT hat. Der Betrag wird vom Guthaben reserviert oder Plan-Credits werden verbraucht (wie "Bestätigen und produzieren" im Dashboard); reichen Credits oder Guthaben nicht, startet nichts (credits_exhausted / insufficient_balance mit dem benötigten Betrag). Nur aufrufen, wenn der Nutzer ausdrücklich fortfahren will. Dasselbe Angebot startet nie zweimal. Liefert die Produktion (wartend / in Arbeit / fertig); Dateien dauern Minuten — mit list_productions prüfen.
| Parameter | Typ | Beschreibung |
|---|---|---|
quote_idOptional | string | — |
quote_idsOptional | array<string> | all quotes of one variation group, started with one confirmation |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
cancel_production
Schreiben0 CreditsBricht eine wartende Produktion ab, die den Anbieter noch nicht erreicht hat; ein reservierter Betrag wird freigegeben. Eine Datei, die der Anbieter bereits erzeugt, lässt sich nicht stoppen (Fehler rendering).
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | production id (from list_productions or quote/start results) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
retry_production
Schreiben0 CreditsFür eine fehlgeschlagene oder abgebrochene Produktion: ein NEUES Angebot mit denselben Einstellungen zum heutigen Preis. Berechnet nichts; nach Preisbestätigung des Nutzers mit start_production starten.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | production id (from list_productions or quote/start results) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_production
SchreibenUnumkehrbar0 CreditsLöscht Produktionen und ihre Dateien (samt Formatversionen) dauerhaft. Nicht rückgängig zu machen — nur wenn der Nutzer das Löschen dieser Dateien ausdrücklich verlangt. Eine in einer Kampagne genutzte (in_use) oder noch laufende (active) Datei wird nicht gelöscht; das Ergebnis listet jede einzeln.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idOptional | string | production id (from list_productions or quote/start results) |
production_idsOptional | array<string> | several productions at once (up to 24) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_production_favorite
Schreiben0 CreditsMarkiert eine Produktion mit einem Stern oder entfernt ihn (Favoritenfilter von list_productions und Dashboard).
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | production id (from list_productions or quote/start results) |
favoritePflicht | boolean | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
import_production_from_url
Schreiben1 CreditsStart von einer Produktseite: Der Server liest die Seite sicher (nur http(s), internes Netz gesperrt, Weiterleitungen neu geprüft, Größe begrenzt) und liefert Titel, Beschreibung und Preis; das Hauptbild wird als Produktfoto in der Bibliothek gespeichert. Der Nutzer muss die Rechte am Inhalt bestätigen (confirm_rights=true); die Bestätigung wird gespeichert. Das Bild als reference_id in quote_production verwenden. 1 Credit.
| Parameter | Typ | Beschreibung |
|---|---|---|
urlPflicht | string | public product page (http / https) |
confirm_rightsPflicht | boolean | the user confirmed they may use the page's text and image |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
upload_production_image
Schreiben1 CreditsFügt ein eigenes Bild des Nutzers der Produktionsbibliothek hinzu: Der Typ wird anhand der Bytes geprüft, das Bild neu kodiert und Standortdaten (EXIF) entfernt; PNG, JPEG oder WEBP bis 12 MB. Von einer Adresse werden nur öffentliche Adressen gelesen (interne abgelehnt). Als reference_id oder mit adapt_production_formats verwenden. 1 Credit.
| Parameter | Typ | Beschreibung |
|---|---|---|
image_base64Optional | string | PNG / JPEG / WEBP, optionally a data: URL |
source_urlOptional | string | public http(s) image address to copy instead |
titleOptional | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
adapt_production_formats
Schreiben0 CreditsPasst ein fertiges Bild an die Seitenverhältnisse gewählter Werbeplatzierungen an (bis zu 12); Überschrift, Handlungsaufforderung und Logo bleiben im sicheren Bereich. Jede Version wird eine Datei in der Bibliothek. Kostenlos, auf unserem eigenen Server.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | ready image to adapt |
formatsPflicht | array<integer> | ad format ids (get_production_options topic=formats) |
headlineOptional | string | — |
ctaOptional | string | — |
logoOptional | boolean | brand logo in the safe area (default true) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_production_master
Schreiben0 CreditsFordert eine Sende-Masterkopie eines fertigen Videos mit technischem Bericht an (auf unserem Server kodiert, kostenlos, ratenbegrenzt). Nur technische Vorbereitung: keine Garantie für die Annahme durch einen Sender; Interlaced und XDCAM MXF werden nicht erzeugt.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | ready video |
profilePflicht | tv_pal | tv_ntsc | ctv | — |
codecPflicht | prores | h264 | prores = ProRes 422 HQ .mov · h264 = H.264 High .mp4 |
secondsOptional | integer (0–60) | exact spot length (0 = the source's length) |
pillarboxOptional | boolean | fit a vertical / square source into 16:9 with black side bars |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_production_master
SchreibenUnumkehrbar0 CreditsLöscht eine Masterkopie und ihre Datei dauerhaft. Nicht rückgängig zu machen — nur wenn der Nutzer es ausdrücklich verlangt.
| Parameter | Typ | Beschreibung |
|---|---|---|
master_idPflicht | string | master copy id (get_production_masters) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
edit_production_film
Schreiben0 CreditsSchneidet einen Markenfilm neu: Szenenfolge, Untertitel, Abschlusskarte. Kostenlos, auf unserem Server; erzeugt eine neue Version und behält die alte. Eine einzelne Szene neu zu erzeugen ist kostenpflichtig und läuft über quote_production recipe=scene.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | brand film |
orderOptional | array<integer> | new scene order: every scene number once |
captionsOptional | boolean | — |
end_cardOptional | boolean | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_production_share
Schreiben0 CreditsErstellt einen befristeten Prüf-Link (1–90 Tage), den Kunden oder Team ohne Konto öffnen: kommentieren, freigeben oder Änderungen anfordern. Die Adresse wird nur einmal zurückgegeben; frühere Links der Produktion werden geschlossen.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | ready image or video |
daysOptional | integer (1–90) | link lifetime in days (default 14) |
scopeOptional | single | group | single = this production · group = its whole variation group |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
revoke_production_share
SchreibenUnumkehrbar0 CreditsSchließt alle offenen Prüf-Links einer Produktion auf einmal; ein geschlossener Link lässt sich nicht wieder öffnen (einen neuen erstellen). Nur wenn der Nutzer es ausdrücklich verlangt.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | production id (from list_productions or quote/start results) |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_production_character
Schreiben0 CreditsSpeichert ein fertiges Gesichtsbild als Charakter für einheitliche Inhalte. type=virtual: ein KI-Influencer. type=real: der KI-Avatar einer realen Person — nur mit der Einwilligungserklärung, die der NUTZER in eigenen Worten abgibt (Name der Person, Grundlage: selbst oder schriftliche Erlaubnis, confirmed=true); nie im Namen des Nutzers ausfüllen. Die Erklärung wird mit Konto und Zeitpunkt gespeichert.
| Parameter | Typ | Beschreibung |
|---|---|---|
namePflicht | string | — |
typePflicht | virtual | real | virtual = AI influencer · real = a real person (AI avatar) |
image_idPflicht | string | ready face image in the library (generated portrait or uploaded photo) |
descriptionOptional | string | — |
consentOptional | object | required for type=real |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
delete_production_character
SchreibenUnumkehrbar0 CreditsLöscht einen Charakter (bei einer realen Person der Widerruf der Einwilligung). Nicht rückgängig zu machen — nur wenn der Nutzer es ausdrücklich verlangt; erzeugte Dateien bleiben.
| Parameter | Typ | Beschreibung |
|---|---|---|
character_idPflicht | string | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
set_production_monthly_limit
Schreiben0 CreditsSetzt oder entfernt das monatliche Ausgabenlimit des Produktionsguthabens (USD). Produktionen, die es überschreiten würden, werden abgelehnt (monthly_limit). Nur auf Wunsch des Nutzers.
| Parameter | Typ | Beschreibung |
|---|---|---|
monthly_limitOptional | number (0–1000000) | USD per month |
clearOptional | boolean | remove the limit |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
add_production_to_campaign
Schreiben0 CreditsMacht eine Produktion zum Creative einer Kampagne (Entwurfs-Creative-Karte). Bei Meta und Google wird die Datei bei Veröffentlichung der Kampagne verwendet; eine laufende Anzeige ändert sich nicht von selbst. Die Produktionskarte zeigt danach die Kampagnenergebnisse.
| Parameter | Typ | Beschreibung |
|---|---|---|
production_idPflicht | string | ready file (or a script for a text card) |
campaignPflicht | string | campaign id or name |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.