La API de Peinados con IA

Obtén tu clave de API

Crea una cuenta y en la sección de tu perfil crea una clave de API.

Compra créditos (o usa el modo de prueba)

Visita la sección de tu perfil para comprar créditos de API. Cada generación exitosa consumirá un crédito de tu saldo.

Los créditos nunca caducan y se pueden usar en cualquier momento. Se aplican descuentos por volumen en compras al por mayor.

Para pruebas, puedes usar mode: 'test' en la solicitud de la API. Esto no consumirá ningún crédito de tu saldo, pero te permitirá probar todo el flujo de la API.

Obtener los estilos

Envía una solicitud GET para obtener los estilos:

https://api.aihairstyles.com/api/styles

Recibirás una respuesta JSON con los estilos, como se muestra a continuación. Observa que el objeto preview_images contiene las imágenes para ambos sexos.

{
  "description": "Bob - disheveled",
  "preview_images": {
    "man-white": "https://ik.imagekit.io/aicosmetic/AAA-hairstyle_images/models/man-white/00037.png?updatedAt=1710976848880",
    "woman-white": "https://ik.imagekit.io/aicosmetic/AAA-hairstyle_images/models/woman-white/bob%20dishevled.png?updatedAt=1707320590149"
  },
  "preview_image": "https://ik.imagekit.io/aicosmetic/null",
  "sex": "feminine",
  "id": 817941,
  "tags": "disheveled, bob"
}

Crear una generación

Envía una solicitud POST para crear una nueva generación a

https://api.aihairstyles.com/api/preview

Tu clave API debe estar en los encabezados de tu solicitud, en el campo x-api-key.

La solicitud debe enviarse como datos de formulario con los siguientes campos:

Imagen (obligatorio)

• Idealmente, debería ser una imagen cuadrada con el rostro del sujeto claramente visible. Las imágenes se recortarán para que sean cuadradas si no lo son
• Con suficiente área alrededor del rostro y cabello para que la IA genere diferentes estilos.
• El tamaño máximo de archivo permitido es de 8Mb.

Múltiples estilos separados por coma

Opciones: rubio, castaño, negro, pelirrojo, gris

Opciones: masculino, femenino o persona (predeterminado)

Tu URL de webhook

Opciones: prueba. Úsalo durante el desarrollo para evitar ser facturado.

Respuesta exitosa

{
  "data": {
    "id": 1234,
    "inputUrl": "https://ik.imagekit.io/aicosmetic/f8b915b2-57df-49b7/123123123"
  },
  "message": "Job created successfully",
  "status": "success"
}

Manejo del resultado (sondeo o webhook)

Tienes dos opciones para manejar el resultado.

Webhook

Especifica una callback_url en la solicitud POST original para crear una vista previa, y enviaremos una solicitud POST a esa URL cuando se complete la generación.

Sondeo

Envía una solicitud GET al ID de vista previa para verificar el estado. Ten en cuenta que hacer sondeos más rápido de una vez por segundo resultará en limitación.

https://aihairstyles.com/api/preview/[preview_id]

Respuesta exitosa

{
  "data": {
    "images": [
      "https://ik.imagekit.io/aicosmetic/3291-preview-723335832172-7679_Se7y5RMBR"
    ],
    "status": "done"
  },
  "message": "",
  "status": "success"
}

Respuesta de error

{
  "data": null,
  "message": "Invalid API key",
  "status": "error"
}