Документация

На этой странице

Руководство

Впервые в ZroImg? Начните с обзора и быстрого старта, затем узнайте, как списываются баллы.

О платформеZroImg — AI-платформа для визуального творчества: изображения и видео по тексту, референсы, перерисовка области, бесконечный холст, публичная галерея и открытый API.Быстрый стартНачните работу с ZroImg за несколько минут: регистрация, баллы, первое изображение и видео, бесконечный холст, ИИ-улучшение промпта и управление работами.Баллы и оплатаКак работают баллы в ZroImg: оплата за изображение, секунду или ролик видео и ИИ-улучшение, момент списания, автоматический возврат при ошибке и способы получить баллы.

Основы API

Перед началом работы разберитесь с авторизацией, асинхронными задачами, идемпотентностью, лимитами и ошибками.

Обзор APIОткрытый API ZroImg: Base URL, авторизация по API-ключу, асинхронные задачи, идемпотентность, лимиты запросов, формат ошибок и примеры опроса на Python и JavaScript.Коды ошибокФормат и коды ошибок открытого API ZroImg: авторизация, нехватка баллов, лимиты запросов и задач, конфликт идемпотентности, параметры, ресурсы, сбои и стратегия повторов.

Методы API

Параметры, ответы и готовые примеры на cURL, Python и JavaScript для каждого метода.

Список моделейGET /open/v1/models возвращает модели изображений и видео: режимы, соотношения сторон, качество, разрешение, длительность, референсы, значения по умолчанию и цены.Генерация изображенийPOST /open/v1/images/generations: изображение по тексту, генерация по референсу и перерисовка области. Возвращает объект задачи и стоимость, поддерживает Idempotency-Key.Генерация видеоPOST /open/v1/videos/generations: видео по тексту и по изображению с длительностью, соотношением сторон, разрешением и референсами. Возвращает объект задачи и стоимость.ЗадачиGET /open/v1/tasks/{id} возвращает статус, прогресс, ссылки на результаты и причину ошибки; GET /open/v1/tasks — список задач по статусу и типу. Советы по опросу.Улучшение промптаPOST /open/v1/prompts/polish превращает короткое описание в подробный промпт для изображения или видео по цене «ИИ-улучшения» на сайте и сразу возвращает результат.Баланс балловGET /open/v1/balance возвращает текущий баланс баллов аккаунта, которому принадлежит API-ключ. Баланс общий с сайтом — удобно для проверки перед отправкой задач.