короткие ответы на то, с чего обычно начинают. подробности — в связанных статьях.
доступ и оплата
нужен ли vpn или зарубежная карта?
нет. запросы идут на https://api.airakurs.ru, баланс пополняется рублями с российской карты. см. обзор.
нужно ли регистрироваться у openai, anthropic или google?
нет. аккаунт нужен только в airakurs, ключ — только ключ airakurs.
студия и api делят баланс?
да. это один счёт аккаунта. cookie студии ключом не является.
есть ли подписка?
нет. списание по факту за израсходованные токены. см. баланс.
первый запрос
что нужно, чтобы отправить первый запрос?
зарегистрироваться, подтвердить почту, создать ключ и пополнить баланс. готовые примеры — в быстром старте.
какой базовый адрес ставить в sdk?
для клиента openai — https://api.airakurs.ru/v1. для клиентов anthropic и google — https://api.airakurs.ru: путь они дописывают сами.
работают ли официальные sdk без изменений?
да. меняются адрес и ключ. формат запросов остаётся прежним.
модели
как указать модель в запросе?
идентификатор из вендора и названия через слэш: openai/gpt-5-mini, anthropic/claude-sonnet-4.5, google/gemini-3.5-flash, x-ai/grok-4.20. регистр не важен. на путях google модель указывается без вендора. см. модели.
какие модели доступны?
в первой версии — текстовые модели openai, anthropic, google и xai. полный список идентификаторов отдаёт GET /v1/models. карточки моделей с ценами и контекстом появятся в документации отдельно.
почему «model not supported»?
короткое имя без вендора на /v1/chat/completions считается моделью openai. claude-sonnet-4.5 там превратится в несуществующую openai/claude-sonnet-4.5. пишите идентификатор целиком.
ошибки
почему 401?
ключ не распознан или запрос ушёл не на адрес airakurs. ключ вендора на шлюзе не работает, ключ airakurs на адресе вендора — тоже. см. api-ключи.
почему 402 при непустом балансе?
баланс сверяется с предварительной оценкой по максимальной длине ответа. укажите max_tokens / max_completion_tokens. см. стоимость запроса.
почему 429 при небольшом числе запросов?
скорее всего сработала пауза после серии ошибок 4xx. не повторяйте заведомо неверный запрос в цикле. см. лимиты.
что пока не входит в api
можно ли сгенерировать картинку, видео или голос через этот api?
пока нет. в первой версии шлюза — только текст. медиа остаётся в студии и откроется в api позже, на том же адресе и с тем же ключом.
есть ли эмбеддинги?
пока нет. когда появятся, это будет POST /v1/embeddings без смены ключа.
поддержка: airakurs.official@gmail.com.