Весело
Весело

Заголовки

Заголовки запроса и ответа 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-after429через сколько секунд повторить
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 только в своих инструментах, а на сайте — через свой сервер.

← Лимиты · Вопросы →

Вся документация одним текстом · Все модели и цены