Аутентификация

Създайте API ключ и изпратете цялата тайна като удостоверение от тип Bearer. Тайната се показва само веднъж.

Authorization: Bearer fd_live_xxx

Изпращане на задача за виртуално обличане

Изпратете изображение на дреха и изображение на модел. Успешният заявката връща HTTP 202 с идентификатора на задачата.

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"
  }'

И двете изображения трябва да са публични HTTPS URL адреси, да връщат тип съдържание image и да не надвишават 20 MB.

Всяка приета заявка създава и таксува нова задача. Тази версия няма защита срещу идемпотентност, затова не извършвайте автоматично повторно изпращане при изтекъл срок, освен ако дублираните такси са приемливи.

Заявка за задача

Използвайте идентификатора на задачата, върнат от крайната точка за изпращане. API ключът може да чете само задачи, притежавани от своя потребител и текущия екип.

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

Статусите на задачите са QUEUED, RUNNING, SUCCEEDED и FAILED. Успешните URL адреси на изходните изображения се връщат в outputs.

Списък със задачи

Изброяване на задачите за виртуално обличане, изпратени чрез публичното API от текущия потребител. Включват се задачи, изпратени с всеки от API ключовете на потребителя.

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

limit приема стойности от 1 до 100 и по подразбиране е 20. Използвайте nextCursor като cursor в следващата заявка. createdAfter е опционален ISO 8601 временен печат.

Грешки

Грешките използват последователен формат. Идентификаторът на заявката също се връща в заглавката на отговора X-Request-Id.

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