Быстрый старт
Понадобятся аккаунт в кабинете с пополненным балансом и 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
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) |
|---|---|
| OpenAI | https://api.ocean-drive-ai.ru/v1 |
| Anthropic | https://api.ocean-drive-ai.ru |
Если запрос не прошёл
401 invalid_api_key— ключа нет в запросе, он неизвестен, отозван или истёк.402 insufficient_balance— на балансе не хватает средств на запрос; пополните баланс.403— запрос не проходит ограничения ключа (модель, эндпоинт, IP-адрес).429— превышен лимит запросов или расхода; повторите после паузы из заголовкаRetry-After.