Как получить API-ключ Mimo?

Войдите через Google или с помощью электронной почты и пароля, затем откройте страницу API-ключа и скопируйте его. Там же вы можете одним кликом получить пробный баланс $0,50 без привязки карты.

Бесплатен ли API-ключ?

Сам ключ бесплатный. Новые пользователи получают пробный баланс $0,50 на 7 дней, по одному на человека. После этого оплата производится за токены из предоплаченного баланса, начиная с пополнения на $20.

Как долго действует пробный баланс?

Семь дней с момента активации. Это $0,50, не требует привязки карты и доступно в одном экземпляре на человека. После этого для запросов нужен пополненный баланс.

Куда вставить ключ в запросе?

В заголовок Authorization как Bearer, за которым следует ключ. SDK OpenAI делают это автоматически, когда вы передаете ключ как api_key.

Mimo API-ключ: создайте и отправьте запрос

Создание ключа за пять шагов

Чтобы получить API-ключ Mimo для этого сервиса, выполните следующие шаги. Здесь не нужны ни карта, ни звонок.

Зарегистрируйтесь. Используйте Google или зарегистрируйтесь с адресом электронной почты и паролем.
Откройте страницу ключа. После регистрации перейдите на страницу API-ключа. Там будет показан ваш ключ.
Получите пробный баланс. Новые пользователи могут получить пробный баланс $0,50 одним кликом на этой странице. Баланс действителен 7 дней, карта не нужна, лимит — один на человека.
Скопируйте ключ и сохраните его в безопасном месте, например в менеджере паролей или в переменной окружения.
Отправьте тестовый запрос с помощью команды curl в следующем разделе.

Сервис — это размещённый текстовый API, совместимый с OpenAI. Он запускает одну модель с открытыми весами от независимого провайдера, настроенную на ответы без отказов в контенте для законного использования совершеннолетними. Это не официальный API какого-либо вендора моделей. Ваш ключ работает с этой единственной моделью, ID которой uncensored, по базовому URL https://api.mimoapi.top/v1.

Протестируйте ключ одним запросом

Выполните тест в терминале, прежде чем подключать ключ к приложению. Если здесь возникнет ошибка, проблема в ключе или учетной записи, и вам не придется искать её в собственном коде.

export LLM_API_KEY="paste-your-key-here"

curl -i https://api.mimoapi.top/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write one sentence about keys."}],
    "max_tokens": 60
  }'

Хороший результат — статус 200 и тело JSON с массивом choices. Заголовки содержат X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests и X-RateLimit-Limit-Concurrency. Заголовок баланса — быстрый способ узнать стоимость запроса: выполните его дважды и сравните. Если вы хотите только подтвердить ключ, не тратя средства, вызовите GET /v1/models с тем же заголовком.

Тот же запрос на Python с использованием официального пакета OpenAI:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one sentence about keys."}],
    max_tokens=60,
)
print(resp.choices[0].message.content)

Что может и не может делать пробный ключ

Пробный ключ предназначен для тестирования, а не для продакшена. Пробный ключ позволяет выполнять 2 параллельных запроса и 60 запросов в минуту, срок его действия — 7 дней. Полный ключ, который вы получаете после добавления средств, позволяет выполнять 8 параллельных запросов и 300 запросов в минуту. Оба ключа используют одну и ту же модель, одно и то же контекстное окно на 100 000 токенов и одни и те же возможности: потоковая передача через SSE, вызов функций, JSON-режим и стандартные параметры сэмплирования.

На сколько хватает $0,50? При цене $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов запрос с 1 000 входных токенов и 300 выходными токенами стоит 1 000 x $0,15 / 1 000 000 = $0,00015 за входные плюс 300 x $0,50 / 1 000 000 = $0,00015 за выходные, что составляет $0,0003. Пробный баланс покрывает около 1 666 запросов такого размера ($0,50 / $0,0003). Этого достаточно, чтобы протестировать промпты, создать прототип и попробовать потоковую передачу или инструменты.

Используйте пробный период для замеров. Выберите пять промптов, которые ваше приложение будет отправлять чаще всего, запустите каждый несколько раз и зафиксируйте изменение баланса. В конце недели вы получите реальную стоимость запроса и представление о том, как модель работает с вашими данными. Неудачные или отклонённые запросы не оплачиваются.

