Быстрый старт

Эта страница проведёт вас от пустой учётной записи до потокового ответа и строки в журнале использования. В примерах используется OpenAI SDK, потому что он есть в большинстве кода, но тот же ключ работает с SDK Anthropic и Google.

1. 1

   Получите ключ

   Создайте учётную запись, откройте API-ключи и нажмите New key. Ключ начинается с ho- и показывается только один раз, поэтому скопируйте его до закрытия диалога.

   Чтобы не держать его в исходниках, экспортируйте его в переменную окружения:

   Shell

   export HALFOFF_API_KEY="ho-..."

   Также нужен положительный баланс. Пополните его на панели; см. Биллинг.

2. 2

   Направьте клиент на Half Off Dev

   Укажите клиенту https://halfoff.dev/v1 и передайте свой ключ. Больше в вызове ничего не меняется.

   cURLPythonNode.js

   Shell

   curl https://halfoff.dev/v1/chat/completions \
     -H "Authorization: Bearer $HALFOFF_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "model": "gpt-6.1-sol",
       "messages": [{"role": "user", "content": "Explain a race condition in two sentences."}]
     }'

   Предпочитаете нативные SDK? Claude через Anthropic SDK описан в разделе Anthropic Messages, Gemini через Google SDK — в разделе Gemini.

3. 3

   Получайте токены по мере генерации

   Установите stream в true и читайте фрагменты. Формат событий в точности такой, какой отправляет API самого вендора.

   cURLPythonNode.js

   Shell

   curl -N https://halfoff.dev/v1/chat/completions \
     -H "Authorization: Bearer $HALFOFF_API_KEY" \
     -H "content-type: application/json" \
     -d '{"model": "gpt-6.1-sol", "stream": true,
          "messages": [{"role": "user", "content": "List the planets, one per line."}]}'

   Подробнее в разделе Потоковая передача.

4. 4

   Посмотрите, сколько вы заплатили

   Откройте Логи. Каждый вызов появляется там в течение нескольких секунд с числом входных и выходных токенов, списанной суммой, временем до первого токена и токенами в секунду. В каждом ответе также есть заголовок x-halfoff-request-id; приводите его, если когда-нибудь обратитесь в поддержку по этому вызову.

Поиск id моделей#

GET /v1/models не требует ключа и возвращает все модели с их контекстным окном и ценой. Страница списка моделей показывает те же данные.

curl https://halfoff.dev/v1/models

Id сопоставляются нестрого, поэтому claude-sonnet-5.5, claude-sonnet-5-5 и anthropic/claude-sonnet-5.5 приводят к одной и той же модели.

Что дальше#