Avatrix ya tiene API: crea influencers IA y videos UGC

Avatrix ya tiene una API pública. Puedes generar influencers IA, imágenes, videos UGC, videos creativos y voz directo por código, o conectándola a n8n, Make o Claude, sin abrir el sitio. La base es https://avatrix.io/api/v1, la autenticación es con un token que generas en tu cuenta, y por debajo corre el mismo motor que más de 5000 creadores ya usan dentro de la plataforma. Este post es el mapa: el primer request en tres líneas, los endpoints, cuánto cuesta en créditos y para quién sirve.

¿Qué puedes hacer con la API de Avatrix?

Puedes correr por código casi todo lo que hace la plataforma: generar imágenes, crear una influencer IA, animarla en video UGC, hacer video creativo, generar voz y además editar imágenes, cambiar el personaje y mejorar la piel. La API expone el mismo motor de la app: modelos de imagen como Referencia y Creativo, y modelos de video como Video IA 1 y Video IA 7. Lo único que cambia es que disparas la generación desde tu propio servidor, no desde la pantalla.

La diferencia no es la calidad, es el control. En el sitio creas una cosa a la vez, a mano. Por la API generas en lote, a la hora que quieras, dentro de tu propio flujo. Es lo que separa "crear contenido" de "tener una línea de producción de contenido que corre sola".

La base de uso ya existe y es grande. Son 5674 creadores en la plataforma y más de 5000 contenidos generados desde el lanzamiento, con 82 % de las generaciones completadas con éxito (datos de la propia Avatrix, snapshot de la base de datos de junio de 2026). La API no es un producto nuevo lanzado a ciegas: es la misma máquina que ya usa gente real, ahora abierta por request.

¿Cómo hago el primer request? (quickstart en 3 líneas)

Haces el primer request en tres pasos: generas un token en tu cuenta, envías un POST a /generate/image con ese token y consultas el resultado por el taskId. No hay SDK obligatorio ni nada que instalar: es HTTP puro, y funciona con curl, con el lenguaje que ya usas o con un nodo HTTP en n8n.

Paso 1: genera el token. El token de acceso (o PAT) es la llave que identifica tu cuenta en cada llamada a la API. En tu cuenta, ve a avatrix.io/account/tokens y crea uno eligiendo sus permisos, los scopes (por ejemplo generate:image). Empieza con av_ y aparece una sola vez: cópialo y guárdalo en un lugar seguro. Es lo que va en el encabezado de cada request.

Paso 2: envía la generación. Un POST a /generate/image con el token, el modelo y el prompt. Para elegir el modelo, lista los disponibles con GET /api/v1/catalog/models (scope read:catalog) y pon uno de los id que devuelve en lugar de <MODEL_ID>:

curl -X POST https://avatrix.io/api/v1/generate/image \
  -H "Authorization: Bearer av_TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{"model": "<MODEL_ID>", "prompt": "una influencer en una cafetería, luz natural de ventana"}'

La respuesta llega al instante, pero no es la imagen: es el número de la tarea:

{ "success": true, "data": { "taskId": "<id-de-la-tarea>", "status": "queued" } }

Paso 3: obtén el resultado. Con el taskId, consulta la tarea hasta que esté lista:

curl https://avatrix.io/api/v1/tasks/TU_TASK_ID \
  -H "Authorization: Bearer av_TU_TOKEN_AQUI"

Cuando el status cambia a completed, la respuesta trae la resultUrl con el archivo generado. Ese es el ciclo de toda generación, y la siguiente sección explica por qué funciona así.

¿Cómo funciona la generación: taskId, polling y webhook?

Toda generación en la API de Avatrix es asíncrona. Envías el pedido y recibes al instante un 202 con el taskId y status: queued, no la imagen ni el video. Tiene sentido: generar video lleva tiempo, y mantener la conexión abierta esperando sería frágil. En lugar de eso, la API te da un número de tarea y sigue trabajando.

A partir de ahí, hay dos caminos. El primero es el polling: consultas GET /tasks/:id cada cierto tiempo, y el status pasa de pending a submitted, processing y por fin completed (o failed). Cuando termina, llega la resultUrl; cuando falla, llega el mensaje de error. Es simple de implementar y sirve para empezar.

