ใช้ Base URL เดียวเพื่อเข้าถึงโมเดล AI จีน

Hermes Agent

ชี้บล็อก model ใน ~/.hermes/config.yaml ไปที่เกตเวย์ หรือรัน hermes model แล้วเลือก Custom endpoint แบบโต้ตอบ base_url ต้องมีส่วนต่อท้าย /v1 ด้วย ส่วน /chat/completions นั้น Hermes จะต่อให้เอง

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

Claude Code

Export ตัวแปรสภาพแวดล้อมทั้งสามตัว แล้วเริ่ม claude ตามปกติ ตัวแปร ANTHROPIC_DEFAULT_*_MODEL จะแมประดับโมเดลภายในของ Claude Code ไปยังโมเดลของ ChinaAPI ซึ่งเป็นวิธีที่ทำให้รันโมเดลจีนภายใน Claude Code ที่ไม่ถูกดัดแปลงได้

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 ใช้โปรโตคอล Responses ดังนั้น wire_api ต้องเป็น responses หากปล่อยไว้เป็นรูปแบบ chat การเรียกใช้เครื่องมือจะพัง ใส่คีย์ของคุณในตัวแปรสภาพแวดล้อมที่ระบุโดย 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

ทั้งสามตัวใช้ฟอร์มผู้ให้บริการ OpenAI Compatible แบบเดียวกันในทุกช่อง ป้อน model ID ให้ตรงกับที่แสดงใน คอนโซล → โมเดล เครื่องมือเหล่านี้จะไม่ดึงรายการโมเดลให้กับผู้ให้บริการแบบกำหนดเอง

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

Cursor

แทนที่ base URL ที่ Settings → Models → OpenAI API Key ก่อนอื่นให้เพิ่มชื่อโมเดล ChinaAPI ด้วย Add model จากนั้นเปิดใช้งานเฉพาะโมเดล ChinaAPI เท่านั้น มิเช่นนั้น Cursor จะส่งชื่อโมเดลในตัวไปยัง URL ที่คุณแทนที่ไว้

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

OpenClaw

ประกาศ ChinaAPI เป็นผู้ให้บริการด้วย "api": "anthropic-messages" แล้วระบุรายการโมเดลที่ต้องการให้เลือกได้ในตัวเลือกเซสชัน

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

Aider

Aider กำหนดเส้นทางตามคำนำหน้าชื่อโมเดล จึงต้องคงคำนำหน้า openai/ ไว้ แม้ว่าโมเดลนั้นจะเป็นโมเดลจีนก็ตาม

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

aider --model openai/deepseek-v4-pro

การสร้างรูปภาพ

ส่งพรอมป์ตในรูปแบบ JSON อ่านผลลัพธ์ที่สร้างได้จาก data[0].url หรือจาก data[0].b64_json เมื่อโมเดลที่เลือกส่งค่ากลับเป็น base64

พารามิเตอร์สำคัญ: ต้องระบุ prompt และ model ใช้ size สำหรับความละเอียด n สำหรับจำนวนรูปภาพ และ response_format สำหรับ url หรือ b64_json ส่วน quality และ style ขึ้นอยู่กับแต่ละโมเดล ค่าที่พบทั่วไป ได้แก่ standard, hd หรือ 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
  }'

การสร้างรูปภาพแบบ Gemini

โมเดลรูปภาพของ Gemini ใช้รูปแบบคำขอแบบ OpenAI Chat Completions อ่านรูปภาพ Markdown ที่สร้างได้จาก choices[0].message.content โดย payload ของรูปภาพคือ URL แบบ data:image/...

พารามิเตอร์สำคัญ: ส่ง model ID ในแคตตาล็อกหลังเข้าสู่ระบบไว้ใน model และใส่พรอมป์ตรูปภาพใน messages อย่าส่งโมเดลนี้ไปยัง /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
  }'

แปลงเสียงเป็นข้อความ

อัปโหลดไฟล์เสียงแบบ multipart form data อย่าตั้งค่าส่วนหัว Content-Type ด้วยตนเอง ข้อความที่รู้จำได้จะถูกส่งกลับในฟิลด์ text

พารามิเตอร์สำคัญ: ส่ง model และ file เป็นฟิลด์แบบ multipart ใช้ response_format เป็น json, text หรือ verbose_json เมื่อโมเดลที่เลือกรองรับ

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"

แปลงข้อความเป็นเสียง

เนื้อหาการตอบกลับเป็นไฟล์เสียงแบบไบนารี จึงควรเขียนลงไฟล์ alloy จะเลือกเสียงเริ่มต้นของโมเดล และบางโมเดลอาจมี ID เสียงเฉพาะของผู้ให้บริการให้ใช้ด้วย

พารามิเตอร์สำคัญ: ใช้ input, model และ voice เลือกผลลัพธ์ด้วย response_format เช่น mp3 หรือ wav ส่วน speed และ instructions ใช้ได้เมื่อโมเดลที่เลือกรองรับ

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

การสร้างวิดีโอ

การสร้างวิดีโอเป็นแบบอะซิงโครนัส ส่งคำขอเพียงครั้งเดียว บันทึก task_id ที่ได้รับ แล้ว poll GET /v1/video/generations/{task_id} จนกว่างานจะสำเร็จหรือล้มเหลว การสร้างงานอาจใช้โควตา

พารามิเตอร์สำคัญ: prompt และ model ใช้เริ่มงาน ใช้ duration, width, height, fps และ n เมื่อรองรับ ความละเอียดเป็นตัวควบคุมความคมชัดทั่วไป ใส่ตัวเลือกเฉพาะของผู้ให้บริการ เช่น quality, quality_level, negative_prompt หรือการตั้งค่ากล้อง ไว้ใน metadata เฉพาะเมื่อมีระบุไว้สำหรับโมเดลนั้นเท่านั้น

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

ส่งสตริงเดียวหรืออาร์เรย์ของสตริง เวกเตอร์จะถูกส่งกลับใน data[].embedding ตามลำดับเดียวกับอินพุต

พารามิเตอร์สำคัญ: input รับสตริงเดียวหรือชุดข้อมูลเป็นแบตช์ ใช้ dimensions และ encoding_format เฉพาะเมื่อโมเดล embedding ที่เลือกรองรับเท่านั้น

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

จัดอันดับเอกสารที่เป็นตัวเลือกตามคำค้นหา อ่านผลลัพธ์ที่จัดเรียงแล้วและคะแนนความเกี่ยวข้องได้จาก results

พารามิเตอร์สำคัญ: ส่ง query และ documents ใช้ top_n เพื่อจำกัดจำนวนผู้สมัครที่จัดอันดับซึ่งส่งกลับมา

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
  }'