Ценообразование токенов Claude: документация, совместимая с OpenAI

Аутентификация и установка базового URL

Начните с указания вашего SDK на наш базовый URL и передачи вашего API-ключа в заголовке авторизации. Мы требуем простую аутентификацию на основе заголовков, поэтому вам не нужны сложные потоки OAuth или специфичная для SDK логика инициализации. Создайте аккаунт через Google или электронную почту, затем мгновенно получите ключ из панели управления. Этот ключ предоставляет доступ к единственной uncensored модели, идентифицированной как 'uncensored'. Вы можете вращать ключи, если необходимо, но в любой момент времени в аккаунте существует только один активный ключ. Убедитесь, что ваша клиентская библиотека настроена на правильную отправку токена Bearer перед выполнением первого запроса.

Структура эндпоинта Chat Completions

Отправляйте запросы POST на /v1/chat/completions с массивом messages, содержащим ваш запрос и системные инструкции. Эндпоинт принимает стандартные JSON-пэйлоады, совместимые с OpenAI, что позволяет интегрировать наш сервис в Cursor, Windsurf или пользовательские скрипты без переписывания кода. Укажите модель как 'uncensored', чтобы гарантированно получать вывод нашей конкретной uncensored LLM. Вы можете контролировать креативность через temperature и top_p или получить детерминированные результаты, установив temperature в 0. Запросы обрабатываются немедленно, и вы оплачиваете только фактическое использование токенов. Ошибки и отказы не расходуют ваш предоплаченный кредит.

Потоковая передача ответов и использование токенов

Включите потоковую передачу, установив stream в true в теле запроса. Это возвращает Server-Sent Events (SSE), которые обновляют ваш UI в реальном времени по мере генерации токенов. Последний чанк потока содержит общее количество использованных токенов для запроса, позволяя вам точно отслеживать затраты без опроса отдельного эндпоинта использования. Потоковая передача идеальна для длинных контекстных окон до 100,000 токенов. Вы можете парсить чанки с дельта-контентом, чтобы отображать текст по мере его появления. Этот подход снижает воспринимаемую задержку для пользователей, ожидающих сложное рассуждение или длинные текстовые выводы.

Вызов функций и режим JSON

Используйте параметр tools для определения схем функций для вызова функций или установите response_format в json_object для строгого вывода JSON. Модель поддерживает как извлечение структурированных данных, так и динамическое выполнение инструментов в рамках одного контекстного окна. Вы можете определить несколько инструментов в одном запросе, и модель будет возвращать вызовы инструментов или прямые текстовые ответы по мере необходимости. Эта гибкость делает API подходящим для создания агентов или автоматизации рабочих процессов. Убедитесь, что определения ваших функций соответствуют формату OpenAI для обеспечения совместимости со стандартными клиентами.

Правила лимитов запросов и ограничений параллельности

Каждый API-ключ позволяет выполнять 300 запросов в минуту и до 8 одновременных запросов. Максимальный размер тела запроса составляет 8 МБ, что ограничивает объем данных, которые вы можете отправить в одном промпте. Если вы превысите эти лимиты, вы получите код состояния 429, указывающий на достижение лимита частоты запросов. Вы можете отслеживать использование через потоковый ответ или конечную точку /v1/models. Эти ограничения обеспечивают стабильную производительность для всех пользователей. Планируйте пакетную обработку соответствующим образом, чтобы избежать ограничения пропускной способности в периоды пиковой нагрузки.

Обработка ошибок и возвраты средств

Обрабатывайте ошибки HTTP 401, проверяя, что ваш ключ API корректен и активен. Ошибка 402 указывает на недостаток предоплаченного кредита, требуя пополнения перед дальнейшими запросами. Возврат средств за потребленный кредит не производится, но ошибки, такие как двойное списание, решаются через страницу поддержки. Ошибки во время обработки не списывают токены с вашего баланса. Модель отказывает в контенте с участием несовершеннолетних, но разрешает другие законные взрослые темы. Регулярно проверяйте баланс аккаунта, чтобы избежать неожиданных сбоев в работе.

cURL

Copycurl https://api.claudetokenpricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate the cost for 100k tokens"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudetokenpricing.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.claudetokenpricing.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковая передача

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)