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

Создайте ключ 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"
  }'

Оба изображения должны быть общедоступными URL-адресами по протоколу HTTPS, возвращать тип контента image и не превышать 20 МБ.

Каждый принятый запрос создаёт и оплачивает новую задачу. В этой версии отсутствует защита от повторных вызовов (idempotency), поэтому не следует автоматически повторять отправку при истечении времени ожидания, если допустимы дублирующиеся списания.

Запрос статуса задачи

Используйте идентификатор задачи, полученный через эндпоинт отправки. Ключ 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"
  }
}