SDK
Используйте официальные SDK OpenAI, Anthropic и Google Gen AI с Half Off Dev за полцены, задав два параметра клиента.
Поскольку Half Off Dev поддерживает API каждого вендора в его собственном формате, специальная клиентская библиотека не нужна. Установите официальный SDK, передайте конструктору клиента базовый URL Half Off Dev и свой ключ, а дальше следуйте документации вендора. Сначала создайте API-ключ.
Tip
В разделе Use in tools на странице API-ключи на вкладке cURL / SDK есть эти примеры с уже подставленным ключом.
Anthropic SDK#
Базовый URL https://halfoff.dev без /v1: версию SDK добавляет сам.
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://halfoff.dev",
api_key=os.environ["HALFOFF_API_KEY"],
)
message = client.messages.create(
model="claude-sonnet-5.5",
max_tokens=1024,
messages=[{"role": "user", "content": "Suggest a name for a CLI that renames files."}],
)
print(message.content[0].text)OpenAI SDK#
Базовый URL https://halfoff.dev/v1.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://halfoff.dev/v1",
api_key=os.environ["HALFOFF_API_KEY"],
)
completion = client.chat.completions.create(
model="gpt-6.1-sol",
messages=[{"role": "user", "content": "Write a regex that matches ISO dates."}],
)
print(completion.choices[0].message.content)Chat Completions принимает любую текстовую модель, поэтому тот же клиент может вызывать и claude-sonnet-5.5, и gemini-3.1-pro: достаточно изменить model.
Google Gen AI SDK#
Базовый URL https://halfoff.dev передаётся через HTTP-параметры.
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["HALFOFF_API_KEY"],
http_options=types.HttpOptions(base_url="https://halfoff.dev"),
)
response = client.models.generate_content(
model="gemini-3.1-pro",
contents="Summarise the CAP theorem in one paragraph.",
)
print(response.text)Подробности по форматам: Anthropic Messages, OpenAI Chat Completions, Gemini.
Исправление ошибок#
| Что вы видите | Что делать |
|---|---|
401 Missing API key | Клиент не отправил ключ. Проверьте, что HALFOFF_API_KEY задана там, где выполняется ваш код. |
401 Invalid or revoked API key | Ключ введён с ошибкой, обрезан или отозван. Вставьте его заново или создайте новый. |
404 Model '...' is not available | Такого id нет. Скопируйте его из GET /v1/models или из списка моделей. |
404 и /v1/v1/ в пути | Вы передали Anthropic SDK https://halfoff.dev/v1. Он сам добавляет /v1, поэтому передавайте https://halfoff.dev; форму с /v1 принимает только OpenAI SDK. |
402 | Баланс исчерпан или ключ достиг лимита расходов. См. Биллинг. |
Остальные статусы описаны в разделе Ошибки.