开发者文档

curl https://api.cmrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-****" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-****",
    base_url="https://api.cmrouter.com/v1",
)

resp = client.chat.completions.create(
    model="<模型名>",
    messages=[
        {"role": "user", "content": "你好，介绍一下你自己"}
    ],
)

print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-****",
  baseURL: "https://api.cmrouter.com/v1",
});

const resp = await client.chat.completions.create({
  model: "<模型名>",
  messages: [
    { role: "user", content: "你好，介绍一下你自己" }
  ],
});

console.log(resp.choices[0].message.content);

OkHttpClient client = new OkHttpClient();

String payload = """
    {
      "model": "<模型名>",
      "messages": [
        {"role": "user", "content": "你好，介绍一下你自己"}
      ]
    }
    """;

Request request = new Request.Builder()
    .url("https://api.cmrouter.com/v1/chat/completions")
    .addHeader("Authorization", "Bearer sk-****")
    .post(RequestBody.create(payload, MediaType.parse("application/json")))
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

payload, _ := json.Marshal(map[string]any{
    "model": "<模型名>",
    "messages": []map[string]string{
        {"role": "user", "content": "你好，介绍一下你自己"},
    },
})

req, _ := http.NewRequest("POST", "https://api.cmrouter.com/v1/chat/completions", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer sk-****")
req.Header.Set("Content-Type", "application/json")

resp, err := http.DefaultClient.Do(req)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

curl -N https://api.cmrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-****" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "stream": true,
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-****", base_url="https://api.cmrouter.com/v1")

stream = client.chat.completions.create(
    model="<模型名>",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

curl -N https://api.cmrouter.com/v1/responses \
  -H "Authorization: Bearer sk-****" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "stream": true,
    "input": "用一句话介绍你自己"
  }'

from openai import OpenAI

client = OpenAI(api_key="sk-****", base_url="https://api.cmrouter.com/v1")

stream = client.responses.create(
    model="<模型名>",
    input="你好",
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

curl -N https://api.cmrouter.com/v1/messages \
  -H "x-api-key: sk-****" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名>",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

import anthropic

client = anthropic.Anthropic(
    api_key="sk-****",
    base_url="https://api.cmrouter.com",
)

stream = client.messages.create(
    model="<模型名>",
    max_tokens=1024,
    stream=True,
    messages=[{"role": "user", "content": "你好"}],
)

for event in stream:
    if event.type == "content_block_delta" and event.delta.type == "text_delta":
        print(event.delta.text, end="", flush=True)

curl https://api.cmrouter.com/v1/ledger/balance \
  -H "Authorization: Bearer sk-****"

{
  "tenant_id": "t_xxxx",
  "balance": 128.50234,         // 余额总额（元）：含进行中请求/任务的预扣，结算完成后才下降
  "reserved": 1.2,              // 预扣占用中（元）
  "available": 127.30234,       // 可用额度（元）：发起新请求/任务时校验的额度
  "subsidy_balance": 0,         // 补贴余额（元）
  "prepay_balance": 128.50234,  // 充值余额（元）
  "currency": "CNY"
}

curl "https://api.cmrouter.com/v1/metering/usage?group_by=model&start=2026-10-01&end=2026-11-01" \
  -H "Authorization: Bearer sk-****"

{
  "total_tokens": 123456,        // tokens 为真实用量统计
  "total_calls": 42,             // 仅计成功请求
  "total_charged_amount": 1.23,  // 实扣金额（元）
  "group_by": "model",
  "by_model": [
    { "model": "glm-5.3", "total_tokens": 100000, "calls": 40, "charged_amount": 1.0 }
  ]
}

curl https://api.cmrouter.com/public/pricing

{
  "models": [
    {
      "model": "glm-5.3",
      "billing_type": "per_token",
      "pricing": {
        "input": 8,         // 输入单价（元/百万 tokens）
        "output": 28,       // 输出单价（元/百万 tokens）
        "cache_read": 2,    // 缓存命中单价
        "cache_write": 0,
        "per_request": 0,   // 按次计费模型（图像）才非零，单位元/张
        "per_second": 0     // 按秒计费模型（视频）才非零，单位元/秒
      },
      "tiers": [ ... ]      // 仅分时档模型携带：空闲/高峰分档单价
    }
  ]
}

{
  "error": {
    "message": "Invalid API key",      // 错误原因说明，可直接阅读
    "type": "cmrouter_error",          // 固定为 cmrouter_error，表示错误来自本平台
    "code": "invalid_api_key",         // 错误码，程序按它判断，见下表
    "param": null                      // 补充信息（如涉及的参数、审核明细），无则为 null
  }
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",    // 官方错误类型，由状态码映射（本例 401）
    "message": "Invalid API key"       // 具体原因，与 OpenAI 协议的 message 相同
  }
}