Documentation Index
Fetch the complete documentation index at: https://docs.megallm.io/llms.txt
Use this file to discover all available pages before exploring further.
Настройка окружения
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
from dotenv import load_dotenv
load_dotenv()
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
MegaLLM работает с любым HTTP-клиентом. См. Справочник API для подробностей. 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-кодирования:
Это настраивает:
- Claude Code
- Codex/Windsurf
- OpenCode
См. Документация CLI для подробностей.
Проверка настройки
Проверьте вашу конфигурацию:
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
}'
Устранение неполадок
Проблема: Переменная окружения не установленаРешение:
- Проверьте имя переменной:
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
Лучшие практики
Советы и часто задаваемые вопросы