El segundo es el webhook, más limpio cuando hay volumen. Pasas una callbackUrl al crear la generación. Cuando la tarea termina, Avatrix hace un POST a tu dirección con el enlace del resultado y los créditos gastados. Así no te quedas preguntando "¿ya está listo?": el resultado llega solo. Lo más robusto es usar el webhook y dejar el polling como red de seguridad.

¿Cuáles son los endpoints de la API?

Los endpoints se dividen en tres familias de generación (imagen, video y audio), más las rutas de lectura (saldo, estado, perfil). Cada token lleva scopes, y el scope habilita el grupo de endpoints. Si solo vas a generar imágenes, creas un token con generate:image y listo. Esta es la parte que más importa:

Hay más rutas de lectura (perfil, suscripciones, pedidos), y la lista completa, con el cuerpo de cada request, está en la documentación oficial en avatrix.io/api/docs: esa es la fuente viva, siempre por delante de cualquier post. Dos rutas públicas no piden token: GET /health, para comprobar si la API está en línea, y GET /plans, que devuelve los planes y paquetes.

¿Cuánto cuesta cada generación en créditos?

Pagas en créditos, igual que en el sitio: la API no cobra aparte. Corriendo la propia API en junio de 2026, medimos el costo real de cada generación mirando los créditos que salían del saldo:

El video varía porque depende del modelo y de la duración: video-creative acepta modelos distintos (de los más económicos a los más pesados), y la cuenta cambia con eso. La imagen se mantiene estable en 10 créditos. La voz es lo más barato, 1 crédito por generación.

Los créditos vienen de dos formas: dentro de los planes mensuales (Creator, Pro y Ultimate), en dólares y con tarjeta, o en paquetes de créditos extra con pago único en tarjeta, sin suscripción, que no vencen: compras, usas cuando quieras y el saldo se queda ahí. Para automatizar, eso cuenta: puedes cargar un lote, correr la línea de producción y recargar solo cuando haga falta, sin una suscripción marcando el ritmo. Si compras créditos por la propia API (POST /credits), el medio de pago disponible ahí hoy es Pix, el sistema de pagos instantáneos de Brasil; con tarjeta, la compra se hace en el sitio.

¿Para quién es esta API? Tres tipos de uso

La API sirve a tres perfiles muy distintos, y la forma de usarla cambia en cada uno. Saber en cuál encajas ya define si vas a escribir código, armar un flujo o solo conversar con un agente.

El desarrollador que integra. Quien construye un producto, una app o un panel y quiere generación de imagen y video con IA por dentro, sin mandar al usuario a otra herramienta. Llama a los endpoints directo, maneja el taskId y escucha el webhook. Para este perfil, la API es Lego: un bloque de generación que encaja en lo que ya tiene.

El creador no-code. Quien no programa, pero quiere escala. Aquí entran n8n, Make y Zapier: armas un flujo que, por ejemplo, lee una hoja de cálculo con prompts, dispara una generación en Avatrix por cada fila y guarda el resultado en una carpeta. Es la línea de producción de contenido sin escribir código, arrastrando bloques.

El operador de agentes de IA. Quien usa un asistente como Claude para orquestar tareas. Con la API conectada, en lugar de abrir el sitio y hacer clic, pides en lenguaje natural ("genera tres variaciones de esta influencer en una playa") y el agente dispara las generaciones por ti. Es el formato que se está haciendo viral en los tutoriales de "creé contenido con IA en masa con Claude", y Avatrix encaja ahí.

¿Se puede usar en n8n, Make o Claude?

Sí. Como la API es REST con autenticación por token, cualquier herramienta que sepa hacer una llamada HTTP puede generar con Avatrix, y n8n, Make y Zapier saben hacerla. Usas el nodo genérico de HTTP, pegas la URL https://avatrix.io/api/v1/generate/image, pones el encabezado Authorization: Bearer av_TU_TOKEN y el cuerpo JSON. El flujo se encarga del resto: dispara, espera y toma la resultUrl.

Para conectarla a un agente de IA como Claude, el camino de fondo es el mismo, solo con una capa más. El Model Context Protocol (MCP), el estándar abierto que Anthropic lanzó en noviembre de 2024 (Anthropic, 2024), es lo que permite que un asistente use herramientas externas dentro de la conversación. Con Avatrix detrás, "generar una influencer" deja de ser un clic en el sitio y pasa a ser un pedido en texto que el agente ejecuta.

