Справочник API
apikey.sh говорит по протоколу OpenAI. Любой SDK, фреймворк или инструмент, который уже работает с OpenAI, заработает здесь после смены base_url.Быстрый старт
Создайте ключ в панели, положите его в переменную окружения и укажите base URL:from openai import OpenAI
client = OpenAI(
api_key="sk-ak-...", # your key from apikey.sh
base_url="https://apikey.sh/v1", # change only this line
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)Base URL
Один и тот же API-ключ работает на всех доменах ниже — выбирайте любой.Anthropic SDK использует base URL без /v1 (например, https://apikey.sh).
https://apikey.sh/v1работаетhttps://api.onie.net/v1работаетАутентификация
Передайте ключ в заголовке:
Authorization: Bearer sk-ak-... # or, with the Anthropic SDK: x-api-key: sk-ak-...Ключ показывается только один раз при создании. Потеряли — создайте новый и отзовите старый: отзыв срабатывает сразу.
Endpoints
| POST | /v1/chat/completions | Генерация ответов (поддерживает SSE streaming и tool calling) |
| POST | /v1/embeddings | Создание embeddings для RAG и семантического поиска |
| POST | /v1/images/generations | Генерация изображений (модели gpt-image-*) |
| GET | /v1/models | Список моделей, доступных текущему ключу |
Streaming
Добавьте stream: true, чтобы получать токены в реальном времени по SSE:
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Write a short poem"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")Prompt caching
На поддерживаемых моделях (линейка GPT-5.x) повторяющийся префикс промпта кэшируется автоматически и тарифицируется по кэш-ставке — примерно на 90% дешевле новых токенов. Менять код не нужно; количество кэшированных токенов видно в разделе «Использование» в панели.В ответе есть usage.prompt_tokens_details.cached_tokens — можно сверить самостоятельно.
Лимиты на ключ
У каждого ключа может быть свой лимит расходов и список разрешённых моделей. Это безопасный способ раздать ключи по проектам и коллегам, не рискуя бюджетом. Настраивается в «Панель → API-ключи».
Коды ошибок
401 | Неверный или отозванный ключ либо заблокированный аккаунт |
402 | Закончился баланс — пополните в панели |
403 | Модель не входит в список, разрешённый этому ключу |
429 | Превышен лимит запросов для ключа |
5xx | Ошибка провайдера — повторите через несколько секунд |