Модели - Runbase Docs

Runbase предоставляет доступ к лучшим моделям генерации изображений и видео от нескольких провайдеров через единый API.

Просмотр моделей

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

Playground — протестируйте модель в браузере перед тем, как писать код
Pricing — стоимость за запуск или за секунду
Examples — примеры результатов с промптами
API reference — параметры ввода, специфичные для модели, и примеры кода

Playground

На странице каждой модели вверху есть интерактивный Playground. Войдите в систему, введите промпт и нажмите Run model, чтобы увидеть результат за считанные секунды. Это самый быстрый способ оценить качество и скорость модели перед интеграцией в ваше приложение.

Формат ID модели

У каждой модели есть ID в формате provider/model-name, например:

openai/gpt-image-2 — генерация изображений
bytedance/seedance-2 — генерация видео
google/veo-3 — генерация видео

Полный список доступных моделей и их ID находится на странице Models. Модели добавляются регулярно — проверяйте там актуальный список.

Параметры ввода

У каждой модели свой собственный input schema. Часто используемые параметры:

prompt (string) — текстовое описание того, что нужно сгенерировать
aspect_ratio (string) — размеры выходного изображения, например "1:1", "16:9"
quality (string) — уровень качества генерации
image_urls (string[]) — URL-адреса референсных изображений (если поддерживается)

Полную input schema и доступные опции смотрите на странице подробностей каждой модели.

Использование модели

Передайте ID модели и объект input в endpoint создания run:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

Если вы передадите недопустимый ID модели, вы получите ошибку 400 model_not_found. Если input не соответствует schema модели, вы получите 400 invalid_input с описанием проблемы.

Модели изображений и видео

Image models возвращают один или несколько URL изображений в output.urls. Время генерации зависит от модели, нагрузки на провайдера и сложности входных данных.
Video models возвращают URL видео в output.urls. Время генерации зависит от модели, длительности, разрешения и нагрузки на провайдера.

API-формат одинаков для обоих типов — единственное различие в том, на что указывают output URLs.