Autenticação

Crie uma chave de API e envie o segredo completo como credencial do tipo Bearer. O segredo é exibido apenas uma vez.

Authorization: Bearer fd_live_xxx

Enviar uma tarefa de experimentação virtual

Envie uma imagem da peça de roupa e uma imagem do modelo. Uma solicitação bem-sucedida retorna HTTP 202 com o ID da tarefa.

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 as imagens devem ser URLs HTTPS públicas, retornar um tipo de conteúdo de imagem e não ultrapassar 20 MB.

Cada solicitação aceita cria e cobra uma nova tarefa. Esta versão não possui proteção contra idempotência, portanto, não realize novas tentativas automaticamente em caso de tempo limite, a menos que cobranças duplicadas sejam aceitáveis.

Consultar uma tarefa

Use o ID da tarefa retornado pelo endpoint de envio. Uma chave de API só pode ler tarefas pertencentes ao seu usuário e à equipe atual.

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

Os status da tarefa são QUEUED, RUNNING, SUCCEEDED e FAILED. As URLs das imagens de saída bem-sucedidas são retornadas em outputs.

Listar tarefas

Lista as tarefas de experimentação virtual enviadas pela API pública pelo usuário atual. São incluídas tarefas enviadas com qualquer chave de API do usuário.

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

limit aceita valores de 1 a 100 e tem valor padrão de 20. Use nextCursor como cursor na próxima solicitação. createdAfter é um carimbo de data/hora opcional no formato ISO 8601.

Erros

Os erros utilizam um envelope consistente. O ID da solicitação também é retornado no cabeçalho de resposta X-Request-Id.

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