Dùng một Base URL để truy cập các mô hình AI Trung Quốc.

Hermes Agent

Trỏ khối model trong ~/.hermes/config.yaml về gateway, hoặc chạy hermes model và chọn Custom endpoint theo cách tương tác. base_url bao gồm hậu tố /v1; Hermes tự nối /chat/completions.

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

Claude Code

Export ba biến môi trường rồi khởi động claude như bình thường. Các biến ANTHROPIC_DEFAULT_*_MODEL ánh xạ các bậc mô hình nội bộ của Claude Code sang mô hình ChinaAPI — đây chính là cách chạy mô hình Trung Quốc bên trong một Claude Code không sửa đổi.

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 dùng giao thức Responses, nên wire_api phải là responses; để nguyên dạng chat sẽ làm hỏng lời gọi công cụ. Đặt khóa của bạn vào biến môi trường được chỉ định bởi 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

Cả ba dùng chung biểu mẫu nhà cung cấp OpenAI Compatible, giống nhau từng trường. Nhập ID mô hình đúng như hiển thị trong Bảng điều khiển → Mô hình; các công cụ này không tự tải danh sách mô hình cho nhà cung cấp tùy chỉnh.

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

Cursor

Ghi đè base URL tại Settings → Models → OpenAI API Key. Trước tiên hãy thêm tên mô hình ChinaAPI bằng Add model, sau đó chỉ bật các mô hình ChinaAPI, nếu không Cursor sẽ gửi tên mô hình tích hợp sẵn của nó tới URL ghi đè của bạn.

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

OpenClaw

Khai báo ChinaAPI như một nhà cung cấp với "api": "anthropic-messages" và liệt kê những mô hình bạn muốn chọn được trong trình chọn phiên.

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

Aider

Aider định tuyến theo tiền tố tên mô hình, vì vậy hãy giữ tiền tố openai/ ngay cả khi bản thân mô hình là của Trung Quốc.

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

aider --model openai/deepseek-v4-pro

Tạo hình ảnh

Gửi prompt dạng JSON. Đọc nội dung được tạo từ data[0].url, hoặc từ data[0].b64_json khi mô hình đã chọn trả về base64.

Tham số chính: prompt và model là bắt buộc. Dùng size cho độ phân giải, n cho số lượng ảnh và response_format cho url hoặc b64_json. quality và style tùy theo mô hình; các giá trị phổ biến gồm standard, hd hoặc 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
  }'

Tạo hình ảnh Gemini

Mô hình hình ảnh Gemini dùng định dạng OpenAI Chat Completions. Đọc ảnh Markdown được tạo tại choices[0].message.content; dữ liệu ảnh là URL data:image/....

Tham số chính: dùng ID mô hình hiển thị trong danh mục sau khi đăng nhập ở model và đặt prompt hình ảnh trong messages. Không gửi mô hình này tới /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
  }'

Chuyển giọng nói thành văn bản

Tải tệp âm thanh lên bằng multipart form data; không tự đặt tiêu đề Content-Type. Văn bản nhận dạng được trả về trong trường text.

Tham số chính: gửi model và file dưới dạng trường multipart. Dùng response_format là json, text hoặc verbose_json khi mô hình đã chọn hỗ trợ.

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"

Chuyển văn bản thành giọng nói

Nội dung phản hồi là âm thanh nhị phân, vì vậy hãy ghi vào tệp. alloy chọn giọng mặc định của mô hình; một số mô hình cũng cung cấp ID giọng riêng của nhà cung cấp.

Tham số chính: dùng input, model và voice. Chọn đầu ra bằng response_format, như mp3 hoặc wav; speed và instructions khả dụng khi mô hình đã chọn hỗ trợ.

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

Tạo video

Tạo video là tác vụ bất đồng bộ. Chỉ gửi một lần, lưu task_id được trả về, rồi thăm dò GET /v1/video/generations/{task_id} cho đến khi thành công hoặc thất bại. Việc tạo tác vụ có thể tiêu thụ hạn mức.

Tham số chính: prompt và model khởi tạo tác vụ. Dùng duration, width, height, fps và n khi được hỗ trợ. Độ phân giải là cách điều khiển độ rõ phổ biến. Chỉ đặt các tham số riêng của nhà cung cấp như quality, quality_level, negative_prompt hoặc cài đặt camera trong metadata khi chúng được công bố cho mô hình đó.

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"

Embedding

Gửi một chuỗi hoặc một mảng chuỗi. Các vector được trả về trong data[].embedding theo đúng thứ tự đầu vào.

Tham số chính: input nhận một chuỗi hoặc một lô. Chỉ dùng dimensions và encoding_format khi mô hình embedding đã chọn hỗ trợ.

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

Xếp hạng các tài liệu ứng viên theo truy vấn. Đọc kết quả đã sắp xếp và điểm liên quan trong results.

Tham số chính: gửi query và documents; dùng top_n để giới hạn số ứng viên xếp hạng được trả về.

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