Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Negocio local y contenido

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éditos

Biblioteca 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ámetroTipoDescripción
production_idOpcionalstringone production with its full details (script, review, results)
statusOpcionalqueued | rendering | ready | needs_provider | failed | cancelled | draft—
kindOpcionalugc_video | short_video | image | voice | script—
searchOpcionalstringtext in the title or request
favoriteOpcionalbooleanonly starred productions
group_idOpcionalstringone variation group (batch.group of an item)
limitOpcionalinteger (1–60)newest first (default 10)
offsetOpcionalinteger (0–…)next_offset of the previous page

get_production_options

Lectura0 créditos

Opciones 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ámetroTipoDescripción
topicOpcionaloverview | characters | videos | formats—
platformOpcionalstringtopic=formats: meta | google | tiktok | linkedin | …
typeOpcionalimage | videotopic=formats

get_production_quote

Lectura0 créditos

Lee un presupuesto de producción: estado (abierto, aprobado, caducado, cancelado), precio, qué producirá, validez y la producción que inició. Solo lectura, gratis.

ParámetroTipoDescripción
quote_idObligatoriostring—

production_preflight

Lectura0 créditos

Revisió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ámetroTipoDescripción
production_idObligatoriostringproduction id (from list_productions or quote/start results)
format_idOpcionalinteger (1–…)ad placement to check against
profileOpcionaltv_pal | tv_ntsc | ctvbroadcast profile to check against

get_production_masters

Lectura0 créditos

Copias 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ámetroTipoDescripción
production_idObligatoriostringready video

get_production_film

Lectura0 créditos

Escenas de un vídeo de marca (clips guardados), opciones de montaje e información de versiones. Solo lectura, gratis.

ParámetroTipoDescripción
production_idObligatoriostringbrand film

get_production_share

Lectura0 créditos

Estado 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ámetroTipoDescripción
production_idObligatoriostringproduction id (from list_productions or quote/start results)

get_production_wallet

Lectura0 créditos

Modo 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ámetroTipoDescripción
ledger_limitOpcionalinteger (1–200)—
beforeOpcionalinteger (1–…)next_before of the previous page

get_production_download

Lectura0 créditos

Direcció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ámetroTipoDescripción
production_idObligatoriostringready production
formatOpcionalpng | jpg | webpimages: converted copy in this type

Herramientas de escritura19 herramientas

suggest_production_hooks

Escritura1 créditos

5–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ámetroTipoDescripción
kindObligatoriougc_video | short_video | image—
briefObligatoriostring—

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éditos

Paso 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ámetroTipoDescripción
kindOpcionalugc_video | short_video | image | voice | scriptwhat is produced (with like_production_id it may be omitted)
briefOpcionalstringwhat to produce: product / service, message, audience, style; for recipe=edit the change to make
titleOpcionalstring—
recipeOpcionalproduct | edit | persona | influencer | avatar | film | scene | dubbing | packready-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)
tierOpcionalstringquality 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)
resolutionOpcional1K | 2K | 4Kimages only
aspectOpcional1:1 | 4:5 | 3:4 | 2:3 | 9:16 | 16:9 | 3:2 | 4:3images: all; videos: 9:16 / 16:9
styleOpcionalstudio | lifestyle | outdoor | flatlay | handrecipe=product: scene preset
reference_idOpcionalstringproduction id of the source file (product photo, file to edit, video to dub, film)
character_idOpcionalstringrecipe=influencer / avatar: character id (get_production_options topic=characters)
scenesOpcionalinteger (0–12)film: scene count (0 = default)
captionsOpcionalbooleanfilm: on-screen captions (default true)
end_cardOpcionalbooleanfilm: closing card with logo (default true)
sceneOpcionalinteger (0–12)recipe=scene: number of the scene to regenerate (from 1)
languageOpcionaltr | en | de | es | fr | nl | pt | zh | pl | ja | ar | hi | it | ru | ko | bn | ur | id | vi | th | herecipe=dubbing: target language
formatsOpcionalarray<integer>recipe=pack: ad format ids (get_production_options topic=formats)
videoOpcionalbooleanrecipe=pack: also a short video from the main image
hookOpcionalstringopening line (suggest_production_hooks); recipe=scene + scene=1 changes only the film's opening
angleOpcionalproblem | moment | detail | directcreative angle (ignored with variations: each variation gets its own)
variationsOpcionalinteger (2–4)batch: N separate productions from one request, each with another angle; the TOTAL price is returned
hooksOpcionalarray<string>with variations: opening lines given to the variations in order
campaign_idOpcionalstringcampaign id or name to link the production to
like_production_idOpcionalstring"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éditos