Esa capa ya existe: Avatrix tiene un conector MCP para Claude y ChatGPT, así que puedes pedir generaciones en el mismo chat. Funciona sobre la misma base de la API: token, endpoint y respuesta con enlace. Lo que el agente necesita para trabajar ya está en línea.

¿Qué no hace todavía la API?

Vale la pena ser claros con los límites, porque te evitan dolores de cabeza después. La API es sólida en lo que entrega, pero tiene fronteras claras.

Primero, es de servidor a servidor. El token av_... no está hecho para correr en el navegador (no tiene CORS abierto), porque poner un token de generación en el front end expondría tus créditos a cualquiera. El lugar del token es tu back end, n8n o el agente, nunca el código que ve el usuario final.

Segundo, tiene límite de ritmo: 60 requests por minuto y 20 generaciones corriendo al mismo tiempo por cuenta. Si te pasas, la API responde 429 y tienes que esperar. Para un lote grande, eso significa encolar con calma, no disparar todo de una vez. Tampoco se puede cancelar una tarea ya enviada: corre hasta terminar.

Tercero, algunas cosas no están expuestas a propósito. No existe un endpoint para cambiar la cara de una persona real: es una decisión consciente. Para cualquier duda sobre lo que existe hoy, lo que vale es la documentación en avatrix.io/api/docs.

¿API o el sitio: cuándo usar cada uno?

Usa el sitio cuando el trabajo es artesanal: crear una influencer con calma, probar prompts, elegir la mejor foto a mano. Usa la API cuando el trabajo es repetir: generar decenas de variaciones, alimentar una app, correr una línea de producción que trabaja mientras duermes. No es uno u otro: los mismos créditos valen en los dos.

Lo que define es el volumen. Una influencer, una campaña puntual, una prueba: el sitio lo resuelve más rápido, sin armar nada. Contenido a escala, integración en un producto, automatización de verdad: ahí la API compensa el esfuerzo de configurarla, porque te saca del medio del proceso. El motor es el mismo; solo cambia quién aprieta el botón, tu mano o tu código.

Preguntas frecuentes

¿Cómo genero el token de la API de Avatrix?

En tu cuenta, en avatrix.io/account/tokens, creas un token eligiendo sus scopes (lo que puede hacer) y una fecha de vencimiento opcional. Empieza con av_ y se muestra una sola vez: el sistema solo guarda un hash del token. Si lo pierdes, lo revocas y creas otro. El token va en el encabezado Authorization: Bearer de cada request.

¿La generación es instantánea?

No: es asíncrona. El request devuelve al instante un taskId con status: queued, y la generación corre en segundo plano. La sigues con GET /tasks/:id hasta que quede completed y tomas la resultUrl, o recibes un webhook cuando termina. La imagen está lista en segundos; el video tarda más, porque es más pesado.

¿En qué se diferencia la API de Avatrix de otras APIs de video con IA?

En el foco. La mayoría de las APIs de video con IA gira en torno a avatares corporativos o UGC genérico. Avatrix está pensada para influencers IA que mantienen la misma cara en cada foto y video. Una sola cuenta te da más de 15 herramientas y varios modelos de imagen y video por dentro; los mismos créditos valen en el sitio y en la API, los paquetes de créditos extra no vencen y la interfaz está en español y en inglés.

¿Puedo revender la generación o abrirla a mis usuarios?

La API está pensada para que la uses en tu propia operación: tu línea de producción, tu producto, tu automatización. Cada token tiene scopes y registro de uso, lo que ayuda a controlar lo que corre. Antes de armar un producto que le pase la generación a terceros, revisa las reglas de uso en la documentación oficial y habla con soporte: es el camino correcto para no llevarte sorpresas.

¿Necesito un plan de pago para usar la API?

Sí. Como cada generación gasta créditos y Avatrix no tiene plan gratis ni prueba gratis, necesitas saldo, ya sea de un plan mensual o de un paquete de créditos extra con pago único en tarjeta. Lo bueno es que el token no cuesta nada aparte: la API usa los mismos créditos que usarías en el sitio.

Empieza a generar por la API

La API REST de Avatrix está en línea y corre el mismo motor que más de 5000 creadores ya usan. Creas la cuenta, generas un token en segundos y disparas la primera imagen con un curl. Después es armar la línea de producción que tenga sentido para tu flujo: en código, en n8n o en el agente.

La documentación completa, con cada endpoint y cada campo, está en avatrix.io/api/docs. Para correrla ahora:

Crear cuenta y generar mi token de la API →