Быстрый старт
Три основных шага для начала работы с ModelGate API и один дополнительный шаг, если вам нужен Безопасный роутер:
1
Создайте аккаунт
Зарегистрируйтесь и пополните баланс
2
Получите API-ключ
Создайте ключ в разделе API-ключи и настройте, к каким моделям вы хотите дать доступ. Подробнее см. в разделе Уровни доверия. API-ключи имеют формат rp_<uuid>. Ключ показывается только один раз при создании, поэтому сохраните его в безопасном месте.
2.5
При необходимости настройте Безопасный роутер
Если вы работаете с персональными данными, настройте параметры Безопасного роутера и используйте URL https://secure.api.modelgate.ru/v1 вместо обычного API. Подробнее см. на странице Безопасный роутер.
3
Сделайте первый запрос
Используйте OpenAI SDK или любой HTTP-клиент
Base URL:
Заголовок:
https://api.modelgate.ru/v1 или https://secure.api.modelgate.ru/v1Заголовок:
Authorization: Bearer rp_ваш_api_ключ
from openai import OpenAI
client = OpenAI(
api_key="rp_ваш_api_ключ",
base_url="https://api.modelgate.ru/v1"
)
response = client.chat.completions.create(
model="deepseek-v3.2",
messages=[{"role": "user", "content": "Привет!"}]
)
print(response.choices[0].message.content)
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'rp_ваш_api_ключ',
baseURL: 'https://api.modelgate.ru/v1',
});
const response = await client.chat.completions.create({
model: 'deepseek-v3.2',
messages: [{ role: 'user', content: 'Привет!' }],
});
console.log(response.choices[0].message.content);
curl -X POST https://api.modelgate.ru/v1/chat/completions \
-H "Authorization: Bearer rp_ваш_api_ключ" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v3.2",
"messages": [{"role": "user", "content": "Привет!"}]
}'
Основные эндпоинты
| Метод | Эндпоинт | Параметры | Для чего нужен |
|---|---|---|---|
GET |
/v1/models |
Без тела запроса | Получить список доступных моделей. |
POST |
/v1/chat/completions |
model, messages |
Отправить текстовый запрос и получить ответ модели. |
POST |
/v1/embeddings |
model, input |
Получить эмбеддинги для поиска, кластеризации и RAG. |
POST |
/v1/images/generations |
model, prompt |
Сгенерировать изображение по текстовому описанию. |
POST |
/v1/audio/speech |
model, input, voice |
Преобразовать текст в аудио. |
POST |
/v1/audio/transcriptions |
file, model |
Распознать речь из аудиофайла. |