> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API-Konfiguration und technische Integration

## 1. Was sollte ich als API-Basis-URL eintragen?

Je nach Protokoll gibt es hauptsächlich folgende Optionen:

* OpenAI-kompatibles Format: [https://api.highwayapi.ai/openai](https://api.highwayapi.ai/openai) oder [https://api.highwayapi.ai/openai/v1/chat/completions](https://api.highwayapi.ai/openai/v1/chat/completions)
* Natives Anthropic-Protokoll: [https://api.highwayapi.ai/anthropic](https://api.highwayapi.ai/anthropic) （für Tools wie Claude Code）
* Speziell für Bild-/Videogenerierung: [https://api.highwayapi.ai/v3/](https://api.highwayapi.ai/v3/) （z. B. Gemini, Nano Banana usw.）

Hinweis: Wenn ein 404-Fehler auftritt, prüfen Sie bitte, ob am Ende der URL versehentlich ein zusätzliches /v1 steht. Verschiedene Tools fügen Pfade unterschiedlich zusammen.

## 2. Was tun, wenn beim Aufruf 401 "Ungültiges Token" zurückgegeben wird?

1. Stellen Sie sicher, dass der API Key korrekt erstellt wurde: [https://jiekou.ai/settings/key-management](https://jiekou.ai/settings/key-management)
2. Stellen Sie sicher, dass das Format von Authorization im Request-Header lautet: Bearer sk\_xxxxxx
3. Wenn Sie Claude Code verwenden, sollte die Umgebungsvariable auf ANTHROPIC\_AUTH\_TOKEN=sk\_xxxxx gesetzt werden（ohne Bearer-Präfix; das Tool fügt es automatisch hinzu）

## 3. Wie prüfe ich einen 404-Fehler "page not found"?

Häufige Ursachen:

* Falsche URL: z. B. /v3/glm-asr wurde verwendet, aber falsch geschrieben
* Falsches Modell-Routing: z. B. müssen Codex-Modelle /v1/responses statt /v1/chat/completions verwenden
* Automatisches Zusammensetzen durch Tools: Einige Tools（z. B. cc-switch）fügen automatisch /chat/completions hinzu; in diesem Fall sollte die Base URL diesen Pfad nicht enthalten

## 4. Wie konfiguriere ich Jiekou.AI in Claude Code?

Die Umgebungsvariablen werden wie folgt konfiguriert:

Windows cmd：

```
set ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
set ANTHROPIC_MODEL=claude-opus-4-1-20250805
set ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
```

Mac/Linux bash：

```
export ANTHROPIC_BASE_URL=https://api.highwayapi.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=sk_YOUR_API_KEY
export ANTHROPIC_MODEL=claude-opus-4-1-20250805
export ANTHROPIC_SMALL_FAST_MODEL=claude-sonnet-4-20250514
```

Referenzdokumentation: [https://docs.jiekou.ai/docs/integration/claudecode](https://docs.jiekou.ai/docs/integration/claudecode)

## 5. Wie löse ich es, wenn Claude Code eine Anmeldung erzwingt/eine Verifizierung erfordert?

Die neueste Version von Claude Code kann eine Anmeldung zwingend verlangen. Lösungen:

* Verwenden Sie stattdessen das Cline-Plugin（im VSCode-Plugin-Marktplatz suchen）
* Oder verwenden Sie es zusammen mit Weiterleitungs-Tools wie cc-switch

## 6. Wie ruft man GPT-5.1- / Codex-Modelle auf? Warum wird ein 400-Fehler zurückgegeben?

Die GPT-5.1-Serie（einschließlich Codex）muss die Responses API von OpenAI verwenden, nicht Chat Completions:

```
curl "https://api.highwayapi.ai/openai/v1/responses" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API Key>" \
-d '{
    "model": "gpt-5.1-codex",
    "input": [...],
    "max_output_tokens": 64000
  }'
```

## 7. Was tun bei Fehlern im Zusammenhang mit "thinking block" bei Claude 4.5?

Die Fehlermeldung lautet in der Regel: Expected 'thinking' or 'redacted\_thinking', but found 'text'. Das liegt daran, dass Claude 4.5 bei aktivierter Thinking-Funktion verlangt, dass der Kontext ein bestimmtes Format für Denkblöcke enthält. Empfehlung:

* Löschen Sie den Gesprächsverlauf und beginnen Sie neu
* Oder deaktivieren Sie die Thinking-Funktion（falls nicht benötigt）
* Verwenden Sie das native Anthropic-Protokoll statt des OpenAI-kompatiblen Protokolls（letzteres unterstützt Thinking möglicherweise nicht vollständig）

## 8. Claude API gibt den Fehler "Eingabe zu lang" zurück?

Claude-Modelle haben Beschränkungen für die Eingabelänge（max\_tokens unterstützt in der Regel maximal 64000）. Bitte prüfen Sie:

* Länge des Eingabetextes
* Größe von Base64-Bildern（zu große Bilder sollten zuerst komprimiert werden）
* Kumulierte Länge des bisherigen Gesprächskontexts

***

**Support kontaktieren**

Wenn die obigen FAQ Ihr Problem nicht lösen, kontaktieren Sie bitte den technischen Support über die folgenden Wege:

* Unternehmens-WeChat/WeChat-Supportgruppe（empfohlen, schnellste Antwort）
* Format der bereitzustellenden Informationen:
  * Problembeschreibung + Screenshot
  * Konto-ID (UUID)
  * Trace ID（falls vorhanden, in der Regel in der Fehlermeldung）
  * Request-Parameter（nach Maskierung sensibler Daten）