Gunakan satu Base URL untuk menjangkau model AI Tiongkok.

Hermes Agent

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

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

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.

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

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

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

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

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

Pembuatan Gambar

Kirim prompt dalam format JSON. Baca aset yang dihasilkan dari data[0].url, atau dari data[0].b64_json saat model yang dipilih mengembalikan base64.

Parameter utama: prompt dan model wajib diisi. Gunakan size untuk resolusi, n untuk jumlah gambar, dan response_format untuk url atau b64_json. quality dan style bersifat khusus model; nilai umum meliputi standard, hd, atau auto.

curl https://api.chinaapi.ai/v1/images/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic skyline at blue hour",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1
  }'

Pembuatan Gambar Gemini

Model gambar Gemini menggunakan bentuk permintaan OpenAI Chat Completions. Baca gambar Markdown yang dihasilkan dari choices[0].message.content; payload gambarnya adalah URL data:image/....

Parameter utama: kirim ID model katalog yang sudah masuk akun di model dan prompt gambar di messages. Jangan kirim model ini ke /v1/images/generations.

curl https://api.chinaapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<GEMINI_IMAGE_MODEL>",
    "messages": [
      {
        "role": "user",
        "content": "Generate a cinematic skyline at blue hour"
      }
    ],
    "stream": false
  }'

Ucapan ke Teks

Unggah audio sebagai multipart form data; jangan atur header Content-Type secara manual. Teks yang dikenali dikembalikan dalam field text.

Parameter utama: kirim model dan file sebagai field multipart. Gunakan response_format berupa json, text, atau verbose_json saat didukung oleh model yang dipilih.

curl https://api.chinaapi.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -F "model=qwen3-asr-flash" \
  -F "file=@speech.wav" \
  -F "response_format=json"

Teks ke Ucapan

Isi respons berupa audio biner, jadi simpan ke file. alloy memilih suara default model; sebuah model juga dapat mempublikasikan ID suara khusus penyedia.

Parameter utama: gunakan input, model, dan voice. Pilih output dengan response_format seperti mp3 atau wav; speed dan instructions tersedia saat didukung oleh model yang dipilih.

curl https://api.chinaapi.ai/v1/audio/speech \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-v2.5-tts",
    "input": "Hello from ChinaAPI.",
    "voice": "alloy",
    "response_format": "mp3"
  }' \
  --output speech.mp3

Pembuatan Video

Pembuatan video bersifat asinkron. Kirim sekali, simpan task_id yang dikembalikan, lalu polling GET /v1/video/generations/{task_id} hingga tugas berhasil atau gagal. Membuat tugas dapat menggunakan kuota.

Parameter utama: prompt dan model memulai tugas. Gunakan duration, width, height, fps, dan n jika didukung. Resolusi adalah kontrol kejernihan yang umum. Masukkan kontrol khusus penyedia seperti quality, quality_level, negative_prompt, atau pengaturan kamera ke metadata hanya jika tercantum untuk model tersebut.

curl https://api.chinaapi.ai/v1/video/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "A paper boat crossing a moonlit lake",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'

curl https://api.chinaapi.ai/v1/video/generations/$TASK_ID \
  -H "Authorization: Bearer $CHINAAPI_KEY"

Embeddings

Kirim satu string atau array string. Vektor dikembalikan dalam data[].embedding dengan urutan yang sama seperti input.

Parameter utama: input menerima satu string atau sekumpulan batch. Gunakan dimensions dan encoding_format hanya jika didukung oleh model embedding yang dipilih.

curl https://api.chinaapi.ai/v1/embeddings \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-v4",
    "input": ["ChinaAPI connects Chinese AI models."]
  }'

Rerank

Beri peringkat dokumen kandidat terhadap sebuah query. Baca hasil yang sudah diurutkan dan skor relevansinya dari results.

Parameter utama: kirim query dan documents; gunakan top_n untuk membatasi jumlah kandidat berperingkat yang dikembalikan.

curl https://api.chinaapi.ai/v1/rerank \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gte-rerank-v2",
    "query": "How do I call Chinese AI models?",
    "documents": [
      "Use one ChinaAPI Base URL and API key.",
      "Install a local database."
    ],
    "top_n": 2
  }'