Заголовки
Заголовки запроса и ответа API: ключ, номер запроса x-request-id, цена x-veselo-cost-rub, остаток, лимиты x-ratelimit, Retry-After и CORS.
Обновлено:
Запрос
| Заголовок | Что это |
|---|---|
Authorization: Bearer sk-vsl-… | ключ API |
x-api-key: sk-vsl-… | ключ для программ, которые не умеют Authorization, — так передают ключ SDK Anthropic; если есть оба, берётся Authorization |
Content-Type: application/json | обязателен у POST |
anthropic-version, anthropic-beta | у /v1/messages принимаем любые, не обязательны и ни на что не влияют |
Ответ
| Заголовок | Когда | Что это |
|---|---|---|
x-request-id | всегда | номер запроса req_…; назови его поддержке |
x-veselo-cost-rub | ответ без стриминга | цена запроса, ₽, например 0.02 |
x-veselo-balance-rub | ответ без стриминга | сколько можно потратить после запроса, ₽: свободное на API-счёте |
x-ratelimit-limit-requests | /chat/completions | лимит запросов в минуту |
x-ratelimit-remaining-requests | /chat/completions | сколько ещё можно в текущем окне |
x-ratelimit-reset-requests | /chat/completions | через сколько окно освободится, например 37s |
retry-after | 429 | через сколько секунд повторить |
content-type | всегда | application/json, у потока — text/event-stream |
У потока заголовков с ценой и остатком нет: цена приходит в последнем куске, usage.cost_rub.
curl
curl -s -D - -o /dev/null https://veselo.ai/v1/chat/completions \
-H "Authorization: Bearer $VESELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek/deepseek-v4.1-flash-ultrafast", "max_tokens": 50, "messages": [{"role": "user", "content": "Привет"}]}'Ответ
HTTP/2 200
content-type: application/json; charset=utf-8
x-request-id: req_5b2e9c0d41f84a7f9e3c2a1b0d6f8e47
x-ratelimit-limit-requests: 60
x-ratelimit-remaining-requests: 59
x-ratelimit-reset-requests: 60s
x-veselo-cost-rub: 0.01
x-veselo-balance-rub: 298.24
access-control-allow-origin: *CORS
API отвечает с Access-Control-Allow-Origin: *, поэтому его можно звать прямо из браузера. Разрешены заголовки запроса authorization, content-type, x-api-key, idempotency-key, http-referer, x-title, openai-organization, openai-project, anthropic-version, anthropic-beta. Программе в браузере видны x-request-id, x-veselo-cost-rub, x-veselo-balance-rub, retry-after и x-ratelimit-*.
Библиотеки, которые добавляют к запросу свои заголовки (например, x-stainless-* у SDK OpenAI), из браузера могут не пройти — там надёжнее обычный fetch, см. пример в разделе Стриминг.
Ключ в коде страницы увидит любой посетитель. Из браузера зови API только в своих инструментах, а на сайте — через свой сервер.