Introducción
Recibe un solo retrato y devuelve una imagen generada del famoso más parecido. No hay prompt ni parámetros: la foto es toda la entrada.
La solicitud es una URL de imagen y se factura por solicitud. Está pensada como una función de una sola llamada para productos de entretenimiento y redes sociales, no como una herramienta de identificación.
Funciones y aspectos destacados
Una foto entra, una imagen sale: no hay nada más que enviar
Toda la solicitud es una única URL de imagen. No hay prompt, seed, tamaño ni intensidad, así que la foto que subes es lo único que mueve el resultado. Envíala y consulta la imagen, igual que en cualquier otra llamada de medios de este catálogo; el precio por solicitud es el mismo sea quien sea el que aparezca en la imagen.
Una imagen generada, no un nombre ni una puntuación
La respuesta trae una imagen y nada más: ni el nombre del famoso, ni una lista ordenada de candidatos, ni un porcentaje de parecido. Lo que pongas junto a la imagen es texto tuyo, no una afirmación del modelo, y así es más seguro. Construye el momento sobre la propia imagen: muéstrala, deja que se comparta y no le pongas un número al lado.
Para decidir si puedes usarlo, trátalo como reconocimiento facial
La entrada es siempre el rostro de una persona real, lo que somete este endpoint a normas de imagen personal y datos biométricos que nada más en este catálogo toca. Los datos biométricos tienen una regulación específica en la Unión Europea y en partes de Estados Unidos, y allí el listón del consentimiento puede ser alto. Envía solo fotos cuya persona haya aceptado a sabiendas —nunca las de una figura pública, nunca imágenes sacadas de otro sitio— y no lo uses nunca para identificar, verificar, vigilar o crear una base de datos de rostros. Nada de lo que vuelve es una afirmación sobre una persona real; las imágenes de origen subidas se eliminan al día siguiente y los resultados generados, a los 14 días.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | Un retrato nítido y más o menos frontal, con un único rostro visible. mínimo 1 caracteres |
Precios
$0.05 / solicitud
Una coincidencia que no habrías elegido sigue siendo una solicitud completada y se cobra.
Casos de uso
Una foto subida, una imagen para compartir
Usa este endpoint cuando el momento del producto sea subir una sola foto y recibir una imagen generada para compartir. Envía el retrato como image_url, consulta la tarea y muestra la imagen que vuelve; no hay nombre ni puntuación que mostrar junto a ella.
Funciones de entretenimiento y redes sociales
La interacción de «¿a qué famoso te pareces?» como una sola llamada a la API detrás de una subida de foto. Es un momento para compartir dentro de una app de consumo, no una herramienta de producción.
Mecánicas de campaña
Un paso interactivo ligero dentro de un flujo de marketing: sube una selfie y recibe una imagen para compartir. Una llamada por participante mantiene el costo predecible.
Apps de fotos y belleza
Una función divertida junto a las herramientas de retrato que ya existen. No necesita ingeniería de prompts ni parámetros, así que entra en una app con un solo campo de formulario.
Guía de prompts y consejos prácticos
Espera una imagen, no un veredicto
El endpoint devuelve una imagen generada, no un nombre, una clasificación ni una puntuación de parecido. Si tu producto necesita una etiqueta, tendrás que presentar la propia imagen: la API no te da nada más que mostrar.
Envía un retrato claro y de frente
Un solo rostro bien iluminado, más o menos mirando a la cámara y ocupando una parte razonable del encuadre. Las fotos de grupo, los perfiles marcados, las gafas de sol, el desenfoque de movimiento y los rostros muy pequeños son los casos en que el parecido empeora o la llamada falla por completo.
Revisa el resultado antes de iterar
Un rostro por imagen, más o menos de frente y con buena luz. Los perfiles, las oclusiones (gafas de sol, manos, pelo sobre la cara), el desenfoque de movimiento y los rostros muy pequeños empeoran el parecido o hacen fallar la llamada. No hay prompt, máscara, intensidad ni seed: si el resultado no sirve, la única solución es otra foto. La respuesta es una imagen y nada más: ni nombre, ni clasificación, ni valor de confianza.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/look-alike-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.