Trae

Trae peut se connecter à HiAPI via un modèle personnalisé. Le API format (API 格式) de Trae diffère selon le protocole, et un modèle ne se connecte que si le format est correct. Il y a un exemple pour chacun : claude-opus-5-5 avec le format Anthropic Messages et gpt-6-astra avec le format OpenAI Chat Completions. Ce tutoriel a été vérifié sur Trae 3.4.4.

1. Préparer une clé API HiAPI

Préparez une clé comme décrit dans Obtenir une clé API, cliquez sur l’icône de copie à côté de la clé et copiez la clé API HiAPI complète pour la saisir dans Trae ci-dessous.

2. Choisir le format d’API

Protocole	À choisir dans Trae	Modèles adaptés
Anthropic Messages	Anthropic Messages format	Série Claude
OpenAI Chat Completions	OpenAI Chat Completions format	Série GPT, série DeepSeek
OpenAI Responses	OpenAI Responses API format	Cas nécessitant les fonctionnalités Responses

Les modèles d’exemple de cette page ont tous été testés avec le tableau ci-dessus. Pour un autre modèle, choisissez d’abord le format dans le tableau, enregistrez et envoyez un message pour l’essayer ; si vous obtenez 400 does not support this endpoint, changez de format.

3. Connecter Claude (format Anthropic Messages)

3.1 Ouvrir l’entrée

Ouvrez les réglages en bas à gauche de Trae, trouvez Models (模型) à gauche et cliquez sur Add Model → Custom Model (添加模型 → 自定义模型).

3.2 Renseigner les champs

Avec claude-opus-5-5 comme exemple :

Champ	Valeur
API format (API 格式)	Anthropic Messages format
Custom request address (自定义请求地址)	https://api.hiapi.ai (sans /v1)
Full URL (完整 URL)	Off
Model ID (模型 ID)	claude-opus-5-5
Model display name (模型展示名称)	Un nom que vous reconnaîtrez, par exemple claude-opus-5-5 (HiAPI)
API key (API 密钥)	votre clé API HiAPI

Trae ajoute automatiquement /v1/messages à la fin de l’adresse, la requête finale va donc vers https://api.hiapi.ai/v1/messages.

3.3 Passer à un autre modèle Claude

Changez uniquement l’ID du modèle pour celui du modèle visé ; laissez les autres champs tels quels. Consultez la page du modèle pour la longueur de contexte et la sortie maximale.

4. Connecter GPT et DeepSeek (format OpenAI Chat Completions)

Entrez de la même façon, via Add Model → Custom Model (添加模型 → 自定义模型). Avec gpt-6-astra comme exemple :

Champ	Valeur
API format (API 格式)	OpenAI Chat Completions format
Custom request address (自定义请求地址)	https://api.hiapi.ai/v1
Full URL (完整 URL)	Off
Model ID (模型 ID)	gpt-6-astra
Model display name (模型展示名称)	Un nom que vous reconnaîtrez, par exemple GPT-6 Astra (HiAPI)
API key (API 密钥)	votre clé API HiAPI

Trae ajoute automatiquement /chat/completions à la fin de l’adresse, la requête finale va donc vers https://api.hiapi.ai/v1/chat/completions.

Pour utiliser le format Responses, choisissez OpenAI Responses API format (format OpenAI Responses API) comme API format et renseignez aussi https://api.hiapi.ai/v1 comme adresse. Ce format ne prend en charge que la sortie en streaming, pensez donc à garder le streaming activé.

5. Aide-mémoire des adresses

Le chemin ajouté par Trae change selon le format d’API, et une adresse incorrecte renvoie un 404 immédiatement :

API format	À saisir	Trae ajoute	Adresse finale
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

La règle : vérifiez si le chemin ajouté par Trae contient v1. Si oui, n’incluez pas v1 dans ce que vous saisissez ; sinon, incluez-le vous-même. Gardez l’interrupteur Full URL (完整 URL) désactivé pour que Trae ajoute le chemin ; quand il est activé, vous devez saisir l’adresse de requête complète.

6. Vérifier

Après avoir enregistré la configuration, démarrez une nouvelle session pour tester.

6.1 Chat

Passez au modèle que vous venez d’ajouter et envoyez « Bonjour, présentez-vous en une phrase. » Une réponse normale signifie que la connexion fonctionne.

6.2 Appel d’outils

Créez d’abord tool-call-test.txt dans le dossier du projet ouvert dans Trae, écrivez une ligne hello hiapi et enregistrez. Allez ensuite sur la page tâche / Agent et envoyez « N’utilisez l’outil de lecture de fichier qu’une seule fois. Lisez tout le contenu de tool-call-test.txt et renvoyez-le exactement tel quel. Ne modifiez pas le fichier, ne lisez aucun autre fichier et ne devinez pas le contenu à partir du nom du fichier. » Un appel d’outil apparaît et renvoie hello hiapi, c’est donc validé. Lors des tests, claude-opus-5-5 et gpt-6-astra ont tous deux pu discuter et appeler des outils normalement.

Ce tutoriel ne couvre que l’accès aux modèles texte ; pour permettre à Trae d’appeler les outils d’image et de vidéo de HiAPI, voir la section Trae du guide de configuration MCP.

7. Dépannage

Seuls les problèmes propres à Trae sont listés ici. Pour les erreurs courantes comme 401, 404 et 429, voir Erreurs courantes.

Erreur	Cause	Correction
404	L’adresse contient un /v1 en trop ou manquant	Renseignez-la selon le tableau de la section 5
400 This model does not support this endpoint	Le format d’API et le modèle ne correspondent pas	Choisissez le format Anthropic Messages pour Claude ; le format OpenAI Chat Completions pour GPT et DeepSeek
401 / invalid api key	La clé API HiAPI est incorrecte	Collez-la à nouveau, sans espace avant ni après
Erreurs liées à max_tokens	La sortie maximale n’est pas définie	Définissez une valeur raisonnable dans la configuration avancée ; quand gpt-6-astra utilise Chat Completions, ne définissez pas max_tokens ni temperature
stream: must be true	Ce modèle ne prend en charge que la sortie en streaming	Activez la sortie en streaming
Bloqué indéfiniment / timeout	Problème réseau, ou format d’API incorrect	Vérifiez le réseau et confirmez que le format d’API est correct