Основные концепции

Запуски

Запуск — это один запрос на генерацию. Когда вы вызываете API, Runbase создаёт запуск, отправляет его базовой ИИ-модели и возвращает результат, когда он будет готов.

Каждый запуск проходит через жизненный цикл:

POST /api/v1/runs → pending → processing → succeeded (or failed)

Статусы запуска

Асинхронность по замыслу

Вся генерация асинхронна. Когда вы создаёте запуск, API сразу возвращает status: "pending" и ID запуска. Затем вы опрашиваете GET /api/v1/runs/:id, пока статус не станет succeeded или failed.

Время выполнения зависит от модели, нагрузки провайдера и сложности входных данных:

• Модели изображений обычно завершаются быстрее, чем видеомодели
• Видеомодели сильно зависят от длительности, разрешения и времени ожидания в очереди провайдера

Стоимость и возвраты

Стоимость списывается с вашего баланса в момент создания запуска, а не при его завершении. Это заранее резервирует средства.

Если запуск не удался, полная стоимость автоматически возвращается на ваш баланс. Вы никогда не платите за неудавшиеся генерации.

Модели

Runbase — это единый шлюз к моделям от нескольких провайдеров. У каждой модели есть уникальный ID в формате provider/model-name (например, openai/gpt-image-2, bytedance/seedance-2).

Для всех моделей используется один и тот же API с двумя конечными точками:

1. POST /api/v1/runs — создать запуск с ID модели и входными данными
2. GET /api/v1/runs/:id — проверить статус и получить результаты

Схема входных данных отличается для каждой модели (разные параметры для prompt, size, quality, image_urls и т. д.), но обёртка запроса/ответа всегда одинаковая.

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

Каждый API-запрос требует API-ключ в заголовке Authorization как Bearer token. Ключи начинаются с sk- и могут быть созданы в панели управления. Подробности см. в Аутентификация.

Баланс

Runbase использует предоплаченный баланс. Вы пополняете свой баланс, и каждый запуск списывает с него средства в зависимости от цен модели. Подробности см. в Биллинг.