Request- & Response-Header
Die HTTP-Header, die Kontinent liest und setzt, und was Sie damit tun.
Kontinent spricht das OpenAI-Format, deshalb ist Authorization der einzige Header, den Sie senden müssen. Einige weitere helfen Ihnen, Anfragen nachzuverfolgen und auf Limits zu reagieren.
Request-Header
| Header | Pflicht | Bedeutung |
|---|---|---|
Authorization | Ja | Bearer sk-kt-..., siehe Authentifizierung. Für /healthz nicht nötig. |
Content-Type | Ja, mit Body | application/json, bei Transkriptionen multipart/form-data. |
X-Request-Id | Nein | Ihre eigene Trace-ID. Kontinent übernimmt sie und gibt sie zurück, damit eine ID eine Anfrage von Ihrem System durch unseres begleitet. Bis zu 64 druckbare ASCII-Zeichen; alles andere ersetzen wir durch eine eigene ID. |
Für Routing, Souveränität oder Guardrails gibt es keine Header. Diese werden in der Konsole eingestellt und gelten pro Schlüssel, eine Anfrage kann sie also nicht lockern.
Response-Header
| Header | Bei | Bedeutung |
|---|---|---|
X-Request-Id | Jeder API-Antwort (nicht /healthz) | Ihre ID oder eine, die Kontinent erzeugt hat. Nennen Sie sie, wenn Sie den Support kontaktieren. |
X-Generation-Id | Jeder API-Antwort, auch Ablehnungen (nicht /healthz) | Die ID des Abrechnungsdatensatzes für diesen Aufruf. Damit gleichen Sie einen Aufruf mit Ihren Logs und Ihrer Rechnung ab. Sie können sie nicht selbst setzen. |
X-Provider | Bedienten Antworten | Der Anbieter, der tatsächlich geantwortet hat, etwa scaleway nach einem Failover von mistral. |
X-Served-Model | Bedienten Antworten | Das Modell, das tatsächlich geantwortet hat. Weicht nach einem Fallback oder beim Aufruf einer Routing-Policy von der angefragten ID ab. |
Retry-After | Manchen 429 und 503 | Sekunden bis zum nächsten Versuch: 60 bei rate_limit_exceeded, 10 bei transcriptions_busy. |
X-Provider und X-Served-Model kommen mit den Headern, vor dem Body. Bei einem Stream wissen Sie also schon vor dem ersten Token, woher die Antwort kommt. Auf den Endpunkten, deren Body Kontinent selbst baut, ist die id im Body die Generation-ID mit Endpunkt-Präfix (chatcmpl- oder resp_), siehe Streaming.
Header mit dem OpenAI-SDK lesen
Die SDKs verstecken Header standardmäßig. Nutzen Sie die rohe Antwort:
const { data, response } = await client.chat.completions
.create({ model: "mistral/mistral-small-4", messages })
.withResponse();
console.log(response.headers.get("x-served-model"));
console.log(response.headers.get("x-generation-id"));raw = client.chat.completions.with_raw_response.create(
model="mistral/mistral-small-4", messages=messages
)
print(raw.headers.get("x-served-model"))
completion = raw.parse()Zugriff aus dem Browser
Die API beantwortet Cross-Origin-Anfragen nur von https://docs.kontinent.ai, damit die interaktive API-Referenz Testanfragen senden kann. Rufen Sie die API aus Ihrem Backend auf, nie aus einem Browser mit Ihrem Schlüssel darin.