OpenAI API из Беларуси: подключение за 10 минут без VPN

У OpenAI нет ни белорусских карт, ни региона Belarus в списке поддерживаемых стран. Поэтому «прямое» подключение из Минска обычно заканчивается на этапе оплаты или первого запроса. Хорошая новость: сам API — это обычный HTTPS-интерфейс, и если перед вами стоит шлюз, который говорит на том же диалекте, ваш код этого даже не заметит. В этом гайде — полный цикл подключения через AIIN: от регистрации до продакшн-нюансов.

Что такое AIIN и почему код менять не придётся

AIIN — OpenAI-совместимый LLM-шлюз, размещённый в Беларуси. «Совместимый» означает буквально: те же endpoint'ы (/v1/chat/completions, /v1/models), тот же формат запросов и ответов, тот же SSE-стриминг. Единственное отличие — базовый URL https://api.aiin.by/v1 и ключ AIIN вместо ключа OpenAI. За шлюзом — модели OpenAI, Anthropic, Google и других провайдеров, доступные через один баланс в BYN.

Шаг 1. Аккаунт и API-ключ

1. Зарегистрируйтесь в кабинете AIIN (Google OAuth или email).
2. Пополните баланс в BYN — для старта хватает пакета 10 BYN.
3. Выпустите API-ключ в кабинете. Храните его в переменной окружения AIIN_API_KEY, а не в коде.

Шаг 2. Первый запрос на curl

curl https://api.aiin.by/v1/chat/completions \
  -H "Authorization: Bearer $AIIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет из Беларуси!"}]
  }'

Ответ — стандартный объект OpenAI с choices[0].message.content. Если вы видите его — интеграция уже работает.

Шаг 3. Python и JavaScript

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

from openai import OpenAI

client = OpenAI(
    base_url="https://api.aiin.by/v1",
    api_key=os.environ["AIIN_API_KEY"],
)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Кратко: что такое LLM-шлюз?"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aiin.by/v1",
  apiKey: process.env.AIIN_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "Hello AIIN" }],
});
console.log(resp.choices[0].message.content);

Миграция с прямого OpenAI API: что меняется

Справочник ошибок

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