---
title: "Заголовки"
description: "Заголовки запроса и ответа API: ключ, номер запроса x-request-id, цена x-veselo-cost-rub, остаток, лимиты x-ratelimit, Retry-After и CORS."
url: https://veselo.ai/docs/headers
updated: 2026-11-14T20:55:06.831Z
---

# Заголовки

Заголовки запроса и ответа API: ключ, номер запроса x-request-id, цена x-veselo-cost-rub, остаток, лимиты x-ratelimit, Retry-After и CORS.

Обновлено: 14 ноября 2026 г.

## Запрос

| Заголовок | Что это |
| --- | --- |
| `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`, см. пример в разделе [Стриминг](https://veselo.ai/docs/streaming#examples).

> Ключ в коде страницы увидит любой посетитель. Из браузера зови API только в своих инструментах, а на сайте — через свой сервер.

[← Лимиты](https://veselo.ai/docs/limits) · [Вопросы →](https://veselo.ai/docs/faq)

[Вся документация одним текстом](https://veselo.ai/docs/llms.txt) · [Все модели и цены](https://veselo.ai/models)

## Разделы документации

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- [Ключи](https://veselo.ai/docs/auth)
- [Цены и списания](https://veselo.ai/docs/pricing)
- [Модели](https://veselo.ai/docs/models)

### Как сделать

- [Сообщения и параметры](https://veselo.ai/docs/chat)
- [Стриминг](https://veselo.ai/docs/streaming)
- [Вызов функций](https://veselo.ai/docs/tools)
- [Ответ в JSON](https://veselo.ai/docs/structured-output)
- [Провайдеры](https://veselo.ai/docs/providers)
- [Без цензуры](https://veselo.ai/docs/uncensored)
- [Картинки во входе](https://veselo.ai/docs/vision)
- [Картинки](https://veselo.ai/docs/images)
- [Видео](https://veselo.ai/docs/video)
- [Озвучка](https://veselo.ai/docs/speech)
- [Музыка](https://veselo.ai/docs/music)
- [SDK и программы](https://veselo.ai/docs/sdks)
- [Claude Code](https://veselo.ai/docs/anthropic)
- [Ключ для нейросети](https://veselo.ai/docs/agents)
- [MCP](https://veselo.ai/docs/mcp)

### Справочник

- [Методы API](https://veselo.ai/docs/reference)
- [Ошибки](https://veselo.ai/docs/errors)
- [Лимиты](https://veselo.ai/docs/limits)
- **Заголовки**

### Ещё

- [Вопросы](https://veselo.ai/docs/faq)
- [Данные и приватность](https://veselo.ai/docs/privacy)
- [Изменения](https://veselo.ai/docs/changelog)
