Herramientas de producción
Imágenes, vídeos, locuciones y guiones: presupuesto y confirmación, todas las recetas, biblioteca, adaptación a formatos, calidad de emisión, enlaces de revisión y personajes.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura9 herramientas
list_productions
Lectura0 créditosBiblioteca de producción: imágenes, vídeos, locuciones y guiones (generados, subidos, adaptados a formatos) con estado, dirección del archivo cuando está listo, apertura y llamada a la acción, motivo de espera, tiempo restante de un trabajo en curso, si un trabajo fallido se puede reintentar, favorito, receta, grupo de variaciones y su comparación, decisión de revisión y número de comentarios, y resultado de la campaña si se usó en anuncios. Filtra por estado, tipo, texto, favoritos o grupo; paginado. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idOpcional | string | one production with its full details (script, review, results) |
statusOpcional | queued | rendering | ready | needs_provider | failed | cancelled | draft | — |
kindOpcional | ugc_video | short_video | image | voice | script | — |
searchOpcional | string | text in the title or request |
favoriteOpcional | boolean | only starred productions |
group_idOpcional | string | one variation group (batch.group of an item) |
limitOpcional | integer (1–60) | newest first (default 10) |
offsetOpcional | integer (0–…) | next_offset of the previous page |
get_production_options
Lectura0 créditosOpciones de la pantalla Producción: tipos y recetas abiertos, motor y precio de cada tipo por nivel de calidad (créditos del plan o saldo en USD), modo de cobro y lo que queda, resoluciones, proporciones, estilos e idiomas; topic=characters personajes guardados, topic=videos vídeos que se pueden doblar, topic=formats formatos de ubicaciones publicitarias. Llámela antes de presupuestar en lugar de adivinar precios. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
topicOpcional | overview | characters | videos | formats | — |
platformOpcional | string | topic=formats: meta | google | tiktok | linkedin | … |
typeOpcional | image | video | topic=formats |
get_production_quote
Lectura0 créditosLee un presupuesto de producción: estado (abierto, aprobado, caducado, cancelado), precio, qué producirá, validez y la producción que inició. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
quote_idObligatorio | string | — |
production_preflight
Lectura0 créditosRevisión previa de un archivo listo: sin objetivo lista las ubicaciones y perfiles de emisión; con format_id o profile mide el propio archivo (proporción, resolución, duración, tamaño, audio y sonoridad, subtítulos y zona segura, llamada a la acción, apertura, aviso de IA) y devuelve aprobado / atención / no aprobado. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | production id (from list_productions or quote/start results) |
format_idOpcional | integer (1–…) | ad placement to check against |
profileOpcional | tv_pal | tv_ntsc | ctv | broadcast profile to check against |
get_production_masters
Lectura0 créditosCopias máster con calidad de emisión de un vídeo listo: perfiles disponibles (TV PAL 1080p25 −23 LUFS, TV NTSC 1080p29,97 −24 LKFS, TV conectada), códecs, duraciones permitidas, mediciones de la fuente y copias hechas con sus informes técnicos. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | ready video |
get_production_film
Lectura0 créditosEscenas de un vídeo de marca (clips guardados), opciones de montaje e información de versiones. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | brand film |
get_production_share
Lectura0 créditosEstado de revisión de una producción: su último enlace de revisión (caducidad, alcance), la decisión de los revisores (pendiente, aprobado, cambios solicitados) y sus comentarios. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | production id (from list_productions or quote/start results) |
get_production_wallet
Lectura0 créditosModo de cobro de producción (créditos del plan o saldo en USD), créditos restantes, saldo de producción con importe reservado y límite mensual, gasto del mes y movimientos del saldo (paginados). Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
ledger_limitOpcional | integer (1–200) | — |
beforeOpcional | integer (1–…) | next_before of the previous page |
get_production_download
Lectura0 créditosDirección de descarga de un archivo listo. Sin format: la dirección del archivo original; con format (solo imágenes): una copia PNG / JPG / WEBP en una dirección firmada que caduca en minutos. Solo lectura, gratis.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | ready production |
formatOpcional | png | jpg | webp | images: converted copy in this type |
Herramientas de escritura19 herramientas
suggest_production_hooks
Escritura1 créditos5–8 sugerencias de frase de apertura (hook) para los primeros segundos de un vídeo o el titular de una imagen, a partir del perfil de marca y la petición; sin modelo de texto devuelve patrones basados en reglas, nunca afirmaciones inventadas. Pase la frase elegida a quote_production hook (hooks con variaciones). No produce nada.
| Parámetro | Tipo | Descripción |
|---|---|---|
kindObligatorio | ugc_video | short_video | image | — |
briefObligatorio | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
quote_production
Escritura0 créditosPaso 1 de una producción: un PRESUPUESTO para todo lo que hace la pantalla Producción — imagen, vídeo corto / UGC, locución, guion y todas las recetas (foto de producto, edición, persona, influencer IA, avatar IA, vídeo de marca, una escena, doblaje, paquete de campaña), con nivel de calidad, proporción, resolución, archivo de origen, personaje, frase de apertura y 2–4 variaciones. Devuelve qué se producirá, el precio (créditos del plan o saldo en USD; el mismo precio que en el panel) y su validez. Aquí NO se produce ni se cobra nada: muestre el precio al usuario, espere su confirmación explícita y luego llame a start_production con el id del presupuesto.
| Parámetro | Tipo | Descripción |
|---|---|---|
kindOpcional | ugc_video | short_video | image | voice | script | what is produced (with like_production_id it may be omitted) |
briefOpcional | string | what to produce: product / service, message, audience, style; for recipe=edit the change to make |
titleOpcional | string | — |
recipeOpcional | 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) |
tierOpcional | 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) |
resolutionOpcional | 1K | 2K | 4K | images only |
aspectOpcional | 1:1 | 4:5 | 3:4 | 2:3 | 9:16 | 16:9 | 3:2 | 4:3 | images: all; videos: 9:16 / 16:9 |
styleOpcional | studio | lifestyle | outdoor | flatlay | hand | recipe=product: scene preset |
reference_idOpcional | string | production id of the source file (product photo, file to edit, video to dub, film) |
character_idOpcional | string | recipe=influencer / avatar: character id (get_production_options topic=characters) |
scenesOpcional | integer (0–12) | film: scene count (0 = default) |
captionsOpcional | boolean | film: on-screen captions (default true) |
end_cardOpcional | boolean | film: closing card with logo (default true) |
sceneOpcional | integer (0–12) | recipe=scene: number of the scene to regenerate (from 1) |
languageOpcional | 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 |
formatsOpcional | array<integer> | recipe=pack: ad format ids (get_production_options topic=formats) |
videoOpcional | boolean | recipe=pack: also a short video from the main image |
hookOpcional | string | opening line (suggest_production_hooks); recipe=scene + scene=1 changes only the film's opening |
angleOpcional | problem | moment | detail | direct | creative angle (ignored with variations: each variation gets its own) |
variationsOpcional | integer (2–4) | batch: N separate productions from one request, each with another angle; the TOTAL price is returned |
hooksOpcional | array<string> | with variations: opening lines given to the variations in order |
campaign_idOpcional | string | campaign id or name to link the production to |
like_production_idOpcional | string | "more like this": copy the settings (kind, brief, recipe, character, tier, style, aspect, hook, angle) of this production; given arguments override them |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
start_production
EscrituraIrreversible0 créditosPaso 2: inicia la producción de un presupuesto que el usuario CONFIRMÓ tras ver su precio. El importe se reserva del saldo o se usan créditos del plan (igual que "Confirmar y producir" en el panel); si los créditos o el saldo no alcanzan no empieza nada (credits_exhausted / insufficient_balance con el importe necesario). Llámela solo cuando el usuario pida continuar de forma explícita. El mismo presupuesto nunca se inicia dos veces. Devuelve la producción (en cola / en curso / lista); los archivos tardan minutos, compruébelos con list_productions.
| Parámetro | Tipo | Descripción |
|---|---|---|
quote_idOpcional | string | — |
quote_idsOpcional | array<string> | all quotes of one variation group, started with one confirmation |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
cancel_production
Escritura0 créditosCancela una producción en cola que aún no llegó al proveedor; el importe reservado se devuelve. Un archivo que el proveedor ya está generando no se puede detener (error rendering).
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | production id (from list_productions or quote/start results) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
retry_production
Escritura0 créditosPara una producción fallida o cancelada: un NUEVO presupuesto con los mismos ajustes al precio de hoy. No cobra nada; inícielo con start_production cuando el usuario confirme el precio.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | production id (from list_productions or quote/start results) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_production
EscrituraIrreversible0 créditosElimina de forma permanente producciones y sus archivos (con sus versiones de formato). No se puede deshacer: solo cuando el usuario pida explícitamente eliminar estos archivos. Un archivo usado en una campaña (in_use) o aún en producción (active) no se elimina; el resultado detalla cada uno.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idOpcional | string | production id (from list_productions or quote/start results) |
production_idsOpcional | array<string> | several productions at once (up to 24) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_production_favorite
Escritura0 créditosMarca o desmarca una producción con estrella (filtro de favoritos de list_productions y del panel).
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | production id (from list_productions or quote/start results) |
favoriteObligatorio | boolean | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
import_production_from_url
Escritura1 créditosEmpezar desde una página de producto: el servidor lee la página de forma segura (solo http(s), red interna cerrada, redirecciones revisadas, tamaño limitado) y devuelve título, descripción y precio; la imagen principal se guarda en la biblioteca como foto de producto. El usuario debe confirmar los derechos sobre el contenido (confirm_rights=true); la confirmación queda registrada. Use la imagen como reference_id en quote_production. 1 crédito.
| Parámetro | Tipo | Descripción |
|---|---|---|
urlObligatorio | string | public product page (http / https) |
confirm_rightsObligatorio | boolean | the user confirmed they may use the page's text and image |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_production_image
Escritura1 créditosAñade una imagen propia del usuario a la biblioteca de producción: el tipo se comprueba por sus bytes, se vuelve a codificar y se eliminan los datos de ubicación (EXIF); PNG, JPEG o WEBP hasta 12 MB. Desde una dirección solo se leen direcciones públicas (las internas se rechazan). Úsela como reference_id o con adapt_production_formats. 1 crédito.
| Parámetro | Tipo | Descripción |
|---|---|---|
image_base64Opcional | string | PNG / JPEG / WEBP, optionally a data: URL |
source_urlOpcional | string | public http(s) image address to copy instead |
titleOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
adapt_production_formats
Escritura0 créditosAdapta una imagen lista a las proporciones de las ubicaciones publicitarias elegidas (hasta 12); titular, llamada a la acción y logotipo quedan en la zona segura. Cada versión pasa a ser un archivo de la biblioteca. Gratis, en nuestro propio servidor.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | ready image to adapt |
formatsObligatorio | array<integer> | ad format ids (get_production_options topic=formats) |
headlineOpcional | string | — |
ctaOpcional | string | — |
logoOpcional | boolean | brand logo in the safe area (default true) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_production_master
Escritura0 créditosSolicita una copia máster de emisión de un vídeo listo con informe técnico (codificada en nuestro servidor, gratis, con límite de frecuencia). Es solo preparación técnica: no garantiza la aceptación de la emisora; no se producen entrelazado ni XDCAM MXF.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | ready video |
profileObligatorio | tv_pal | tv_ntsc | ctv | — |
codecObligatorio | prores | h264 | prores = ProRes 422 HQ .mov · h264 = H.264 High .mp4 |
secondsOpcional | integer (0–60) | exact spot length (0 = the source's length) |
pillarboxOpcional | boolean | fit a vertical / square source into 16:9 with black side bars |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_production_master
EscrituraIrreversible0 créditosElimina de forma permanente una copia máster y su archivo. No se puede deshacer: solo cuando el usuario lo pida explícitamente.
| Parámetro | Tipo | Descripción |
|---|---|---|
master_idObligatorio | string | master copy id (get_production_masters) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
edit_production_film
Escritura0 créditosVuelve a montar un vídeo de marca: orden de escenas, subtítulos, tarjeta de cierre. Gratis, en nuestro servidor; crea una nueva versión y conserva la anterior. Regenerar una sola escena tiene coste y pasa por quote_production recipe=scene.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | brand film |
orderOpcional | array<integer> | new scene order: every scene number once |
captionsOpcional | boolean | — |
end_cardOpcional | boolean | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_production_share
Escritura0 créditosCrea un enlace de revisión temporal (1–90 días) que clientes o equipo abren sin cuenta: comentan, aprueban o piden cambios. La dirección se devuelve una sola vez; se cierran los enlaces anteriores de la producción.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | ready image or video |
daysOpcional | integer (1–90) | link lifetime in days (default 14) |
scopeOpcional | single | group | single = this production · group = its whole variation group |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
revoke_production_share
EscrituraIrreversible0 créditosCierra de una vez todos los enlaces de revisión abiertos de una producción; un enlace cerrado no se puede reabrir (se crea uno nuevo). Solo cuando el usuario lo pida explícitamente.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | production id (from list_productions or quote/start results) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_production_character
Escritura0 créditosGuarda una imagen de rostro lista como personaje para contenido coherente. type=virtual: un influencer IA. type=real: el avatar IA de una persona real, solo con la declaración de consentimiento que el USUARIO da con sus propias palabras (nombre de la persona, base: uno mismo o permiso escrito, confirmed=true); nunca se rellena en nombre del usuario. La declaración se guarda con la cuenta y la hora.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
typeObligatorio | virtual | real | virtual = AI influencer · real = a real person (AI avatar) |
image_idObligatorio | string | ready face image in the library (generated portrait or uploaded photo) |
descriptionOpcional | string | — |
consentOpcional | object | required for type=real |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_production_character
EscrituraIrreversible0 créditosElimina un personaje (en una persona real, retira el consentimiento). No se puede deshacer: solo cuando el usuario lo pida explícitamente; los archivos producidos se conservan.
| Parámetro | Tipo | Descripción |
|---|---|---|
character_idObligatorio | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_production_monthly_limit
Escritura0 créditosFija o elimina el límite de gasto mensual del saldo de producción (USD). Las producciones que lo superarían se rechazan (monthly_limit). Solo si el usuario lo pide.
| Parámetro | Tipo | Descripción |
|---|---|---|
monthly_limitOpcional | number (0–1000000) | USD per month |
clearOpcional | boolean | remove the limit |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_production_to_campaign
Escritura0 créditosConvierte una producción en la creatividad de una campaña (tarjeta de creatividad en borrador). En Meta y Google el archivo se usa al publicar la campaña; un anuncio activo no cambia por sí solo. Después, la tarjeta de producción muestra los resultados de la campaña.
| Parámetro | Tipo | Descripción |
|---|---|---|
production_idObligatorio | string | ready file (or a script for a text card) |
campaignObligatorio | string | campaign id or name |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.