Intégration des agents de code

Les agents de code atteignent la passerelle via le protocole qu'ils parlent déjà : /v1/messages pour les agents de type Claude, /v1/responses pour Codex et /v1/chat/completions pour les autres. Pointez l'outil vers ChinaAPI et ses requêtes conservent la même clé, le même quota, les mêmes journaux et la même facturation que votre propre trafic API.

Hermes Agent

POST /v1/chat/completions

Faites pointer le bloc model de ~/.hermes/config.yaml vers la passerelle, ou lancez hermes model et choisissez Custom endpoint en mode interactif. base_url inclut le suffixe /v1 ; Hermes ajoute lui-même /chat/completions.

model:
  default: kimi-k2.7-code
  provider: custom
  base_url: https://api.chinaapi.ai/v1
  api_key: <your ChinaAPI key>

Claude Code

POST /v1/messages

Exportez les variables d'environnement ci-dessous puis lancez claude comme d'habitude. Les variables ANTHROPIC_DEFAULT_*_MODEL associent les niveaux de modèles internes de Claude Code à des modèles ChinaAPI : c'est ce qui permet d'exécuter des modèles chinois dans un Claude Code non modifié.

export ANTHROPIC_BASE_URL=https://api.chinaapi.ai
export ANTHROPIC_AUTH_TOKEN=$CHINAAPI_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k3
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.7-code
export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5-turbo

claude

Codex

POST /v1/responses

Codex utilise le protocole Responses : wire_api doit donc valoir responses, sinon les appels d'outils échouent. Placez votre clé dans la variable d'environnement indiquée par env_key. Pour toute nouvelle intégration, utilisez deepseek-flash ; les anciens identifiants DeepSeek sont réservés à la compatibilité et ne figurent plus dans le catalogue.

model = "deepseek-flash"
model_provider = "chinaapi"

[model_providers.chinaapi]
name = "ChinaAPI"
base_url = "https://api.chinaapi.ai/v1"
wire_api = "responses"
env_key = "CHINAAPI_KEY"

Cline, Roo Code, Kilo Code

POST /v1/chat/completions

Les trois utilisent le même formulaire de fournisseur OpenAI Compatible, champ pour champ. Saisissez l'ID du modèle exactement tel qu'il apparaît dans Console → Modèles : ces outils ne récupèrent pas la liste des modèles pour un fournisseur personnalisé.

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model ID   glm-5.2

Cursor

POST /v1/chat/completions

Remplacez la base URL dans Settings → Models → OpenAI API Key. Ajoutez d'abord le nom du modèle ChinaAPI via Add model, puis ne laissez actifs que les modèles ChinaAPI, sans quoi Cursor enverra ses noms de modèles intégrés à votre URL de remplacement.

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model      deepseek-flash

OpenClaw

POST /v1/messages

Déclarez ChinaAPI comme fournisseur avec "api": "anthropic-messages" et listez les modèles que vous voulez voir proposés dans le sélecteur de session.

{
  "models": {
    "providers": {
      "chinaapi": {
        "baseUrl": "https://api.chinaapi.ai",
        "apiKey": "<your ChinaAPI key>",
        "api": "anthropic-messages",
        "models": ["kimi-k3", "glm-5.2"]
      }
    }
  }
}

Aider

POST /v1/chat/completions

Aider route selon le préfixe du modèle : conservez donc le préfixe openai/ sur le nom du modèle, même si le modèle lui-même est chinois.

export OPENAI_API_BASE=https://api.chinaapi.ai/v1
export OPENAI_API_KEY=$CHINAAPI_KEY

aider --model openai/deepseek-flash

Choisir les modèles : les noms ci-dessus sont des exemples fonctionnels, pas une liste figée. Ouvrez Console → Modèles pour voir les alias activés sur votre compte. Pour un usage agent, placez un modèle spécialisé code sur le niveau que l'agent sollicite le plus et un modèle rapide et bon marché sur son niveau léger : Claude Code envoie par exemple ses résumés d'arrière-plan au niveau Haiku, si bien que mapper ce niveau sur un petit modèle est ce qui économise le plus de quota.