первый запрос к api за 5 минут

чтобы отправить первый запрос, нужны три вещи: аккаунт, ключ api и деньги на балансе.

регистрация

аккаунт создаётся на airakurs.ru. после регистрации на почту приходит письмо со ссылкой для подтверждения — без него кабинет не откроется.

ключ api

ключи создаются в кабинете, в разделе ключи api. ключ выглядит как строка, начинающаяся с sk-, и подставляется во все запросы вместо ключа поставщика.

увидеть ключ целиком можно только один раз, сразу после создания. если ключ потерян, создайте новый. как ограничить ключ списком моделей, бюджетом и ip — в статье api-ключи.

баланс

оплата идёт по факту: стоимость каждого запроса списывается с баланса после выполнения. пополнить баланс можно в кабинете рублями с российской карты.

пока баланс пуст, запросы не выполняются — сервис вернёт ошибку о недостатке средств. как считается предварительная оценка — в статье стоимость запроса.

первый запрос

пример ниже отправляет модели одно сообщение и получает ответ. подставьте свой ключ вместо <КЛЮЧ>.

curl "https://api.airakurs.ru/v1/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "openai/gpt-5-mini",
        "messages": [
            {"role": "user", "content": "Привет!"}
        ]
    }'

from openai import OpenAI

client = OpenAI(
    api_key="<КЛЮЧ>",
    base_url="https://api.airakurs.ru/v1",
)

response = client.chat.completions.create(
    model="openai/gpt-5-mini",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: "<КЛЮЧ>",
  baseURL: "https://api.airakurs.ru/v1",
})

const response = await client.chat.completions.create({
  model: "openai/gpt-5-mini",
  messages: [{ role: "user", content: "Привет!" }],
})
console.log(response.choices[0].message.content)

отдельная библиотека airakurs не нужна: pip install openai или npm install openai.

в примере используется openai/gpt-5-mini — недорогая и быстрая модель, удобная для проверки. вместо неё можно указать любую текстовую модель из каталога. полный идентификатор надёжнее короткого имени.

что дальше

• модели — как устроены идентификаторы.
• api-ключи — ограничения, бюджеты и белый список ip.
• генерация текста — роли, параметры и разбор ответа.

частые вопросы