FAQ по API больших моделей: ответы по темам

Аккаунт и ключи

Как получить первый ключ?

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

Можно ли создать несколько ключей для одного аккаунта?

Нет, только один на аккаунт. Для разделения расходов по проектам используйте метки в своей системе, а не несколько ключей.

Что делать при утечке ключа?

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

Могут ли новички попробовать сервис?

Да. Новый аккаунт получает $0.50 пробного баланса на 7 дней без привязки карты.

Чтобы увидеть путь от регистрации до первого запроса, выполните настройку проекта по статье о чат-боте.

Если вы управляете несколькими проектами, не полагайтесь на разные ключи. Добавляйте метки проектов в бэкенде и сохраняйте usage. Это даст более точную статистику, чем в консоли.

Что можно и нельзя вызывать

Какой адрес API и имя модели?

Адрес: https://api.apidamoxing.com/v1，模型名固定为 uncensored. У сервиса только одна модель.

Какие эндпоинты доступны?

Два: POST /v1/chat/completions для диалога и GET /v1/models для списка моделей. Остальные пути вернут 404.

Можно ли передавать изображения, аудио или делать векторный поиск?

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

Поддерживается ли потоковая передача и вызов функций?

Да. Потоковая передача включается параметром stream: true (возврат через SSE). Вызов функций использует формат OpenAI tools.

Можно ли использовать готовые SDK OpenAI?

Да. Укажите base_url на наш адрес и замените api_key на свой ключ. Подходят Python, Node.js и curl.

Распространённое заблуждение: «Раз совместим с OpenAI, значит, поддерживаем все функции OpenAI». Совместимость означает формат запросов и ответов, но не функционал. У нас только текстовый чат, поэтому код для понимания изображений, распознавания речи и векторного поиска нужно заменить.

Длина, частота и параметры

Сколько данных можно передать?

Сумма ввода и вывода — до 100,000 токенов. Тело запроса ограничено 8 MB, но в текстах обычно сначала упираемся в лимит токенов.

Почему ответ обрывается на полуслове?

Скорее всего, сработал лимит max_tokens (по умолчанию 2048). Увеличьте его до 32,000, следя, чтобы сумма не превысила 100,000.

Сколько запросов можно отправлять в минуту?

300 запросов на ключ. Для пакетных задач рекомендуется настроить очередь и лимиты на своей стороне, чтобы не ждать восстановления после срабатывания лимита запросов.

Работают ли temperature, top_p и stop?

Да, эти стандартные поля выборки передаются модели без изменений, поведение соответствует вашим ожиданиям от API дополнения чата.

Где посмотреть детали по каждому полю?

Подробная таблица параметров доступна в разделе Детализация параметров API, а краткая справка — на странице Документации.

Что считается «длинным текстом»? 100 000 токенов — это примерно несколько десятков тысяч китайских иероглифов, но точное количество зависит от содержания; это лишь грубая оценка. Для работы с очень длинными документами рекомендуется разбивать их на части и затем объединять результаты.

Стоимость и баланс

Как происходит тарификация?

Токенизация: ввод — $0,25 за миллион токенов, вывод — $1,00 за миллион токенов. Без ежемесячной платы и подписок.

Предоплата или оплата по факту?

Предоплата. Пополните предоплаченный баланс на аккаунте; средства списываются по мере использования. Баланс не сгорает.

Что произойдет, когда деньги закончатся?

Запрос завершится ошибкой со статус-кодом 402 и кодом ошибки no_credit. То же происходит при истечении срока действия бесплатного пробного баланса. После пополнения баланс восстанавливается.

Как оценить стоимость функции?

Ориентируйтесь на примеры в разделе Токены и тарификация. Основная задача — прочитать usage из ответа и умножить на тариф.

Дополнительная рекомендация по бюджету: пополняйте баланс, исходя из «ожидаемого потребления за период», не нужно сразу вносить большую сумму. Поскольку используется предоплаченный баланс, он служит жестким лимитом: как только средства закончатся, работа остановится, и непредвиденных счетов не будет.

Практические вопросы запуска и отладки

Можно ли использовать один API-ключ для разработки и продакшена?

Так как ключ один на аккаунт, он общий. Храните его в переменных окружения на сервере, не выкладывайте в репозиторий или на фронтенд. Помните: при генерации нового ключа старые перестанут работать во всех средах.

Нужно ли сразу повторять запрос при ошибке 503?

Нет. Это означает временную перегрузку сервиса. Попробуйте снова через несколько секунд и установите максимальное количество повторных попыток. Интенсивная отправка запросов приведет к быстрому исчерпанию лимита запросов.

Интерфейс работает медленно, это проблема?

Генерация длинных текстов требует времени, и чем длиннее вывод, тем дольше он генерируется. Рекомендуется включить потоковую передачу, чтобы пользователь видел начало текста, и установить более щадящие таймауты на стороне клиента.

Как избежать превышения лимита при длинных диалогах?

Обрезайте историю диалога на своем бэкенде, оставляя только последние несколько раундов; более ранние сообщения можно сжать в виде краткого содержания. Оценивайте общий объем до отправки запроса, а не ждите ответа 400.

Как узнать, сколько именно токенов использовал запрос?

Прочтите поле usage в ответе: там указаны ввод, вывод и общая сумма. В потоковом ответе эти данные содержатся в последнем блоке, дополнительные параметры не требуются.

Эти вопросы часто возникают, потому что они актуальны на этапе, следующем за «запуском кода». Рекомендуем использовать этот раздел как чек-лист перед запуском в продакшен, чтобы убедиться, что ваша программа обрабатывает все эти сценарии.

Границы контента и пользователи

Какой контент будет заблокирован?

Легальный контент для взрослых, художественная литература и дискуссионные темы не блокируются. Сексуальный контент с участием несовершеннолетних всегда блокируется с возвратом 403, независимо от того, является ли это художественной литературой или ролевой игрой.

Кто может пользоваться сервисом?

Только совершеннолетние (18+). Если ваш продукт открыт для публики, добавьте проверку возраста на входе.

Будет ли мой промпт использоваться для обучения?

Нет, промпты не используются для обучения.

С чего начать при возникновении ошибки?

Сначала прочтите поля code и message объекта error в теле ответа, затем сопоставьте их со статус-кодом: 401 — проблема с ключом, 402 — проблема с балансом, 403 — проблема с контентом, 429 — превышение лимита запросов, 503 — временная перегрузка сервиса (попробуйте снова через несколько секунд).