Быстрый старт

Не готовы писать код? Попробуйте Playground — протестируйте любую модель прямо в браузере, API-ключ не нужен.

1. Создайте аккаунт

Зарегистрируйтесь на runbase.net через Google или по email. Кредитная карта не требуется — новые аккаунты получают бесплатный баланс для начала работы.

2. Получите API-ключ

Перейдите в Settings → API Keys и создайте новый ключ. Скопируйте его в безопасное место — он начинается с sk- и больше не будет показан.

export RUNBASE_API_KEY="sk-your-key-here"

3. Создайте запуск

Отправьте POST на /api/v1/runs с идентификатором модели и параметрами ввода:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cozy bookshop interior with warm lighting, watercolor style",
      "aspect_ratio": "1:1"
    }
  }'

Ответ:

{
  "id": "run_2abc...",
  "model": "google/nano-banana-2",
  "status": "pending",
  "costUsd": 40000
}

costUsd измеряется в микродолларах США (1 USD = 1,000,000). Стоимость 40,000 означает $0.04.

4. Опросите результат

Используйте идентификатор запуска, чтобы проверить статус:

curl -s https://runbase.net/api/v1/runs/run_2abc... \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Когда status равно "succeeded", поле output содержит результат:

{
  "id": "run_2abc...",
  "status": "succeeded",
  "model": "google/nano-banana-2",
  "costUsd": 40000,
  "output": {
    "urls": [
      "https://runbase.net/files/generated/abc123.png"
    ]
  },
  "createdAt": "2026-06-01T12:00:00.000Z",
  "completedAt": "2026-06-01T12:00:04.200Z"
}

Если запуск завершается с ошибкой, status будет "failed", а стоимость автоматически возвращается на ваш баланс.

5. Скачайте изображение

URL-адреса в output — это прямые ссылки на сгенерированные изображения или видео. Они обслуживаются через глобальный CDN и доступны сразу же.

Что дальше

Core Concepts — разберитесь в жизненном цикле запуска, асинхронной модели и механике стоимости
Authentication — настройте IP-whitelisting и лимиты расходов для production
Models — изучите все доступные модели и попробуйте их в playground
Billing — пополните баланс и управляйте им