Руководство по настройке

Настройка окружения

1. Безопасно сохраните ваш API-ключ

Linux/macOS
Windows
Файл .env

Добавьте в файл конфигурации вашей оболочки:

# ~/.bashrc или ~/.zshrc
export MEGALLM_API_KEY="your-api-key-here"

Затем перезагрузите:

source ~/.bashrc
# или
source ~/.zshrc

Или используйте файл .env:

echo "MEGALLM_API_KEY=your-api-key-here" >> .env

PowerShell:

[System.Environment]::SetEnvironmentVariable("MEGALLM_API_KEY", "your-api-key-here", "User")

Командная строка:

setx MEGALLM_API_KEY "your-api-key-here"

Создайте файл .env в корне вашего проекта:

MEGALLM_API_KEY=your-api-key-here

Python:

from dotenv import load_dotenv
load_dotenv()

JavaScript:

require('dotenv').config();

Добавьте .env в ваш .gitignore, чтобы не коммитить секреты!

2. Установите SDK

Python
JavaScript/TypeScript
Go
Другие языки

# OpenAI SDK (рекомендуется)
pip install openai

# Или Anthropic SDK
pip install anthropic

# Для переменных окружения
pip install python-dotenv

# OpenAI SDK (рекомендуется)
npm install openai

# Или Anthropic SDK
npm install @anthropic-ai/sdk

# Для переменных окружения
npm install dotenv

go get github.com/sashabaranov/go-openai

3. Настройте свой клиент

Python - формат OpenAI
Python - формат Anthropic
JavaScript - формат OpenAI
JavaScript - формат Anthropic

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=os.getenv("MEGALLM_API_KEY")
)

# Проверьте соединение
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

import os
from anthropic import Anthropic

client = Anthropic(
    base_url="https://ai.megallm.io",
    api_key=os.getenv("MEGALLM_API_KEY")
)

# Проверьте соединение
message = client.messages.create(
    model="claude-3.5-sonnet",
    max_tokens=100,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://ai.megallm.io/v1',
  apiKey: process.env.MEGALLM_API_KEY
});

// Проверьте соединение
const response = await client.chat.completions.create({
  model: 'gpt-4',
  messages: [{ role: 'user', content: 'Hello!' }]
});
console.log(response.choices[0].message.content);

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'https://ai.megallm.io',
  apiKey: process.env.MEGALLM_API_KEY
});

// Проверьте соединение
const message = await client.messages.create({
  model: 'claude-3.5-sonnet',
  max_tokens: 100,
  messages: [{ role: 'user', content: 'Hello!' }]
});
console.log(message.content[0].text);

Настройка проекта

Для новых проектов

Создайте каталог проекта:
mkdir my-ai-project cd my-ai-project

Инициализируйте проект:

# Python
python -m venv venv
source venv/bin/activate
pip install openai python-dotenv

# JavaScript
npm init -y
npm install openai dotenv

Создайте файл .env:

echo "MEGALLM_API_KEY=your-key-here" > .env
echo ".env" >> .gitignore

Создайте первый скрипт: См. Руководство по первому запросу

Для существующих проектов

Если вы уже используете OpenAI или Anthropic:

Обновите базовый URL:

# До
client = OpenAI(api_key="sk-...")

# После
client = OpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key="your-megallm-key"
)

Вот и всё! Весь ваш существующий код работает.

Настройка IDE

VS Code

Установите рекомендуемые расширения:

Python extension (для Python)
ESLint (для JavaScript)
REST Client (для тестирования API)

PyCharm / IntelliJ

Настройте переменные окружения в Run Configurations.

AI-ассистенты для кодирования

MegaLLM предоставляет CLI для настройки инструментов AI-кодирования:

npx megallm@latest

Это настраивает:

Claude Code
Codex/Windsurf
OpenCode

См. Документация CLI для подробностей.

Проверка настройки

Проверьте вашу конфигурацию:

