Autenticación

Cree una clave API y envíe el secreto completo como credencial de tipo Bearer. El secreto solo se muestra una vez.

Authorization: Bearer fd_live_xxx

Enviar una tarea de prueba virtual de prendas

Envíe una imagen de prenda y una imagen de modelo. Una solicitud correcta devuelve el código HTTP 202 con el identificador de la tarea.

curl -X POST \
  "https://www.fashiondiffusion.ai/api/public/v1/virtual-try-on/tasks" \
  -H "Authorization: Bearer fd_live_xxx" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "garmentImageUrl": "https://cdn.example.com/garment.jpg",
    "modelImageUrl": "https://cdn.example.com/model.jpg",
    "imageCount": 1,
    "resolution": "2K",
    "ratio": "3:4",
    "mode": "FAST",
    "prompt": "Keep the garment shape and fabric texture"
  }'

Ambas imágenes deben ser URLs HTTPS públicas, devolver un tipo de contenido de imagen y no superar los 20 MB.

Cada solicitud aceptada crea y cobra una nueva tarea. Esta versión no incluye protección contra idempotencia, por lo que no debe reintentar automáticamente una solicitud con tiempo de espera agotado a menos que acepte cargos duplicados.

Consultar una tarea

Use el identificador de la tarea devuelto por el extremo de envío. Una clave API solo puede leer las tareas pertenecientes al usuario y al equipo actual.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks/{taskId}"

Los estados de la tarea son QUEUED, RUNNING, SUCCEEDED y FAILED. Las URL de las imágenes de salida correctas se devuelven en outputs.

Listar tareas

Enumere las tareas de prueba virtual de prendas enviadas mediante la API pública por el usuario actual. Se incluyen las tareas enviadas con cualquiera de las claves API del usuario.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks?limit=20&createdAfter=2026-08-01T00%3A00%3A00Z"

limit acepta valores entre 1 y 100 y su valor predeterminado es 20. Use nextCursor como cursor en la siguiente solicitud. createdAfter es una marca de tiempo opcional en formato ISO 8601.

Errores

Los errores utilizan un formato consistente. El identificador de la solicitud también se devuelve en el encabezado de respuesta X-Request-Id.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "garmentImageUrl: Invalid url",
    "requestId": "request-uuid"
  }
}