Быстрый старт
Ключ, базовый адрес и первый запрос к модели за несколько минут.
Первый запрос занимает три действия: получить ключ, выбрать модель, отправить запрос. API совместим с OpenAI и Anthropic, поэтому подходят их SDK и любые клиенты с настраиваемым адресом.
Получите ключ
Откройте в кабинете раздел «API-ключи» и нажмите «Создать ключ». Ключ вида mg-… показывается целиком один раз. Сохраните его в переменной окружения:
export MORPHOGEN_API_KEY=mg-...Подробнее о лимитах и доступах ключа: Ключи и доступ.
Выберите адрес
| SDK | base_url |
|---|---|
| OpenAI | https://api.morphogen.ru/v1 |
| Anthropic | https://api.morphogen.ru |
Ключ передаётся в заголовке Authorization: Bearer <ключ>. Заголовок x-api-key: <ключ> принимается так же: его отправляет Anthropic SDK.
Выберите модель
Список моделей, доступных вашему ключу:
curl https://api.morphogen.ru/v1/models \
-H "Authorization: Bearer $MORPHOGEN_API_KEY"Берите имена из ответа, а не из памяти: каталог меняется.
Отправьте запрос
curl https://api.morphogen.ru/v1/chat/completions \
-H "Authorization: Bearer $MORPHOGEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 200,
"messages": [{"role": "user", "content": "Привет"}]
}'Без него на время запроса резервируется сумма по максимальной длине ответа модели. При небольшом балансе или лимите ключа запрос тогда может вернуть 402. В /v1/responses поле называется max_output_tokens.
Для потокового ответа добавьте "stream": true в тело запроса.
Что можно вызвать
Все запросы идут на https://api.morphogen.ru с вашим ключом.
| Задача | Запрос |
|---|---|
| Текст, формат OpenAI Chat | POST /v1/chat/completions |
| Текст, формат OpenAI Responses | POST /v1/responses |
| Текст, формат Anthropic | POST /v1/messages |
| Эмбеддинги | POST /v1/embeddings |
| Распознавание речи | POST /v1/audio/transcriptions |
| Картинки | POST /v1/images/generations |
| Видео | POST /v1/videos |
| Список моделей | GET /v1/models |
Любая модель типа «Текст» или «Код» принимает любой из трёх текстовых форматов.
Если запрос не прошёл
Ошибки приходят в формате OpenAI: код лежит в error.code. Частые случаи:
- 401: ключ не передан, неверный, отозван или истёк.
- 402
insufficient_funds: на балансе не хватает денег на резерв запроса. - 403
model_not_allowed: модель не входит в список ключа. - 429
rate_limit_exceeded: ключ превысил лимит запросов или токенов в минуту (по умолчанию 120 и 200 000), повторите через время из заголовкаRetry-After.
Полный список: Ошибки.