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

Полная интеграция за 3 минуты: получить ключ в Telegram → пополнить баланс → подставить base_url в свой OpenAI SDK.

Шаг 1. Получите API-ключ в Telegram

Откройте @megaapibot и отправьте команду /start. Бот автоматически создаст для вас аккаунт и выдаст уникальный ключ формата sk-nexus-XXXX.... Этот ключ нужно хранить в секрете — он эквивалентен паролю и позволяет тратить ваш баланс.

Безопасность. Никогда не публикуйте ключ в открытом репозитории, фронтенде или Telegram-чатах. Если ключ утёк — нажмите «Перевыпустить ключ» в Mini App: старый перестанет работать.

Шаг 2. Пополните баланс в USDT

Откройте Mini App кнопкой «Открыть Mini App» под приветствием бота → нажмите «Пополнить». Выберите валюту (USDT/TON/BTC/ETH), сумму и оплатите через CryptoBot. Деньги зачислятся на баланс автоматически в течение 30–60 секунд после подтверждения транзакции в блокчейне.

Минимальная сумма пополнения: 5 USDT. Без срока годности и подписок.

Шаг 3. Подставьте ключ в свой код

MegaAPI.ru использует OpenAI-совместимый формат. Если ваше приложение уже работает с OpenAI API, всё, что нужно — заменить base_url и api_key. Ниже примеры для популярных стеков.

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-nexus-...",
    base_url="https://megaapi.ru/v1",
)

response = client.chat.completions.create(
    model="gpt-5",
    messages=[
        {"role": "system", "content": "Ты — эксперт по Python."},
        {"role": "user",   "content": "Объясни декораторы за минуту."},
    ],
)
print(response.choices[0].message.content)

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "sk-nexus-...",
    baseURL: "https://megaapi.ru/v1",
});

const response = await client.chat.completions.create({
    model: "claude-sonnet-4.6",
    messages: [{ role: "user", content: "Привет" }],
});

console.log(response.choices[0].message.content);

curl https://megaapi.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-nexus-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro",
    "messages": [
      {"role": "user", "content": "Сколько планет в Солнечной системе?"}
    ]
  }'

# pip install langchain langchain-openai
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-opus-4.6",
    api_key="sk-nexus-...",
    base_url="https://megaapi.ru/v1",
    temperature=0.7,
)
print(llm.invoke("Напиши хайку про лето").content)

// npm install ai @ai-sdk/openai
import { generateText } from "ai";
import { createOpenAI } from "@ai-sdk/openai";

const megaapi = createOpenAI({
    apiKey: "sk-nexus-...",
    baseURL: "https://megaapi.ru/v1",
});

const { text } = await generateText({
    model: megaapi("grok-4"),
    prompt: "Каков последний курс Bitcoin?",
});

Стриминг (SSE)

Для интерактивных интерфейсов — установите stream: true. Сервер вернёт ответ кусками через Server-Sent Events. Наш nginx уже настроен с proxy_buffering off, так что токены придут к клиенту сразу.

from openai import OpenAI
client = OpenAI(api_key="sk-nexus-...", base_url="https://megaapi.ru/v1")

with client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Расскажи сказку"}],
    stream=True,
) as stream:
    for chunk in stream:
        delta = chunk.choices[0].delta.content or ""
        print(delta, end="", flush=True)

Переключение между моделями

Параметр model определяет провайдера и тарификацию. Полный список — в каталоге моделей. Несколько примеров:

Что делать, если что-то не работает

• 401 Unauthorized — проверьте, что ключ начинается с sk-nexus- и скопирован без пробелов.
• 402 Payment Required — баланс закончился. Пополните через Mini App.
• 404 Not Found — неправильный model. Полный список — в каталоге.
• 429 Too Many Requests — слишком много параллельных запросов с одного ключа. Уменьшите concurrency.
• 5xx — временный сбой upstream. Подождите 2–5 секунд и повторите. Все наши клиенты используют retry с экспоненциальным backoff.

Подробнее об ошибках — см. /docs/api#errors. Не получается завести? Напишите в @megaapibot.

Что дальше