文档/模型与路由

模型列表

看懂模型 ID、拉取可用清单,并掌握模型上线与下线的节奏。

本页目录

命名规则

模型 ID 就是模型自己的名字,不带厂商前缀,例如:

text
claude-opus-4-7
gpt-5.6-sol
gemini-2.5-pro
deepseek-v4-flash
kimi-k3

同一个模型可能由多个上游渠道提供服务,选哪个由路由决定,不体现在模型 ID 里。ID 区分大小写,以接口返回为准。

用接口拉清单

bash
curl https://api.apione.ai/v1/models \
  -H "Authorization: Bearer $APIONE_API_KEY"
json
{
  "object": "list",
  "data": [
    { "id": "claude-opus-4-7", "object": "model", "created": 0, "owned_by": "maxx" },
    { "id": "gpt-5.6-sol", "object": "model", "created": 0, "owned_by": "maxx" }
  ]
}

返回的是当前 Key 可调用的模型;如果给 Key 设了「指定模型」,这里只会列出勾选的模型。要看某个模型支持哪些参数、怎么计费,用 GET /v1/models/{model}/params,见Reference › GET /models。

在网页上浏览

模型目录列出全部可用模型,每个模型页有价格、上下文长度、支持的输入类型与能力说明。挑模型时从那里看比读 JSON 直观。

选型的三条经验

  • 先按任务分层:分类、抽取、改写这类高频短任务用小模型(claude-haiku-4-5-20251001、gemini-3.5-flash);复杂推理与长文档再上旗舰模型。
  • 看上下文而不是参数量:要塞整本手册就先确认上下文长度,超出窗口会直接报 context_length_exceeded。
  • 先小规模比价:同一批 prompt 跑两三个模型,比较质量与 usage,比凭直觉选划算得多。

上线与下线

新模型上线后立即可用,不需要你改配置。模型下线时我们会提前公告;下线后再调用会返回 400 model_not_supported。

提示

不想跟着厂商版本号跑,可以在自己的代码里维护一层别名(例如 FAST_MODEL / SMART_MODEL),只在一个常量文件里改模型名。

联系我们

文档没写清楚,或者需要人工协助?按问题类型选一个渠道即可。

邮箱

技术支持support@apione.ai

WhatsApp

Telegram

工单

计费与账户控制台 › 反馈