API 文档

一码行云提供统一的 AI 模型 API 网关，支持 Claude、GPT、DeepSeek 等主流模型。完全兼容 OpenAI API 格式，同时支持 Claude 原生 Messages API。

认证方式

所有请求需要在 HTTP Header 中携带 API Key：

Authorization: Bearer sk-your-api-key

如果使用 Claude 原生格式（/v1/messages），也可以通过以下 Header 认证：

x-api-key: sk-your-api-key
anthropic-version: 2023-06-01

API Key 可在控制台 → 令牌页面创建。

Base URL

https://api.matrixone.online

OpenAI 格式 — Chat Completions

兼容 OpenAI /v1/chat/completions 接口，所有模型均支持此格式。

请求

curl https://api.matrixone.online/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6-pro",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.matrixone.online/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6-pro",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

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

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.matrixone.online/v1',
});

const response = await client.chat.completions.create({
  model: 'claude-sonnet-4-6-pro',
  messages: [{ role: 'user', content: 'Hello!' }],
});

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

请求参数

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1745700000,
  "model": "claude-sonnet-4-6-pro",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 9,
    "total_tokens": 19
  }
}

OpenAI 格式 — 流式输出

设置 "stream": true 即可启用 SSE 流式响应：

curl https://api.matrixone.online/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6-pro",
    "messages": [{"role": "user", "content": "写一首短诗"}],
    "stream": true
  }'

OpenAI 格式 — 支持的模型

Claude 原生格式 — Messages API

Claude 系列模型额外支持 Anthropic 原生 /v1/messages 接口，适合已有 Claude SDK 集成的场景。

请求

curl https://api.matrixone.online/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6-pro",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

import anthropic

client = anthropic.Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.matrixone.online"
)

message = client.messages.create(
    model="claude-sonnet-4-6-pro",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

print(message.content[0].text)

响应示例

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {"type": "text", "text": "Hello! How can I help you today?"}
  ],
  "model": "claude-sonnet-4-6-pro",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 9
  }
}

Claude 原生格式 — 流式输出

设置 "stream": true 启用 SSE 流式：

curl https://api.matrixone.online/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6-pro",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "写一首短诗"}]
  }'

Claude 原生格式 — 支持的模型

Claude 原生格式支持所有 Claude 系列和 DeepSeek 系列模型。

DeepSeek 模型

DeepSeek V4 系列模型支持深度思考模式。在模型名后加 -max 后缀即可启用：

使用示例

curl https://api.matrixone.online/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro-max",
    "messages": [{"role": "user", "content": "求解：∫₀¹ x² dx"}]
  }'

Claude 系列

Claude 模型分为两个渠道层级：

• Pro 后缀 — 官方原价的 6 折，享受会员分组折扣
• Ultimate 后缀 — 官方原价的 8 折，享受会员分组折扣

GPT 系列

GPT 系列模型统一为官方原价的 6 折，享受会员分组折扣。仅支持 OpenAI 格式（/v1/chat/completions）。

定价说明

计费基于实际使用的 token 数量，按以下公式计算：

费用 = (输入 Token × 模型倍率 + 输出 Token × 模型倍率 × 补全倍率) × 分组倍率

• 模型倍率：决定基础价格，不同模型不同
• 补全倍率：输出 token 相对输入 token 的价格比（通常 > 1）
• 分组倍率：会员等级折扣（DeepSeek 模型固定为 1.0）

价格表

以下价格为默认分组（无折扣）的刊例价，单位：USD / 百万 Token。

会员分组折扣

Claude 和 GPT 模型享受会员分组折扣，在上述刊例价基础上进一步优惠：

错误码

速率限制

每个令牌可单独配置速率限制（RPM / TPM），具体限额取决于令牌设置。

遇到 429 错误时，请在 Retry-After 响应头指定的时间后重试。

模型列表 API

查询当前可用的模型列表：

curl https://api.matrixone.online/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

响应：

{
  "object": "list",
  "data": [
    {"id": "claude-sonnet-4-6-pro", "object": "model", "owned_by": "anthropic"},
    {"id": "gpt-5.5", "object": "model", "owned_by": "openai"},
    ...
  ]
}