查询平台列表

POST https://maxaeo.cn/geoapi/geodata/developer/platforms/get

返回已开放的 AI 平台（含维护中的平台，见 platform_status）。提交任务前用它获取平台标识和单价，也可以用它做 API Key 的连通性检查。不消耗点数。

请求

无参数，请求体传空对象 {}。

curl -X POST "https://maxaeo.cn/geoapi/geodata/developer/platforms/get" \
  -H "Authorization: Bearer $MAXAEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

import os

import requests

resp = requests.post(
    "https://maxaeo.cn/geoapi/geodata/developer/platforms/get",
    headers={"Authorization": f"Bearer {os.environ['MAXAEO_API_KEY']}"},
    json={},
    timeout=30,
)
data = resp.json()
if data["ret"] != 1:
    raise RuntimeError(data["msg"])
for item in data["data"]["ent"]["items"] or []:
    print(item["platform"], item["platform_status"], item["p1_credits"], item["p2_credits"])

const resp = await fetch("https://maxaeo.cn/geoapi/geodata/developer/platforms/get", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MAXAEO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: "{}",
});
const data = await resp.json();
if (data.ret !== 1) throw new Error(data.msg);
for (const item of data.data.ent.items ?? []) {
  console.log(item.platform, item.platform_status, item.p1_credits, item.p2_credits);
}

响应

data.ent 的字段：

字段	类型	说明
`platforms`	string[]	已配置单价的平台标识，与 `items` 顺序一致，即提交任务的 `platform` 可选值；包含维护中的平台（提交返回 `1029`），提交前请看 `items[].platform_status`
`items`	PlatformItem[]	每个平台的详细信息，与 `platforms` 顺序一致

PlatformItem：

字段	类型	说明
`platform`	string	平台标识，如 `doubao`
`region`	string	`domestic`（国内）或 `overseas`（海外）
`platform_status`	string	`normal` 正常、`degraded` 波动、`maintenance` 维护中（暂停接单，提交返回 `1029`）
`p1_credits`	integer	P1 优先档每次成功调用的点数
`p2_credits`	integer	P2 标准档每次成功调用的点数
`has_stats`	boolean	近 24 小时样本数是否达到统计门槛；为 `false` 时 `success_rate` 与 `p50_duration_seconds` 为 `0`，不应展示
`success_rate`	number	近 24 小时成功率，0–1
`p50_duration_seconds`	integer	近 24 小时成功任务从提交到完成的中位耗时（秒，含排队）
`sample_count`	integer	近 24 小时到达终态的任务数（所有调用方，不含 Key 失效、参数被拒、取消等非平台原因）
`stats_updated_at`	integer	统计计算时间（Unix 秒），`0` 表示尚未计算

状态与统计字段的解读见平台、优先级与国家。

响应示例

{
  "ret": 1,
  "data": {
    "ent": {
      "platforms": ["kimi", "doubao", "deepseek"],
      "items": [
        {
          "platform": "kimi",
          "region": "domestic",
          "platform_status": "normal",
          "p1_credits": 40,
          "p2_credits": 20,
          "has_stats": false,
          "success_rate": 0,
          "p50_duration_seconds": 0,
          "sample_count": 0,
          "stats_updated_at": 1793018400
        },
        {
          "platform": "doubao",
          "region": "domestic",
          "platform_status": "normal",
          "p1_credits": 6,
          "p2_credits": 3,
          "has_stats": true,
          "success_rate": 0.9612,
          "p50_duration_seconds": 52,
          "sample_count": 129,
          "stats_updated_at": 1793018400
        },
        {
          "platform": "deepseek",
          "region": "domestic",
          "platform_status": "degraded",
          "p1_credits": 6,
          "p2_credits": 3,
          "has_stats": true,
          "success_rate": 0.8235,
          "p50_duration_seconds": 75,
          "sample_count": 34,
          "stats_updated_at": 1793018400
        }
      ]
    }
  }
}

示例中的单价与统计仅为演示，以实际返回为准。

错误

`ret`	原因
`1001`	请求体不是 JSON 对象（例如空请求体）或包含未定义的字段
`1030`	API Key 缺失、无效、已停用或已过期
`1003`	账户权限异常（少见），请联系我们
`-1`	服务暂时不可用，稍后重试

完整说明见错误处理。