Integrasi Agen Coding

Agen coding menjangkau gateway melalui protokol yang sudah mereka gunakan: /v1/messages untuk agen bergaya Claude, /v1/responses untuk Codex, dan /v1/chat/completions untuk yang lainnya. Arahkan tool Anda ke ChinaAPI, dan permintaannya tetap menggunakan kunci, kuota, log, dan penagihan yang sama seperti trafik API Anda sendiri.

Hermes Agent

POST /v1/chat/completions

Arahkan blok model pada ~/.hermes/config.yaml ke gateway, atau jalankan hermes model dan pilih Custom endpoint secara interaktif. base_url menyertakan sufiks /v1; /chat/completions ditambahkan sendiri oleh Hermes.

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

Export ketiga variabel lingkungan tersebut lalu jalankan claude seperti biasa. Variabel ANTHROPIC_DEFAULT_*_MODEL memetakan tingkatan model internal Claude Code ke model ChinaAPI, sehingga Anda dapat menjalankan model Tiongkok di dalam Claude Code tanpa modifikasi.

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 menggunakan protokol Responses, sehingga wire_api harus bernilai responses; membiarkannya pada format chat akan merusak pemanggilan tool. Masukkan kunci Anda ke variabel lingkungan yang ditentukan oleh env_key. deepseek-v4-pro menggunakan format yang sama, jadi cukup ganti nama modelnya untuk menukar biaya dengan kemampuan.

model = "deepseek-v4-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

Ketiganya menggunakan formulir penyedia OpenAI Compatible yang sama persis, field demi field. Masukkan model ID persis seperti yang muncul di Konsol → Model; tool ini tidak mengambil daftar model untuk penyedia kustom.

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

Cursor

POST /v1/chat/completions

Timpa base URL di Settings → Models → OpenAI API Key. Tambahkan dahulu nama model ChinaAPI melalui Add model, lalu aktifkan hanya model ChinaAPI, karena jika tidak, Cursor akan mengirim nama model bawaannya ke URL pengganti Anda.

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

OpenClaw

POST /v1/messages

Deklarasikan ChinaAPI sebagai penyedia dengan "api": "anthropic-messages" dan daftarkan model yang ingin Anda tampilkan di pemilih sesi.

{
  "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 merutekan berdasarkan prefiks nama model, jadi pertahankan prefiks openai/ pada nama model meskipun model itu sendiri adalah model Tiongkok.

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

aider --model openai/deepseek-v4-pro

Memilih model: nama model di atas adalah contoh yang berfungsi, bukan daftar tetap. Buka Konsol → Model untuk melihat alias yang aktif di akun Anda. Untuk pekerjaan agen, sebaiknya gunakan model yang dikhususkan untuk coding pada tingkatan yang paling sering dipakai agen, dan model cepat yang murah pada tingkatan ringannya. Misalnya, Claude Code mengirim ringkasan latar belakang ke tingkatan Haiku, sehingga memetakan tingkatan itu ke model kecil paling menghemat kuota.