Масштабируйте и улучшайте разрешение и детализацию сгенерированных изображений моды.

Улучшитель качества (Upscale)

Конечная точка Улучшителя качества позволяет интеллектуально масштабировать и улучшать разрешение и мелкие детали изображений, поддерживая разрешение до 4K.

Название модели: upscale

Жизненный цикл: стабильный

Время обработки: ~8с–20с

Формат вывода: Авто (JPEG или PNG)

Методы доставки: URL

Кредиты: от 3 до 4 за изображение (2k: 3, 4k: 4)

Запрос

Отправьте ваше изображение и целевое разрешение на универсальную конечную точку /v1/run:

POSThttps://fititon.app/api/v1/run

Примеры запросов

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

Ответ

Поскольку масштабирование может занимать до 20 секунд, конечная точка /v1/run немедленно возвращает статус 201 Created с асинхронным id задания. Вы должны опрашивать API статуса, используя этот id, чтобы получить окончательное изображение. В качестве альтернативы вы можете настроить веб-хуки для автоматического получения уведомлений. Обратите внимание, что наш диспетчер веб-хуков применяет строгое 15-секундное ограничение по времени. Ваш сервер должен подтвердить веб-хук кодом состояния 2xx в течение 15 секунд, иначе мы посчитаем его неудачным и повторим попытку позже.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

Когда задание завершится (status: "success"), поле output будет содержать массив результирующих URL:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

Параметры запроса

Обязательные параметры

imageUrlRequiredstring

Исходное изображение, которое вы хотите масштабировать. Может быть общедоступным URL или строкой изображения, закодированной в Base64.

Требования к форматированию и полезной нагрузке При отправке строки Base64 она должна включать стандартный префикс URI данных (например, data:image/jpeg;base64,...). Кроме того, мы настоятельно рекомендуем использовать стандартные HTTP URL для изображений размером более 3 МБ, чтобы избежать превышения глобальных ограничений на размер полезной нагрузки JSON (HTTP 413).

targetQualityRequired'2k' | '4k'

Желаемый уровень выходного разрешения. Примечание: Изображения размером более 4,25 мегапикселей не могут использовать targetQuality="2k" и должны быть нацелены на 4k.

Ошибки выполнения

Ошибки выполнения для этой функции используют общий набор, задокументированный в Обработка ошибок. Если во время обработки произойдет ошибка, status обновится до "error", а поле error будет содержать конкретную причину сбоя.

Стоимость кредитов

Для запросов Developer API стоимость масштабируется в зависимости от targetQuality.

Формула: Стоимость = КредитыКачества

Параметр	Кредиты за изображение
`targetQuality="2k"`	3
`targetQuality="4k"`	4