изображений

Создание изображений представлено в навигации по документам, поэтому зарубежные документы сохраняют единообразную карту продукта. Доступность общедоступных зарубежных конечных точек управляется схемой. Проверьте GET /api/openapi.json перед вызовом конечных точек изображения из производственного кода.

Запрос

Если конечные точки изображения включены, ожидайте модель асинхронной задачи: создайте задачу с приглашением и параметрами модели, а затем опросите ее на предмет завершения. Запросы по-прежнему используют аутентификацию носителя:

Authorization: Bearer KITTA_API_KEY

Не делайте выводов о зарубежных путях из других документов. Используйте только пути, присутствующие в зарубежной схеме OpenAPI для развернутой среды.

Ответ

Ответы на задачу изображения обычно включают идентификатор задачи, статус, URL-адрес результирующего изображения в случае успеха и код ошибки в случае неудачи. Сохраните идентификатор задачи перед опросом, чтобы пользователи могли восстановить результат после обновления страницы или перезапуска исполнителя.

Выставление счетов и кредиты

За создание изображений может взиматься плата в зависимости от модели, разрешения, эталонных изображений или успешно выполненной задачи. Проверьте размер приглашения и входной носитель перед созданием задачи и проверьте Профиль перед большими пакетами.

Ошибки

Неподдерживаемую модель, недопустимое эталонное изображение, недостаточное количество кредитов и сбой обработки обрабатывайте отдельно. Если конечные точки образа отсутствуют в GET /api/openapi.json, считайте, что эта возможность не является общедоступной для учетной записи.

Канонические конечные точки OpenAPI

• Список моделей: GET /api/open/v1/media/models?mediaType=image
• Создание изображения: POST /api/open/v1/media/images/jobs
• Получение задачи: GET /api/open/v1/media/images/jobs/{jobId}

Каждый запрос создания должен содержать уникальный заголовок Idempotency-Key. API использует квоту API, а не кредиты веб-подписки, и идемпотентно возвращает квоту при сбое провайдера, хранилища или сохранения задачи.