Довідник 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 | Генерація 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 | Перевищено rate limit ключа |
5xx | Помилка upstream-провайдера — повторіть за кілька секунд |