Referencia de herramientas
Rara vez llamas por su nombre: pregunta con palabras claras y tu asistente elige la herramienta. Las herramientas que hacen que un vídeo gasten créditos y devuelvan un job_id; el vídeo se renderiza en segundo plano y get_job_status te dice cuándo está listo.
create_ad
Sección titulada «create_ad»Un anuncio de varias escenas desde un brief, a través de toda la cadena de Studio Pipeline: planifica las escenas y luego las renderiza.
| Entrada | ||
|---|---|---|
brief |
Obligatorio | Para qué es: producto, público, ángulo, ambiente (3-2.000 caracteres). |
scene_count |
opcional | 2-6 escenas, por defecto 4. |
aspect |
opcional | 16:9 (por defecto), 9:16 para Reels, TikTok y Shorts, o 1:1. |
branded |
opcional | true aplica el kit de marca guardado en tu cuenta: logo, colores y tarjeta final. Si no tienes ninguno, la llamada se detiene antes de cobrar nada. |
product_image_url |
opcional | Una imagen pública del producto para destacar. |
title, idempotency_key |
opcional |
Costes: 1 crédito para el plano, luego el render. Si el render no puede empezar, se reembolsa el crédito de planificación. Prueba: “Haz un anuncio vertical de 4 escenas para nuestro latte de leche de avena, cálido y acogedor, con mi marca.”
create_presenter_video
Sección titulada «create_presenter_video»Un presentador lee tu guion a cámara. Costes: valorados por duración del guion, mostrados en la respuesta como credits_charged.
| Entrada | ||
|---|---|---|
script |
Obligatorio | Las palabras exactas (5-2.000 caracteres). |
title, idempotency_key |
opcional |
Prueba: “Haz un vídeo de presentador que diga: Bienvenido al equipo, aquí tienes cómo reservar tu primer turno.”
create_launch_video
Sección titulada «create_launch_video»Un breve promo de presentador para una app o producto; el guion se escribe para ti y se devuelve con el trabajo. Costes: valorados por duración del guion.
| Entrada | ||
|---|---|---|
app_name, description |
Obligatorio | Nombre, qué hace y para quién es. |
website_url, idempotency_key |
opcional |
Prueba: “Haz un vídeo de lanzamiento para Northwind, una app de presupuestos para freelancers.”
get_job_status
Sección titulada «get_job_status»Gratis. Las devoluciones status (queued, processing, completed o failed), progress 0-100 y video_url una vez completadas. Los renders suelen tardar unos minutos; un renderizado fallido devuelve lo que cobró. Solo se ven los trabajos en tu propia cuenta.
get_account
Sección titulada «get_account»Gratis. Tu nombre, correo electrónico, plan y créditos restantes.