Skip to Content
Быстрый старт

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

Понадобятся аккаунт в кабинете  с пополненным балансом и API-ключ. Запросы идут на https://api.ocean-drive-ai.ru в форматах OpenAI и Anthropic.

Зарегистрируйтесь и пополните баланс

Войдите в кабинет  и пополните баланс: запросы к моделям списываются с него. Как считается цена запроса — в разделе Модели и цены.

Создайте API-ключ

В разделе «API-ключи» нажмите «Создать ключ». Ключ вида sk-od-… показывается один раз: скопируйте его сразу — после ухода со страницы его нельзя будет посмотреть. Лимиты расхода и ограничения ключа описаны в разделе Аутентификация.

Выберите модель

Модели, доступные ключу, отдаёт GET /v1/models. Идентификатор из поля id передаётся в поле model запроса. Модели с ценами — в разделе Модели и цены.

curl https://api.ocean-drive-ai.ru/v1/models \ -H "Authorization: Bearer sk-od-..."

Отправьте запрос

Подставьте ключ и идентификатор модели. Пример на curl получает ответ потоком (SSE), как у OpenAI; без "stream": true ответ придёт одним JSON.

curl https://api.ocean-drive-ai.ru/v1/chat/completions \ -H "Authorization: Bearer sk-od-..." \ -H "Content-Type: application/json" \ -d '{ "model": "<id модели>", "stream": true, "messages": [ {"role": "user", "content": "Привет! Что ты умеешь?"} ] }'

Подключите агента oda

Агент для работы с кодом в терминале ставится одной командой и входит тем же аккаунтом, что и кабинет. Ключ для него создавать не нужно: oda login выпустит отдельный ключ для устройства.

curl -fsSL https://agent.ocean-drive-ai.ru/install.sh | bash oda login

Для Windows (PowerShell) — irm https://agent.ocean-drive-ai.ru/install.ps1 | iex. Подробности — в разделе Агент oda.

SDK

Официальным SDK достаточно передать адрес и ключ:

SDKАдрес (base_url)
OpenAIhttps://api.ocean-drive-ai.ru/v1
Anthropichttps://api.ocean-drive-ai.ru

Если запрос не прошёл

  • 401 invalid_api_key — ключа нет в запросе, он неизвестен, отозван или истёк.
  • 402 insufficient_balance — на балансе не хватает средств на запрос; пополните баланс.
  • 403 — запрос не проходит ограничения ключа (модель, эндпоинт, IP-адрес).
  • 429 — превышен лимит запросов или расхода; повторите после паузы из заголовка Retry-After.

Все коды — в разделах Ошибки и Лимиты.