Заголовки
Заголовки запроса и ответа API Morphogen.
Запрос
| Заголовок | Где | Значение |
|---|---|---|
Authorization | все эндпоинты | Bearer <ключ> |
x-api-key | все эндпоинты | ключ без префикса. Его отправляет Anthropic SDK. Достаточно одного из двух заголовков |
anthropic-version | /v1/messages | 2023-06-01. Anthropic SDK добавляет его сам |
Content-Type | запросы с телом | application/json; для речи multipart/form-data, для видео ещё допустим multipart |
X-PII-Masking | /v1/chat/completions, /v1/messages, /v1/responses | on или off (также true, false, 1, 0). Включает или выключает маскирование ПДн в запросе |
X-Morphogen-Space | все эндпоинты, которые тратят деньги | spc_…. Относит расход к пространству |
Если X-PII-Masking не передан, действует настройка организации, а без подключённой опции маскирования нет. Подробнее: Маскирование ПДн.
Ответ
| Заголовок | Где | Значение |
|---|---|---|
X-Request-Id | все ответы | идентификатор запроса. Его выдаёт сервис, значение из запроса не принимается. Для POST /v1/videos это идентификатор задачи video_… |
X-PII-Masking | эндпоинты с маскированием | applied, если маскирование применено, off иначе. Есть и в ответах с ошибкой провайдера |
Retry-After | 429, часть 5xx | пауза перед повтором в секундах |
Content-Type | все ответы | application/json; для потока text/event-stream; для файла видео video/mp4 |
Пример
curl -s https://api.morphogen.ru/v1/chat/completions \
-H "Authorization: Bearer $MORPHOGEN_API_KEY" \
-H "X-PII-Masking: on" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-6-luna", "max_tokens": 50, "messages": [{"role": "user", "content": "Меня зовут Иван Иванов"}]}' \
-D - -o /dev/null | grep -i -E "x-pii-masking|x-request-id"X-Pii-Masking: applied
X-Request-Id: gen-1760104212-Kd3vQ8mZ