Paso 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ámetroTipoDescripción
quote_idOpcionalstring—
quote_idsOpcionalarray<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éditos

Cancela 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ámetroTipoDescripción
production_idObligatoriostringproduction 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éditos

Para 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ámetroTipoDescripción
production_idObligatoriostringproduction 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éditos

Elimina 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ámetroTipoDescripción
production_idOpcionalstringproduction id (from list_productions or quote/start results)
production_idsOpcionalarray<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éditos

Marca o desmarca una producción con estrella (filtro de favoritos de list_productions y del panel).

ParámetroTipoDescripción
production_idObligatoriostringproduction id (from list_productions or quote/start results)
favoriteObligatorioboolean—

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éditos

Empezar 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ámetroTipoDescripción
urlObligatoriostringpublic product page (http / https)
confirm_rightsObligatoriobooleanthe 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éditos

Añ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ámetroTipoDescripción
image_base64OpcionalstringPNG / JPEG / WEBP, optionally a data: URL
source_urlOpcionalstringpublic http(s) image address to copy instead
titleOpcionalstring—

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éditos

Adapta 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ámetroTipoDescripción
production_idObligatoriostringready image to adapt
formatsObligatorioarray<integer>ad format ids (get_production_options topic=formats)
headlineOpcionalstring—
ctaOpcionalstring—
logoOpcionalbooleanbrand 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éditos

Solicita 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ámetroTipoDescripción
production_idObligatoriostringready video
profileObligatoriotv_pal | tv_ntsc | ctv—
codecObligatorioprores | h264prores = ProRes 422 HQ .mov · h264 = H.264 High .mp4
secondsOpcionalinteger (0–60)exact spot length (0 = the source's length)
pillarboxOpcionalbooleanfit 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éditos

Elimina de forma permanente una copia máster y su archivo. No se puede deshacer: solo cuando el usuario lo pida explícitamente.

ParámetroTipoDescripción
master_idObligatoriostringmaster 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éditos

Vuelve 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ámetroTipoDescripción
production_idObligatoriostringbrand film
orderOpcionalarray<integer>new scene order: every scene number once
captionsOpcionalboolean—
end_cardOpcionalboolean—

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éditos

Crea 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ámetroTipoDescripción
production_idObligatoriostringready image or video
daysOpcionalinteger (1–90)link lifetime in days (default 14)
scopeOpcionalsingle | groupsingle = 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éditos

Cierra 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ámetroTipoDescripción
production_idObligatoriostringproduction 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éditos

Guarda 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ámetroTipoDescripción
nameObligatoriostring—
typeObligatoriovirtual | realvirtual = AI influencer · real = a real person (AI avatar)
image_idObligatoriostringready face image in the library (generated portrait or uploaded photo)
descriptionOpcionalstring—
consentOpcionalobjectrequired 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éditos

Elimina 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ámetroTipoDescripción
character_idObligatoriostring—

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éditos

Fija 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ámetroTipoDescripción
monthly_limitOpcionalnumber (0–1000000)USD per month
clearOpcionalbooleanremove 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éditos

Convierte 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ámetroTipoDescripción
production_idObligatoriostringready file (or a script for a text card)
campaignObligatoriostringcampaign id or name

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.