Generar avatares
Llama a nuestra API para generar avatares con un nombre o un valor semilla y recibe un avatar de reemplazo: iniciales sobre un fondo de color o un patrón geométrico abstracto, generado al momento y no tomado de un set estático de íconos. Existe para toda pantalla de producto que necesita mostrar una cara antes de que el usuario suba la suya.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
El problema: un usuario sin foto
La mayoría de las personas se registra en un producto mucho antes de subir una foto de perfil, lo que deja un hueco en cada espacio de avatar de la interfaz: hilos de comentarios, listas de equipo, chats, paneles administrativos. Llenar ese hueco con una misma silueta gris genérica para cada usuario sin foto hace que una pantalla con mucho contenido sea realmente difícil de leer de un vistazo. POST /image/avatar genera en su lugar un avatar distinto y reconocible por usuario, para que una lista de diez personas se vea como diez personas, no como un mismo ícono repetido diez veces.
Qué recibe de vuelta
Envía un nombre o cualquier valor semilla consistente, la tarea se encola y devuelve un task_id de inmediato, y el avatar generado llega después mediante un webhook firmado o un enlace firmado válido por 24 horas. Usar la misma semilla de forma consistente produce siempre el mismo avatar, de modo que un usuario dado conserva un avatar estable entre sesiones hasta que sube una foto real.
Dos estilos consolidados, no uno solo
Los avatares de iniciales sobre color se remontan a las primeras herramientas de colaboración, que necesitaban un reemplazo rápido y legible antes de que las fotos de perfil fueran algo común, y siguen siendo populares porque dos letras sobre un fondo sólido se leen al instante incluso en un tamaño diminuto. Los avatares geométricos surgieron de una necesidad relacionada: una identidad visual única y determinística generada puramente a partir de datos, útil en cualquier lugar donde una foto no sea apropiada o no esté disponible pero un círculo gris plano se sienta demasiado anónimo. Ofrecer ambos estilos permite que combine con el tono de un panel administrativo formal o el de una aplicación de consumo más lúdica.
Dónde encaja en un flujo de registro
Como la generación es rápida y determinística según la semilla, se integra sin fricción en la creación de cuentas: en el momento en que se crea un registro de usuario, se solicita un avatar asociado a su nombre o ID, se guarda el resultado, y solo se reemplaza más adelante si el usuario sube su propia foto. Ningún gráfico de reemplazo tiene que venir empaquetado con su aplicación.
Lo que no es
Esto genera una identidad visual de reemplazo, no un retrato estilizado ni un rostro dibujado por inteligencia artificial: se mantiene deliberadamente abstracto, lo que lo hace rápido, predecible y apropiado para cualquier usuario, sin importar cuántos datos personales realmente tenga sobre él.
Qué puede hacer con ella
Incorporación de cuentas nuevas
Generar un avatar de reemplazo estable en el instante en que se crea una cuenta, antes de que el usuario suba una foto real.
Directorios y listas de equipo
Dar a cada miembro de un equipo un avatar distinto y reconocible en un directorio u organigrama aunque varios no hayan configurado foto de perfil.
Interfaces de comentarios y chat
Mantener legible un hilo de comentarios o una lista de chat con mucha actividad, dando a cada participante sin foto un avatar único.
Herramientas administrativas e internas
Poblar paneles internos con avatares consistentes y determinísticos asociados a IDs de usuario, sin almacenar ni gestionar archivos de imagen.
Preguntas frecuentes
¿Cómo genero un avatar con la API?
Envíe un nombre o valor semilla a POST /image/avatar; devuelve un task_id de inmediato y el avatar generado llega después vía webhook o un enlace firmado válido por 24 horas.
¿La API para generar avatares es gratuita?
La herramienta de arriba es gratis en su navegador. La API es de pago: cada llamada se descuenta de su saldo prepago de ForHosting KIT — se recarga desde $10.00 (no caduca), se paga el precio publicado de cada solicitud, y una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens, y una tarea fallida no se cobra.
¿Cuánto cuesta generar un avatar?
Cada solicitud cuesta $0.002, sin cargo adicional por imagen, y solo se cobra cuando la generación se completa con éxito.
¿Qué estilos de avatar están disponibles?
Puede generar avatares de iniciales sobre un fondo de color o avatares geométricos abstractos, según el estilo que mejor combine con su interfaz.
¿El mismo usuario siempre obtiene el mismo avatar?
Sí, si envía el mismo valor semilla de forma consistente, como un ID de usuario o un nombre, el avatar generado se mantiene estable entre solicitudes.
¿Se cobra si falla la generación del avatar?
No. Una tarea fallida se reintenta automáticamente hasta tres veces y nunca se factura si finalmente no se logra completar.
¿Puedo generar avatares en volumen para una base de usuarios existente?
Sí, envíe cada usuario como una solicitud asíncrona independiente y rastréela por su propio task_id, algo ideal para un llenado inicial de una base de datos ya existente.
¿En qué se diferencia de un set estático de íconos de avatar?
Un set estático repite un puñado de íconos genéricos entre muchos usuarios; esta API genera un avatar distinto por semilla bajo demanda, así que no hace falta que dos usuarios sin foto se vean idénticos.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/image/avatar \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"image":"https://ejemplo.com/imagen.jpg"}'const res = await fetch("https://api.kit.forhosting.com/image/avatar", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"image": "https://ejemplo.com/imagen.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/avatar",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/avatar", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"image":"https://ejemplo.com/imagen.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/avatar", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"image": "https://ejemplo.com/imagen.jpg"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.avatar",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 15 |
max_megapixels | 12 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |