Trae

Trae kann sich über ein eigenes Modell mit HiAPI verbinden. Das API-Format (API 格式) von Trae unterscheidet sich je nach Protokoll, und ein Modell verbindet sich nur, wenn das Format richtig ist. Für jedes gibt es ein Beispiel: claude-opus-5-5 mit dem Format Anthropic Messages und gpt-6-astra mit dem Format OpenAI Chat Completions. Diese Anleitung wurde mit Trae 3.4.4 verifiziert.

1. HiAPI API-Key vorbereiten

Bereite einen Key vor, wie unter API-Key erstellen beschrieben, klicke auf das Kopiersymbol neben dem Key und kopiere den vollständigen HiAPI API-Key, um ihn unten in Trae einzutragen.

2. Das API-Format wählen

Protokoll	In Trae wählen	Geeignete Modelle
Anthropic Messages	Anthropic Messages format	Claude-Serie
OpenAI Chat Completions	OpenAI Chat Completions format	GPT-Serie, DeepSeek-Serie
OpenAI Responses	OpenAI Responses API format	Szenarien, die Responses-Funktionen benötigen

Die Beispielmodelle auf dieser Seite wurden alle mit der obigen Tabelle getestet. Wähle für ein anderes Modell zuerst das Format aus der Tabelle, speichere, sende eine Nachricht zum Ausprobieren; wenn du 400 does not support this endpoint erhältst, wechsle zu einem anderen Format.

3. Claude verbinden (Format Anthropic Messages)

3.1 Einstieg öffnen

Öffne die Einstellungen unten links in Trae, suche links Models (模型) und klicke auf Add Model → Custom Model (添加模型 → 自定义模型).

3.2 Felder ausfüllen

Mit claude-opus-5-5 als Beispiel:

Feld	Wert
API format (API 格式)	Anthropic Messages format
Custom request address (自定义请求地址)	https://api.hiapi.ai (ohne /v1)
Full URL (完整 URL)	Aus
Model ID (模型 ID)	claude-opus-5-5
Model display name (模型展示名称)	Ein Name, den du wiedererkennst, zum Beispiel claude-opus-5-5 (HiAPI)
API key (API 密钥)	dein HiAPI API-Key

Trae hängt /v1/messages automatisch an das Ende der Adresse an, die endgültige Anfrage geht also an https://api.hiapi.ai/v1/messages.

3.3 Zu einem anderen Claude-Modell wechseln

Ändere nur die Modell-ID auf das Zielmodell; lasse die anderen Felder unverändert. Kontextlänge und maximale Ausgabe findest du auf der Modellseite.

4. GPT und DeepSeek verbinden (Format OpenAI Chat Completions)

Gehe denselben Weg über Add Model → Custom Model (添加模型 → 自定义模型). Mit gpt-6-astra als Beispiel:

Feld	Wert
API format (API 格式)	OpenAI Chat Completions format
Custom request address (自定义请求地址)	https://api.hiapi.ai/v1
Full URL (完整 URL)	Aus
Model ID (模型 ID)	gpt-6-astra
Model display name (模型展示名称)	Ein Name, den du wiedererkennst, zum Beispiel GPT-6 Astra (HiAPI)
API key (API 密钥)	dein HiAPI API-Key

Trae hängt /chat/completions automatisch an das Ende der Adresse an, die endgültige Anfrage geht also an https://api.hiapi.ai/v1/chat/completions.

Um das Responses-Format zu verwenden, wähle OpenAI Responses API format als API-Format und trage als Adresse ebenfalls https://api.hiapi.ai/v1 ein. Dieses Format unterstützt nur Streaming-Ausgabe, denke also daran, Streaming eingeschaltet zu lassen.

5. Übersicht der Adressen

Der von Trae angehängte Pfad ändert sich mit dem API-Format, und eine falsche Adresse liefert sofort 404:

API-Format	Eintragen	Trae hängt an	Endgültige Adresse
Anthropic Messages	https://api.hiapi.ai	/v1/messages	/v1/messages
OpenAI Chat Completions	https://api.hiapi.ai/v1	/chat/completions	/v1/chat/completions
OpenAI Responses	https://api.hiapi.ai/v1	/responses	/v1/responses

Die Regel: Prüfe, ob der von Trae angehängte Pfad v1 enthält. Wenn ja, füge v1 in dem, was du einträgst, nicht hinzu; wenn nicht, füge es selbst hinzu. Lasse den Schalter Full URL (完整 URL) ausgeschaltet, damit Trae den Pfad anhängt; ist er eingeschaltet, musst du die vollständige Anfrageadresse eingeben.

6. Überprüfen

Starte nach dem Speichern der Konfiguration eine neue Sitzung zum Testen.

6.1 Chat

Wechsle zu dem gerade hinzugefügten Modell und sende „Hallo, stell dich in einem Satz vor.” Eine normale Antwort bedeutet, dass die Verbindung funktioniert.

6.2 Tool-Aufruf

Lege zuerst im in Trae geöffneten Projektordner die Datei tool-call-test.txt an, schreibe eine Zeile hello hiapi hinein und speichere sie. Gehe dann zur Seite Aufgabe / Agent und sende „Verwende das Dateilese-Tool nur einmal. Lies den gesamten Inhalt von tool-call-test.txt und gib ihn exakt so zurück. Ändere die Datei nicht, lies keine anderen Dateien und rate den Inhalt nicht aus dem Dateinamen.” Ein Tool-Aufruf erscheint und gibt hello hiapi zurück, damit ist der Test bestanden. Im Test konnten sowohl claude-opus-5-5 als auch gpt-6-astra normal chatten und Tools aufrufen.

Diese Anleitung behandelt nur den Zugang zu Textmodellen; damit Trae die Bild- und Video-Tools von HiAPI aufrufen kann, siehe den Trae-Abschnitt der MCP-Einrichtungsanleitung.

7. Fehlerbehebung

Hier werden nur Probleme aufgeführt, die für Trae spezifisch sind. Zu häufigen Fehlern wie 401, 404 und 429 siehe Häufige Fehler.

Fehler	Ursache	Behebung
404	Die Adresse hat ein überzähliges oder fehlendes /v1	Trage sie gemäß der Tabelle in Abschnitt 5 ein
400 This model does not support this endpoint	Das API-Format und das Modell passen nicht zusammen	Wähle für Claude das Format Anthropic Messages; wähle für GPT und DeepSeek das Format OpenAI Chat Completions
401 / invalid api key	Der HiAPI API-Key ist falsch	Füge ihn erneut ein, ohne Leerzeichen davor oder danach
Fehler zu max_tokens	Max output tokens ist nicht gesetzt	Setze in der erweiterten Konfiguration einen sinnvollen Wert; wenn gpt-6-astra Chat Completions verwendet, setze weder max_tokens noch temperature
stream: must be true	Dieses Modell unterstützt nur Streaming-Ausgabe	Aktiviere die Streaming-Ausgabe
Endloses Laden / Timeout	Ein Netzwerkproblem oder das falsche API-Format	Prüfe das Netzwerk und bestätige, dass das API-Format richtig ist