API Avatrix · MCP y REST v1
Conecta Avatrix a Claude, a Cursor o a tu propio producto y genera influencers IA, imágenes realistas y videos UGC sin salir de tu flujo. En el agente, ni siquiera necesitas token.
Usa los créditos de tu plan Avatrix.
Pega la URL del MCP en el agente. Connect abre el inicio de sesión de Avatrix (Google o correo) y una pantalla que dice lo que el agente podrá hacer. El agente obtiene Avatrix completa: catálogo y cotización, carga de archivos, biblioteca, personajes, imagen y edición, video, Marketing Studio, voz, lote y el Chat IA con tus agentes.
En claude.ai, en 3 pasos
https://avatrix.io/mcpClaude Code: claude mcp add --transport http avatrix https://avatrix.io/mcp
Cursor: Settings → MCP → Add → pega la misma URL.
ChatGPT: Configuración → Conectores → agrega la misma URL (cuenta con conector personalizado habilitado).
No necesitas token
Nada de claves que copiar, pegar o guardar. Entras con la cuenta Avatrix que ya tienes y usas los créditos que ya pagaste.
El costo se cotiza antes
Toda tool de generación acepta get_cost: true y devuelve el precio sin generar ni cobrar. Pide la cotización y luego manda a generar.
n8n y el backend propio siguen con el Bearer av_ de la API REST, justo abajo.
Cada herramienta se vuelve una llamada. Sin hacer clic en botones.
"Crea 8 fotos de Valentina: morena, 24 años, ojos claros, expresiones variadas, fondo limpio. El mismo rostro en todas."
Genera la persona con el rostro fijo: las 8 fotos parecen tomadas el mismo día, a la misma persona.
POST /generate/influencer"Foto vertical de Valentina sosteniendo el producto, fondo de cocina limpia, luz natural, estilo lifestyle."
Pone a la modelo en la escena con el producto, sin sesión de fotos ni productora.
POST /generate/image"Video vertical de 15 s: Valentina habla del producto, en tono natural como una reseña."
Genera el UGC con la persona definida, listo para usar en un anuncio.
POST /generate/video-ugc"Genera 30 variaciones de la foto de perfil de Valentina: distintos ángulos, emociones y fondos. Rostro idéntico."
Produce el lote completo; tú eliges las mejores.
POST /generate/influencer (batch)"Anima esta foto de Valentina en un video de 5 s: movimiento suave, mirada a la cámara, sin cortes."
Convierte la imagen estática en un video fluido, sin cámara ni set.
POST /generate/video-creativeLa API no tiene cobro aparte; cada capacidad respeta el plan y el lanzamiento publicado.
Influencer IA
Persona consistente: rostro fijo en varias fotos
Generación de imagen
Foto realista, producto, editorial, lifestyle
Video UGC
Video vertical con persona IA, tono natural
Video creativo
Animación de foto, video de persona en movimiento
Edición de imagen
Ajuste de una imagen existente con una instrucción en texto
Eliminación de fondo
Fondo transparente automático
Mejora de piel
Refinamiento realista sin sobreeditar
Upscale
Aumentar la resolución sin perder detalle
No hay una cuenta separada en otra plataforma. Te conectas con la cuenta Avatrix que ya tienes, usas los créditos del plan que ya pagaste, y los créditos no vencen.
Base URL: https://avatrix.io/api/v1
Auth: Bearer token (av_...) — genéralo en /account/tokens
curl -X POST https://avatrix.io/api/v1/generate/image \
-H "Authorization: Bearer av_seu_token" \
-H "Content-Type: application/json" \
-d '{"prompt": "foto realista de influencer, fundo clean, luz natural"}'Respuesta 202 con un taskId — la generación es asíncrona. Haz polling en GET /tasks/{taskId} o configura un webhook.
¿Necesito un token para conectarme en Claude?
No. Con MCP pegas la URL, inicias sesión en Avatrix y haces clic en Permitir: el agente pasa a usar tu cuenta y tus créditos, sin ninguna clave que copiar o guardar. El token av_ solo hace falta en la API REST (n8n, backend propio), y lo generas en /account/tokens.
¿Qué generaciones están disponibles por API?
Influencer IA, imagen, video UGC, video creativo, edición de imagen, eliminación de fondo, mejora de piel y upscale. El catálogo de la API es el mismo de la app.
¿Cómo sé el costo antes de generar?
Preguntas antes de gastar. Toda tool de generación del MCP acepta get_cost: true y devuelve solo la cotización, sin crear ni cobrar nada; y get_credits muestra el saldo de la cuenta. El precio es el mismo de la app, sin recargo por API. En REST, el consumo por endpoint está en /api/docs.
¿Cómo funciona la generación asíncrona?
Haces un POST al endpoint de generación y recibes un taskId. Luego haces GET /tasks/{taskId} para ver el estado, o configuras un webhook para recibir el resultado cuando esté listo.
¿Puedo integrar Avatrix en un producto mío y ofrecerlo a clientes?
Sí. La API está pensada para eso: te conectas, generas desde tu propio flujo y entregas al cliente. Los términos están en /termos.
Sigue leyendo