¿Cómo generar una influencer IA por API? (paso a paso)

Sí, puedes generar una influencer IA completa por API, sin abrir el sitio ni hacer clic en nada. Envías un POST a https://avatrix.io/api/v1/generate/influencer con un token, recibes un número de seguimiento y obtienes el personaje listo segundos después. Por debajo corre el mismo motor que más de 5000 creadores ya usan dentro de la plataforma, con el 82 % de las generaciones terminando con éxito (dato de la propia Avatrix, snapshot de la base de datos de junio de 2026). Este post es el camino directo: el primer request, cuánto cuesta en créditos y por qué aquí el acceso funciona distinto que en la mayoría de las herramientas del nicho.

¿Cómo generar una influencer IA por API? (el camino directo)

Generas una influencer IA por API en tres pasos: creas un token en tu cuenta, envías un POST a /generate/influencer con ese token y buscas el resultado por el taskId. No hay instalación ni SDK obligatorio: es HTTP puro, funciona con curl, con el lenguaje que ya usas o con un nodo HTTP en n8n.

La diferencia con el sitio no es la calidad, es el control. En la pantalla creas un personaje a la vez, a mano. Por la API disparas decenas, a la hora que quieras, dentro de tu propio flujo. Es lo que separa “crear una influencer” de “tener una línea de producción de influencers funcionando sola”.

Y no es un producto nuevo a ciegas. Son 5674 creadores en la plataforma y más de 5000 contenidos generados desde el lanzamiento (snapshot de la base de datos de Avatrix de junio de 2026). La API solo abre, request por request, la misma máquina que esa gente ya usa en la pantalla.

Quickstart: el primer request en 3 líneas

El camino más corto es generar el token, enviar el POST y consultar el taskId: tres pasos, sin vueltas. El token de acceso (o PAT) es la llave que identifica tu cuenta en cada llamada.

Paso 1: genera el token. En tu cuenta, en avatrix.io/account/tokens, crea un token eligiendo los scopes, es decir, los permisos (por ejemplo generate:image, que cubre la generación del personaje). Empieza con av_ y aparece una sola vez: cópialo y guárdalo en un lugar seguro.

Paso 2: envía la generación. Un POST a /generate/influencer con el token y la ficha del personaje, con los mismos campos del creador de influencers del sitio: tipo, género, edad (de 18 a 60), etnia, ojos, piel, cuerpo, brazos, piernas, cabello y estilo. Los nombres de los campos y sus valores van en portugués, como en la API. El modelo de imagen lo elige Avatrix, así que no va en el pedido:

curl -X POST https://avatrix.io/api/v1/generate/influencer \
  -H "Authorization: Bearer av_TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lia",
    "tipo": "humano",
    "genero": "feminino",
    "idade": 24,
    "etnia": "mestico",
    "olhos": "olhos_castanho_escuro",
    "pele": "pele_sardas",
    "corpo": "corpo_normal",
    "bracos": "bracos_normais",
    "pernas": "pernas_normais",
    "cabelo": "cabelo_liso_longo",
    "estilo": "estilo_hiper"
  }'

Los valores aceptados de cada campo están en la documentación del endpoint. Un valor fuera de la lista devuelve un VALIDATION_ERROR que ya dice cuáles son los correctos.

La respuesta llega al instante, pero no es la imagen: es el número de seguimiento 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 pase a completed, llega la resultUrl con la foto del personaje. Ese es el ciclo de cualquier generación en la API. Para ver cada endpoint y cada campo con calma, la guía completa de la API de Avatrix abre el mapa entero.

¿Por qué la respuesta no llega al instante? (taskId, polling y webhook)

La generación es asíncrona: el request devuelve un 202 con taskId y status: queued, no la imagen. Tiene sentido: generar un personaje o un video lleva tiempo, y mantener la conexión abierta esperando sería frágil. En cambio, la API te da un número de seguimiento y sigue trabajando.

A partir de ahí, hay dos caminos. El polling es consultar GET /tasks/:id cada tanto: el status avanza de pending a processing y por fin a completed, y ahí llega la resultUrl. Es simple de armar y sirve para empezar.

El webhook es más limpio cuando hay volumen. Pasas una callbackUrl al crear la generación, y cuando el personaje está listo, Avatrix hace un POST a tu dirección con el link. Así no te quedas preguntando “¿ya está?”: el resultado llega solo. Lo más robusto es usar el webhook y dejar el polling como red de seguridad.

¿Qué más genera la API además de la influencer?

Además del personaje, la API genera casi todo lo que hace la plataforma: imagen suelta, video UGC, video creativo y voz, y también edita imágenes y cambia personajes. Cada token lleva scopes, y el scope habilita un grupo de endpoints. Si solo vas a generar personajes y fotos, creas un token con generate:image y listo.

El motor detrás es el mismo de la app: modelos de imagen como Referencia y Creativo, y de video como Video IA 1 y Video IA 7. La lista completa, con el cuerpo de cada request, está en la documentación oficial en avatrix.io/api/docs, que es la fuente viva, siempre por delante de cualquier post.

¿Cuánto cuesta generar una influencer por API (en créditos)?

Pagas con créditos, igual que cuando usas el sitio: la API no cobra aparte. Corriendo la propia API en la práctica en junio de 2026, se pudo medir el costo real de cada generación mirando los créditos que salen del saldo:

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