Python
JavaScript
cURL

import os
from openai import OpenAI

# Проверьте API-ключ
api_key = os.getenv("MEGALLM_API_KEY")
if not api_key:
    print("❌ API-ключ не установлен!")
    exit(1)
print("✅ API-ключ найден")

# Проверьте соединение
client = OpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=api_key
)

try:
    response = client.chat.completions.create(
        model="gpt-4",
        messages=[{"role": "user", "content": "Say 'Setup successful!'"}],
        max_tokens=10
    )
    print("✅ Соединение успешно!")
    print(f"Ответ: {response.choices[0].message.content}")
except Exception as e:
    print(f"❌ Ошибка: {e}")

import OpenAI from 'openai';

// Проверьте API-ключ
const apiKey = process.env.MEGALLM_API_KEY;
if (!apiKey) {
  console.log('❌ API-ключ не установлен!');
  process.exit(1);
}
console.log('✅ API-ключ найден');

// Проверьте соединение
const client = new OpenAI({
  baseURL: 'https://ai.megallm.io/v1',
  apiKey: apiKey
});

try {
  const response = await client.chat.completions.create({
    model: 'gpt-4',
    messages: [{ role: 'user', content: "Say 'Setup successful!'" }],
    max_tokens: 10
  });
  console.log('✅ Соединение успешно!');
  console.log(`Ответ: ${response.choices[0].message.content}`);
} catch (error) {
  console.log(`❌ Ошибка: ${error.message}`);
}

curl https://ai.megallm.io/v1/chat/completions \
  -H "Authorization: Bearer $MEGALLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "Say setup successful!"}],
    "max_tokens": 10
  }'

Устранение неполадок

API-ключ не найден

Проблема: Переменная окружения не установленаРешение:

Проверьте имя переменной: MEGALLM_API_KEY
Перезагрузите оболочку: source ~/.bashrc
Проверьте: echo $MEGALLM_API_KEY

Ошибка аутентификации (401)

Проблема: Недействительный API-ключРешение:

Убедитесь, что ключ начинается с sk-mega-
Проверьте на наличие лишних пробелов
Сгенерируйте новый ключ на панели управления

Таймаут соединения

Проблема: Проблемы с сетью или брандмауэромРешение:

Проверьте интернет-соединение
Проверьте настройки брандмауэра
Попробуйте без VPN

Модуль не найден

Проблема: SDK не установленРешение:

pip install openai  # Python
npm install openai  # JavaScript

Следующие шаги

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

Создайте своё первое AI-приложение

Просмотр моделей

Изучите более 70 доступных моделей

Справочник API

Полная документация API

Лучшие практики

Советы и часто задаваемые вопросы

Обзор

Начало работы

Руководство по настройке

Настройка окружения

1. Безопасно сохраните ваш API-ключ

2. Установите SDK

3. Настройте свой клиент

Настройка проекта

Для новых проектов

Для существующих проектов

Настройка IDE

VS Code

PyCharm / IntelliJ

AI-ассистенты для кодирования

Проверка настройки

Устранение неполадок

Следующие шаги

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

Просмотр моделей

Справочник API

Лучшие практики

​Настройка окружения

​1. Безопасно сохраните ваш API-ключ

​2. Установите SDK

​3. Настройте свой клиент

​Настройка проекта

​Для новых проектов

​Для существующих проектов

​Настройка IDE

​VS Code

​PyCharm / IntelliJ

​AI-ассистенты для кодирования

​Проверка настройки

​Устранение неполадок

​Следующие шаги

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

Просмотр моделей

Справочник API

Лучшие практики

Настройка окружения

1. Безопасно сохраните ваш API-ключ

2. Установите SDK

3. Настройте свой клиент

Настройка проекта

Для новых проектов

Для существующих проектов

Настройка IDE

VS Code

PyCharm / IntelliJ

AI-ассистенты для кодирования

Проверка настройки

Устранение неполадок

Следующие шаги