API 调用文档

快速开始

所有请求都使用 HTTPS，并通过 API Key 认证。推荐使用 Authorization: Bearer，系统也兼容 x-api-key。

Authorization: Bearer $APIGOTO_API_KEY
Content-Type: application/json

API Key

后台已配置两个正式调用 Key，分别绑定到不同协议分组。请在后台 API Key 页面复制完整 Key 后使用。

当前系统按分组平台隔离调度。如果后续要一个 Key 同时覆盖多协议，需要增加跨分组统一路由能力。

模型列表

Anthropic 兼容调用

适用于 MiniMax、DeepSeek、Kimi、Claude Opus。Claude 使用 Claude Code setup-token 上游账号，对外模型名保持 claude-opus-4.6 / claude-opus-4.7，平台会自动映射到 Claude 实际上游模型名。

请求地址：

POST https://api.apigoto.com/v1/messages

cURL 示例

curl https://api.apigoto.com/v1/messages \
  -H "Authorization: Bearer $APIGOTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "用一句话介绍 APIGOTO"}
    ],
    "stream": false
  }'

Claude Opus 示例

curl https://api.apigoto.com/v1/messages \
  -H "Authorization: Bearer $APIGOTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.6",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "只回复 ok"}
    ],
    "stream": false
  }'

也可以把 model 改为 claude-opus-4.7。请使用对外模型名中的点号版本，不需要传上游短横线版本。

Python 示例

import os
import requests

resp = requests.post(
    "https://api.apigoto.com/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['APIGOTO_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "kimi-k2.6",
        "max_tokens": 512,
        "messages": [{"role": "user", "content": "只回复 ok"}],
        "stream": False,
    },
    timeout=120,
)
print(resp.status_code)
print(resp.text)

Node.js 示例

const res = await fetch("https://api.apigoto.com/v1/messages", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.APIGOTO_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-M2.7-highspeed",
    max_tokens: 512,
    messages: [{ role: "user", content: "只回复 ok" }],
    stream: false
  })
});
console.log(res.status);
console.log(await res.text());

OpenAI Responses 兼容调用

适用于 Qwen。请求地址：

POST https://api.apigoto.com/v1/responses

cURL 示例

curl https://api.apigoto.com/v1/responses \
  -H "Authorization: Bearer $APIGOTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.6-plus",
    "input": "用一句话介绍 APIGOTO",
    "max_output_tokens": 512,
    "stream": false
  }'

Python 示例

import os
import requests

resp = requests.post(
    "https://api.apigoto.com/v1/responses",
    headers={
        "Authorization": f"Bearer {os.environ['APIGOTO_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "qwen3.6-plus",
        "input": "只回复 ok",
        "max_output_tokens": 512,
        "stream": False,
    },
    timeout=120,
)
print(resp.status_code)
print(resp.text)

流式响应

将 stream 设置为 true 即可启用流式输出。客户端需要按 SSE 或分块响应方式读取。

{
  "model": "claude-opus-4.7",
  "max_tokens": 512,
  "messages": [{"role": "user", "content": "写一个三行摘要"}],
  "stream": true
}

常见错误码