Los créditos vienen de dos formas: de los planes mensuales en dólares, pagados con tarjeta, o de paquetes de créditos extra de pago único con tarjeta, sin suscripción, que no vencen. 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 quieres comprar créditos por la propia API, el medio de pago disponible hoy ahí es Pix, el sistema de pagos instantáneos de Brasil; con tarjeta, la compra se hace en el sitio. Los precios actuales están en la página de precios.

Todos los competidores tienen API: la diferencia está en cómo entras

Las demás herramientas del nicho también tienen API. Lo que de verdad cambia es cómo entras. En la mayoría, el acceso a la API viene con un plan más caro o por contrato. Arcads, por ejemplo, solo habilita la API en el plan Pro, con precio a consultar: los planes públicos (Starter y Creator, en la franja de US$ 110 a 220 al mes) no incluyen API, y para usarla tienes que hablar con ventas. Higgsfield tiene la Cloud API, cobrada en dólares; HeyGen y Synthesia habilitan la API por contrato enterprise.

En Avatrix, la puerta es self-serve. Creas la cuenta, generas el token al instante en avatrix.io/account/tokens y disparas el primer request, sin desbloquear un plan de cientos de dólares y sin hablar con ventas. Pagas con los mismos créditos del sitio, y los créditos de los paquetes extra no vencen.

Fuente: modelo de cobro y acceso a la API de los competidores en sus páginas oficiales (arcads.ai, higgsfield.ai), consultadas en junio de 2026. Los precios de los competidores cambian; revisa la página oficial antes de decidir. Para una comparación completa del mercado, mira Avatrix vs Higgsfield.

¿Cómo mantener el mismo rostro de la influencer en cada generación?

Mantienes el mismo rostro fijando el personaje a partir de fotos de referencia y reutilizando ese mismo rostro en cada nueva llamada a la API. Es lo que separa a una influencer de verdad (la misma persona en mil fotos) de una imagen al azar que cambia de cara en cada generación.

En la práctica, creas el personaje una vez, guardas la referencia y la pasas en los siguientes requests. Así, /generate/image devuelve a la misma chica en la cafetería, en el gimnasio, en su cuarto, siempre con el rostro que fijaste. Sin eso, cada foto sería de otra persona, y nadie sigue a una “influencer” que cambia de cara cada semana.

Ese es el truco clave de quien crea contenido sin mostrar su propia cara. El paso a paso para armar el personaje desde cero, con referencia y prompt, está en cómo crear una influencer IA sin mostrar tu cara: la API solo automatiza lo que ese flujo hace a mano.

¿Se puede usar la API sin programar?

Sí. Como la API es REST con token, cualquier herramienta que sepa hacer una llamada HTTP puede generar con Avatrix, y n8n, Make y Zapier saben hacerlo. Usas el nodo HTTP genérico, pegas la URL https://avatrix.io/api/v1/generate/influencer, 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 por debajo es el mismo. Un asistente que sabe hacer llamadas HTTP puede generar el personaje dentro de la conversación: en vez de abrir el sitio y hacer clic, pides “genera tres variaciones de esta influencer en una playa” y el agente dispara. Avatrix también tiene un conector MCP para Claude y ChatGPT que empaqueta estas llamadas, y la guía completa de la API detalla los tres perfiles de uso.

Preguntas frecuentes

¿Se puede crear una influencer IA por API?

Sí. Envías un POST a https://avatrix.io/api/v1/generate/influencer con un token av_ en el encabezado, y la API devuelve un taskId. El personaje sale del mismo motor que más de 5000 creadores ya usan dentro del sitio, solo que disparado por código y no desde la pantalla.

¿Cuánto cuesta generar una influencer por la API?

Pagas en créditos, igual que en el sitio. Medido en la práctica en junio de 2026, una imagen del personaje cuesta 10 créditos, la voz 1 y el video entre 40 y 56 por generación. Los créditos vienen de los planes mensuales o de paquetes de créditos extra, que no vencen.

¿Necesito saber programar para usar la API?

Para hacer el request directo, ayuda saber lo básico de HTTP. Pero se puede usar sin código: n8n, Make y Zapier tienen un nodo HTTP donde pegas la URL, el token y el cuerpo del pedido. Armas el flujo arrastrando bloques, sin escribir una línea.

¿La API mantiene el mismo rostro de la influencer en cada generación?

Sí. Fijas el personaje a partir de fotos de referencia y reutilizas ese mismo rostro en cada nueva generación. Es lo que separa a una influencer (la misma persona en mil fotos) de una imagen al azar que cambia de cara cada vez.

¿La API de Avatrix es self-serve? ¿Cómo se paga?

Sí. Creas la cuenta y generas el token al instante, sin hablar con nadie. Pagas en créditos, igual que en el sitio: planes mensuales en dólares con tarjeta o paquetes de créditos extra de pago único, que no vencen. Avatrix es una plataforma brasileña, y la compra de créditos por la propia API hoy solo acepta Pix, el sistema de pagos instantáneos de Brasil; con tarjeta, compras en el sitio. La mayoría de las APIs de video con IA solo da acceso en un plan más caro o por contrato, hablando con ventas.

Genera tu primera influencer por API

La API REST de Avatrix está activa y corre el mismo motor que más de 5000 creadores ya usan. Creas la cuenta, generas un token en segundos y disparas el primer personaje 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 empezar ahora:

Crear mi cuenta y generar mi token de la API →