Бесплатный пробный период Chinese LLM API: как это работает и популярные вопросы

О пробном периоде

Что я получаю бесплатно?

Каждый новый аккаунт получает кредит $0,50. Он действителен в течение семи дней с момента регистрации, и для его получения не нужно вводить платёжные данные. Кредит применяется к тому же эндпоинту и той же модели, что и платные аккаунты, поэтому то, что вы тестируете, будет работать и в продакшене.

На что хватает $0,50?

Это зависит от ваших промптов, поэтому вот иллюстрация с указанными допущениями. Предположим, что каждый запрос отправляет 1,000 входных токенов и получает 500 выходных токенов. По цене $0.25 за миллион входных токенов и $1.00 за миллион выходных токенов один запрос стоит $0.00025 плюс $0.0005, что составляет $0.00075. Затем $0.50 покроет примерно 660 таких запросов. Более короткие диалоги расходуют баланс медленнее, а запросы с длинным контекстом расходуют его быстрее.

Что происходит, когда заканчивается пробный период?

Если пройдут семь дней или кредит будет израсходован, запросы вернут HTTP 402 с кодом no_credit. Ничего не удаляется. Пополните предоплаченный баланс, и тот же ключ снова заработает. Подписки нет, а пополненный баланс не сгорает.

Нужно ли добавлять данные карты для начала?

Нет. Для регистрации нужен только адрес электронной почты и пароль. Ключ отображается сразу после регистрации на странице get-your-key.

Практический план на семь дней

Семь дней — достаточно, если заранее решить, что вы хотите изучить. Относитесь к пробному периоду как к небольшому проекту оценки, а не к месту для случайных экспериментов. Вот последовательность, которая хорошо подходит большинству команд:

1. День 1, дымовое тестирование. Подтвердите ключ, список моделей и один короткий ответ. Приведённые ниже команды делают всё это.
2. Дни 2–3: ваши реальные промпты. Прогоните двадцать–пятьдесят репрезентативных входных данных из вашего продукта через API. Сохраните выходные данные рядом с входными, чтобы коллега мог их просмотреть без повторного запуска.
3. День 4, сценарии сбоев. Намеренно вызовите ошибку 400 с помощью чрезмерно большого запроса, ошибку 401 с неверным ключом и протестируйте обработку ошибок 429 и 503 с помощью небольшой нагрузки. Лучше увидеть их сейчас, чем в продакшене.
4. Дни 5–6: модель стоимости. Умножьте ваши зафиксированные количества токенов на опубликованные тарифы и рассчитайте ежемесячную стоимость при ваших предположениях о трафике.
5. День 7, решение. Сравните качество, стоимость и лимиты с вашими требованиями, затем решите, стоит ли пополнять баланс.

Copyexport API_KEY="paste-your-key-here"

# 1) confirm the key works and see the model id
curl -s https://api.chinesellmapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

# 2) one short completion; read the usage block in the reply
curl -s https://api.chinesellmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"用一句话介绍杭州的春天。"}],"max_tokens":120}'

Второй запрос возвращает объект usage с подсчётами токенов промпта и завершения. Логируйте их с первого дня; это сырой материал для любой оценки стоимости, которую вы будете делать позже.

Ключи и начало работы

Сколько ключей я могу иметь?

Один на аккаунт. Если нужен новый, сгенерируйте его в аккаунте. Старый ключ перестает работать немедленно, поэтому обновите развертывание сразу, иначе вы увидите ошибки 401 от всего, что всё ещё использует старое значение.

Куда вставить ключ?

В переменную окружения на вашем сервере, например API_KEY, и никогда не в код браузера или публичный репозиторий. Запросы передают его как Authorization: Bearer <key>.

Какой минимальный запрос докажет, что всё работает?

Список моделей через GET /v1/models, затем отправьте короткий чат-запрос на /v1/chat/completions с моделью uncensored и низким max_tokens. Поле usage в ответе покажет точную стоимость вызова в токенах.

Могу ли я использовать OpenAI SDK?

Да. API совместим с чат-завершениями OpenAI. Укажите базовый URL как https://api.chinesellmapi.com/v1, предоставьте ключ и установите модель в uncensored. Полное руководство, включая промпты и управление скриптами, доступно в quickstart.

Лимиты и возможности

Какими могут быть промпт и ответ?

Контекстное окно составляет 100 000 токенов, включая промпт и завершение вместе. Настройка max_tokens по умолчанию равна 2 048 и может быть увеличена до 32 000 на запрос. Тело запроса может быть до 8 МБ. Если промпт плюс max_tokens превышает окно, API возвращает 400.

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

Каждый ключ ограничен 300 запросами в минуту. Превысив этот лимит, вы получите 429. Равномерно распределяйте пакетные задания и добавляйте задержку; руководство по переводу включает скрипт пакетной обработки с регулировкой скорости.

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

Да и да. Установите stream: true для событий, отправляемых сервером, с финальным чанком, содержащим usage. Инструменты принимаются в формате OpenAI, а поля выборки, такие как temperature, top_p и stop, передаются как есть.

Что недоступно?

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

Ошибки, с которыми вы можете столкнуться

Какие коды состояния я должен ожидать?

В ответе на ошибку возвращается JSON вида {"error":{"code":...,"message":...}}. 400 означает некорректный запрос, 401 — недействительный или отсутствующий ключ, 402 no_credit, 403 content_blocked, 404 — неизвестный эндпоинт, 429 — лимит запросов, а 503 upstream_busy.

Какие ошибки стоит повторять?

Только 429 и 503. Подождите, добавьте случайную задержку и повторите ограниченное количество раз; несколько секунд достаточно для 503. Повторный запрос 400, 401, 402 или 403 не изменит результат.

Я пополнил баланс, но всё ещё вижу 402, что делать?

Проверьте, используете ли вы текущий ключ, так как генерация ключа заменяет старый. Затем подтвердите, что запрос отправляется на правильный базовый URL. Если всё совпадает, отправьте минимальный запрос и прочитайте сообщение об ошибке в теле ответа.

Как продлить срок действия пробного баланса

Баланс намеренно небольшой, поэтому несколько привычек помогут его растянуть. Держите значение max_tokens низким во время тестирования, поскольку выходные токены стоят в четыре раза дороже входных: $1.00 за миллион против $0.25 за миллион. Сначала тестируйте на коротких репрезентативных промптах и переходите к самым длинным входным данным только тогда, когда короткие работают корректно. Избегайте циклов, вызывающих API без условия остановки, и ограничьте количество повторных попыток в собственном коде.

Пример расчёта с указанными допущениями: набор для оценки из 50 промптов, каждый около 600 входных токенов, с ограничением ответов до 300 выходных токенов. Один проход стоит 30 000 входных токенов плюс 15 000 выходных токенов, что составляет $0.0075 плюс $0.015, или $0.0225. Вы можете запустить весь этот набор около 22 раз, прежде чем баланс иссякнет, чего достаточно для корректного сравнения нескольких вариантов промптов.

Если вы передаете очень длинный промпт, помните, что весь промпт оплачивается при каждом вызове. Документ на 40,000 токенов, отправленный двадцать раз, стоит столько же, сколько двадцать отдельных крупных запросов, поэтому кэшируйте или суммируйте общий контекст, где это возможно. Текущие тарифы указаны на странице с ценами, а сведения о параметрах — в документации.

Правила контента и конфиденциальность

Какой контент разрешён?

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

Что всегда блокируется?

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

Используются ли мои промпты для обучения?

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