Celebrity Look-Alike (look-alike-v1) convierte un retrato en una imagen generada de parecido con un famoso, por 0,05 $ por solicitud. La respuesta es solo una imagen: sin campo de ID de famoso, sin ranking, sin puntuación de similitud. La imagen puede ser un diseño de dos paneles con un titular impreso, el nombre de un famoso y una firma de estilo manuscrito, y el texto puede salir deformado. Diseña la tarjeta para compartir con eso en mente y nunca presentes el nombre como una identificación verificada.
Look-Alike encaja en una función de entretenimiento voluntaria: el usuario sube un selfie y recibe una imagen para compartir. No tiene prompt, ni selector de persona objetivo, ni control de intensidad; para un cambio de vestuario dirigido o un personaje ficticio recurrente, usa un editor de imágenes.
Elige el tipo correcto de API de «parecido»
La mayoría de las herramientas de parecido son en realidad una de otras dos cosas. Los servicios de reconocimiento facial y los proyectos de código abierto convierten un rostro en un vector, buscan en una base de datos de famosos y devuelven nombres con puntuaciones. Los buscadores de consumo muestran porcentajes como «92 % de coincidencia» sin ningún método detrás. Look-Alike no hace ninguna de las dos cosas.
| Quieres | Usa |
|---|---|
| Una imagen de parecido generada y compartible a partir de una foto | Look-Alike |
| Nombres de famosos ordenados o una cifra de similitud | Un servicio de reconocimiento o tu propia búsqueda por embeddings sobre una base de datos que tengas licencia para conservar; Look-Alike no devuelve ninguna de las dos cosas |
| El rostro de una persona colocado en una imagen de destino que tú eliges | Un endpoint de face swap |
Qué acepta el endpoint
| Elemento | Contrato actual |
|---|---|
| ID del modelo | spicyapi/look-alike-v1/edit |
| Entrada | Un único image_url: JPG, PNG, WEBP o GIF, hasta 10 MB |
| Precio | 0,05 $ por solicitud, incluso si no te gusta el resultado |
| No disponible | Prompt, famoso objetivo, seed, tamaño, intensidad, similitud |
| Retención | Las imágenes de origen se eliminan tras 1 día y los resultados tras 14 |
Un resultado de ejemplo de Look-Alike de la página del modelo: la imagen devuelta es un collage de dos paneles con titular y con el nombre de una persona real impreso, así que un diseño que suponga un retrato limpio y único se romperá.
El ejemplo de la página del modelo es un collage de dos paneles con nombre impreso y firma, así que espera texto en la imagen y prepárate para ello. Previsualiza la exportación real al tamaño de tu tarjeta, conserva sus proporciones (estirarla a un cuadrado deforma los rostros) y, si recortas el texto, el rostro restante sigue sin ser una coincidencia verificada.
Prepara la foto de origen
La página del modelo nombra los casos de fallo: las fotos de grupo, los perfiles, las gafas de sol, las manos o el pelo sobre la cara, el desenfoque por movimiento y los rostros muy pequeños empeoran la coincidencia o hacen que la llamada falle. Usa un único rostro, bien iluminado y más o menos frontal, que ocupe una parte razonable del encuadre, con ambos ojos y la línea del cabello visibles. Aplica la orientación y el recorte antes de subir la foto, porque la miniatura de una galería puede ignorar metadatos de rotación que tus bytes subidos siguen llevando. Ampliar un rostro diminuto de una foto de grupo no añade detalle; pide una foto nueva.
Ilustración, no un resultado de Look-Alike: un retrato adulto más o menos frontal muestra un encuadre de entrada legible.
Pruébalo primero en el Playground
- Abre la página de Look-Alike y quédate en la pestaña Playground, en la vista Form. Inicia sesión con una cuenta con saldo para ejecutarlo.
- Suelta el retrato de un adulto que haya dado su consentimiento en Input image (JPG, PNG, WEBP o GIF, hasta 10 MB) o pega un enlace directo con Asset URL. No hay nada más que configurar.
- Ejecútalo, abre la imagen completa devuelta y revísala como se describe más abajo.
Prueba aquí tu foto de origen más difícil antes de escribir código: si la coincidencia es mala en el Playground, lo será también desde la API, y la solución es una foto mejor.
Después, llámalo desde código
Instala el SDK de Python (pip install spicyapi), define SPICY_API_KEY en el entorno de tu servidor y ejecuta:
import urllib.request
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
photo = client.upload_file("./authorized-adult-portrait.jpg") # becomes a spicy:// URI
task = client.create_task(
model="spicyapi/look-alike-v1/edit",
input_data={"image_url": photo["uri"]},
idempotency_key=str(uuid.uuid4()), # new key per new request; reuse only to retry the same one
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
url = output_assets(final)[0]["url"]
# some script clients get 403 without a User-Agent
request = urllib.request.Request(url, headers={"User-Agent": "look-alike-example/1.0"})
with urllib.request.urlopen(request) as response, open("look-alike.webp", "wb") as out:
out.write(response.read())Envía solo image_url; se rechazan las propiedades adicionales, como el nombre de una celebridad. Las cargas, la espera y los reintentos se explican en la guía de tareas y la referencia del SDK de Python. Para los webhooks, consulta la guía de polling frente a webhooks. Los resultados se eliminan después de 14 días, así que copia la imagen a tu propio almacenamiento si el usuario quiere guardarla.
O deja que un Agent lo ejecute
Cuando un asistente deba ejecutar las solicitudes, la CLI y el servidor MCP muestran el precio y te piden confirmación antes de una llamada de pago; el Skill solo añade instrucciones.
- CLI.
spicyapiejecuta una tarea desde un terminal (npx @spicyapi/clifunciona sin instalar). Pon{"image_url": "spicy://..."}eninput.json, con el URI que imprime la subida:
``bash spicyapi files upload ./authorized-adult-portrait.jpg spicyapi tasks create --model spicyapi/look-alike-v1/edit --input-file input.json --wait ``
- Servidor MCP. Añade el servidor MCP a tu asistente y pide: «Run Look-Alike on ./authorized-adult-portrait.jpg.» Llama a
spicyapi_upload_file, luego aspicyapi_task_create, que se detiene para que confirmes el precio, y después aspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstala el Agent Skill, con el que un asistente de programación lee el esquema vivo del modelo en lugar de adivinar campos. No puede ejecutar tareas por sí solo, así que úsalo junto con la CLI o el MCP.
Revisa el resultado antes de la tarjeta para compartir
Abre la imagen devuelta completa, no un recorte del rostro. Busca paneles adicionales, titulares, nombres reales, firmas, rostros extra y un cambio en la edad aparente. Etiqueta el resultado como Generated look-alike portrait (retrato de parecido generado). Si no quieres mostrar el nombre, recorta o tapa el texto; el rostro restante sigue sin ser una coincidencia verificada. No pongas «93 % de coincidencia» ni «identidad de famoso verificada» junto a él, y no muestres un nombre que otro modelo haya extraído de la imagen como si Look-Alike lo hubiera evaluado. El texto incrustado es contenido generado y puede ser incorrecto.
Ilustración, no un resultado de Look-Alike: revisa la imagen completa y todo lo que rodea al rostro antes de elegir una exportación.
Si al participante no le gusta la imagen, ofrécele descartarla o probar con otra foto. Nada dirige el resultado hacia un famoso concreto, así que repetir es un nuevo candidato de 0,05 $, no un refinamiento.
| Problema | Siguiente acción |
|---|---|
| Solicitud rechazada | Quita los campos de prompt, seed, tamaño y nombre; envía solo image_url. |
| No se puede obtener el origen | Sustituye una página de inicio de sesión, una URL caducada o una respuesta HTML por una imagen accesible o una referencia spicy://. |
| Rostro poco claro o coincide otra persona | Usa un recorte de un solo rostro de un original adecuado, o pide un retrato más claro. |
| Nombre o firma en la imagen que no quieres mostrar | Detén el uso compartido y cambia la presentación; el nombre no es un campo de respuesta que puedas pedir o quitar. |
| El participante quiere un personaje o un vestuario concretos | Usa en su lugar un editor de imágenes que admita imágenes de referencia. |
| Falla la descarga de una tarea terminada | Reintenta la descarga; no crees una solicitud nueva. |
Consentimiento y uso compartido
La entrada es siempre el rostro de una persona real, así que trata la función como reconocimiento facial al evaluar las obligaciones legales. Los datos biométricos están regulados por separado en la UE y en partes de Estados Unidos; la BIPA de Illinois, por ejemplo, exige aviso por escrito y consentimiento informado antes de recopilar identificadores biométricos. Usa fotos de adultos que hayan aceptado a sabiendas este fin, nunca fotos de personajes públicos ni imágenes tomadas de otro sitio, y no uses Look-Alike para identificación, verificación, vigilancia ni para construir una base de datos de rostros. Trata el permiso para generar como independiente del permiso para publicar el origen o el resultado.
Look-Alike funciona sin verificador de seguridad, así que tu producto debe aplicar sus propias reglas de edad y contenido. No uses retratos de personas reales para crear material sexual, íntimo o difamatorio, y no presentes el resultado como una afirmación sobre una persona real. Un retrato de busto de un adulto completamente vestido es la entrada segura por defecto para una función pública de entretenimiento.
Construye un flujo acotado: una vista previa privada del origen, un estado de procesamiento, el resultado completo y una acción explícita de guardar o compartir. No publiques automáticamente al terminar la generación.
