Saltar al contenido principal
Cada herramienta devuelve un texto para el modelo y los mismos datos en JSON en structuredContent. Los errores vuelven con isError: true y un mensaje que dice qué hacer.

​
El flujo

El servidor le manda estas instrucciones al cliente al conectarse, así que Claude sigue este flujo sin que se lo pidas, y nunca anuncia un video como listo antes de que get_video devuelva done.

​
create_video

Empieza un reel explicativo vertical (9:16) sobre un tema: investiga, escribe el guion, graba la voz, anima y renderiza.
​
string
requerido
De qué es el video, con las palabras del usuario: una pregunta, una curiosidad o un mito. Máximo 2000 caracteres.
​
integer
predeterminado:"45"
Duración objetivo, de 15 a 120 segundos en pasos de 5. Un valor fuera de rango se lleva al más cercano.
​
string
Estilo visual (ver list_inspirations). Si no lo pasas, el guionista elige el que mejor le va al tema.
​
string
predeterminado:"narrador"
Voz del narrador: narrador, nandez, conversacional, calmado, mexicano, energica, calida o clara. Ver Voces.
​
string
es, en o pt. Si no lo pasas, el video sale en el idioma del tema.
​
string
Enlace https:// a un video de TikTok o Instagram cuyo formato quieres como referencia. El guionista no ve el video: solo usa lo que puede leer de esa página.
​
string
Id del video, para get_video, revise_video y cancel_video.
​
string
Id de la conversación del video en Xtarify.
​
string
queued al empezar.
​
integer
Créditos que se cobrarán al empezar la producción.
​
string
Página del video en xtarify.com, con el progreso en vivo.

​
get_video

Estado de un video. Con wait_seconds, el servidor espera a que el video avance antes de responder, así el cliente no tiene que preguntar a cada rato.
​
string
requerido
El video_id que devolvió create_video, revise_video o list_videos.
​
integer
predeterminado:"0"
Segundos de espera en el servidor (0 a 55). Mientras se hace, usa 50: la respuesta vuelve apenas el video cambia de paso, o al cumplirse el tiempo.
​
string
queued (en cola), running (trabajando), done (listo), answered (el guionista respondió con un mensaje en vez de hacer el video; no se cobró), failed (no terminó; créditos devueltos) o cancelled.
​
string
Paso actual: script, voice, timing, animation, render o review.
​
integer
Avance aproximado, de 0 a 100.
​
object[]
Cada paso con step, label y state (pending, live, done, skipped o error).
​
object
Cuando ya existe: title, hook, inspirationId, blocks (el texto de cada parte) y sources (las fuentes de cada dato).
​
string
Solo con done: el MP4 para ver.
​
string
Solo con done: el mismo MP4 como descarga, con el título como nombre de archivo.
​
string
Solo con done: la portada en JPG.
​
number
Solo con done: duración real del video.
​
string
Solo con done: descripción lista para pegar.
​
string
Solo con done: descripción lista para pegar.
​
string[]
Solo con done: sin el #.
​
integer
Los enlaces vencen a los 7 días; vuelve a llamar a get_video para recibir enlaces nuevos.
​
string
Solo con answered: lo que respondió el guionista.
​
string
Solo con failed o cancelled.
​
integer
Solo con failed o cancelled.
Con done, la respuesta también trae una imagen con 12 fotogramas del video, para que el modelo vea cómo quedó.

​
estimate_video

​
integer
predeterminado:"45"
Duración de 15 a 120 segundos.
​
integer
Precio de un video nuevo de esa duración.
​
integer
Tu saldo.
​
boolean
Si te alcanza.

​
list_inspirations

Sin parámetros. Devuelve inspirations: cada estilo con id, name, tagline, bestFor, beta, previewUrl (video de muestra) y posterUrl. Ver Estilos.

​
revise_video

Hace una versión nueva de un video terminado a partir de lo que quieres cambiar. Si el cambio es solo visual, reusa la voz y el guion y cuesta menos (ver Créditos).
​
string
requerido
El video que quieres cambiar.
​
string
requerido
Qué cambiar, con las palabras del usuario.
​
string
Otro estilo visual. Sigue siendo un cambio solo de animación.
​
string
Otra voz. Graba la voz de nuevo, así que cuesta como un video nuevo.
​
integer
Otra duración. Reescribe el guion y graba la voz de nuevo: cuesta como un video nuevo.
Devuelve el video_id de la versión nueva: síguelo con get_video.

​
list_videos

​
integer
predeterminado:"10"
Cuántos videos, de 1 a 30. Los más recientes primero.
Devuelve videos: cada uno con video_id, project_id, title, status, video_url (si está listo), web_url y created_at.

​
get_credits

Sin parámetros. Devuelve credits (tu saldo) y prices (créditos por duración: 15, 30, 45, 60, 90 y 120 segundos).

​
cancel_video

​
string
requerido
Un video que todavía se está haciendo.
Pide la cancelación y devuelve los créditos cobrados. El video se detiene en el siguiente punto seguro, normalmente en segundos.