Храните ключ в секрете

API-ключ — это пароль, который также тратит деньги. Любой, у кого он есть, может отправлять запросы за ваш баланс. Несколько правил предотвращают большинство утечек:

Переменные окружения, а не файлы исходного кода. Получайте ключ через os.environ или process.env. Для локальной работы подойдёт файл .env, добавленный в .gitignore.
Только на сервере. Не вызывайте API из JavaScript в браузере или мобильного приложения, так как любой может прочитать ключ из страницы или пакета приложения. Разместите небольшой сервер между вашим фронтендом и API.
Одно место на ключ. Храните ключ в одном хранилище секретов и копируйте его в каждое развёртывание оттуда, чтобы всегда знать, где он находится.
Не публикуйте ключи в чатах, тикетах или скриншотах. Когда вы обращаетесь за помощью, делитесь X-Request-Id из ответа, а не ключом.
Заменяйте при подозрении. Если вы считаете, что ключ был раскрыт, прекратите его использование и обратитесь в поддержку для замены.

Следите также за заголовком X-Balance-USD. Баланс, который уменьшается, когда ваше приложение бездействует, — первый признак того, что кто-то другой использует ваш ключ.

Продолжение после пробного периода: пополнение и оплата

Когда пробный баланс исчерпан, добавьте кредит. Подходит любая целая сумма от $20 до $500. Бонусы начисляются автоматически: 5% от $50, 10% от $100 и 15% от $200. Таким образом, пополнение на $100 даёт $110 кредита, а $200 — $230. Вы можете оплатить криптовалютой (USDT по сети TRC20, USDC в сети Base).

Подписки нет. Вы платите за токены из своего баланса, кредит не сгорает, что подходит для проектов с неравномерным трафиком. Полный прайс-лист находится на странице тарифов. Промпты, отправленные через API, не используются для обучения.

Разумное первое пополнение — $20. При размере запроса, как в примере чата на этой странице ($0,0003 каждый), этого хватит примерно на 66 000 запросов. Проверьте свои средние показатели через несколько дней и скорректируйте сумму.

Устранение неполадок с неработающим ключом

Большинство проблем с ключом имеют простые причины.

Ошибка аутентификации сразу. Символ был потерян или добавлен при копировании. Ищите пробел в начале или в конце, или разрыв строки. Проверьте, что заголовок имеет вид Authorization: Bearer, за которым следует ключ.
Работает в curl, но не в вашем приложении. Приложение, вероятно, не читает переменную окружения. Выведите первые четыре символа значения, которое оно видит, а не весь ключ.
Не найдено. Базовый URL неверен. Он должен быть https://api.mimoapi.top/v1, на поддомене api. В быстром старте есть список клиентов.
HTTP 429. Код concurrency означает слишком много запросов одновременно; rate_limited означает слишком много запросов в минуту. Пробные ключи достигают этого быстрее (2 одновременно, 60 в минуту). 429 с Retry-After: 5 означает кратковременную перегрузку; подождите пять секунд.
Пробный баланс отсутствует. Пробный баланс получается одним кликом на странице ключа, лимит — один на человека. Он истекает через 7 дней.

Если ничего из этого не помогло, соберите значение X-Request-Id из неудачного ответа и обратитесь в поддержку с ним. Этот ID позволяет отследить проблему, не отправляя ключ.

Что построить в первую очередь

С рабочим ключом выберите небольшой проект, использующий возможности, которые вам понадобятся позже. Цикл чата в командной строке обучает истории сообщений. Скрипт, возвращающий объект JSON с response_format, обучает структурированному выводу. Функция, которую может вызвать модель, обучает использованию инструментов. Каждый проект занимает менее часа, и каждый работает на пробном балансе. Если вы сравниваете этот сервис с другими размещёнными моделями, сравнение в альтернативах API Mistral содержит вопросы, которые стоит задать перед выбором.

Используйте сервис в рамках закона и только для взрослых. Модель настроена на ответы без отказов по контенту, и это особенность для художественной литературы, ролевых игр и исследований, а не разрешение нарушать правила: контент сексуального характера с участием несовершеннолетних всегда запрещен.