模型选型与调用
先在模型广场比较能力和目录价,再用企业 API Key 确认可用模型。按实际任务选择接口,在控制台核对生效价。
确认可用的模型 ID
GET /api/public/models- 查看公开选型目录、能力、别名和目录价。读取 models[].id 获取模型 ID,下一步用签约企业的 API Key 核对可调用范围。
GET /v1/models- 带企业 API Key 查询。data[].id 包含当前密钥可用的模型及别名,按企业、部门、套餐、密钥、来源 IP 和可用渠道配置过滤。
GET /v1beta/models- 同一套访问规则生成的 Gemini 格式列表。列表用于发现模型,具体操作仍需通过目标端点验证。
按快速接入设置 BASE_URL 和 TOKEN_PYXIS_API_KEY。复制模型 ID 时以企业查询结果为准,生产配置建议使用目录中的标准 ID。
curl -fsS "https://tokenpyxis.com/api/public/models"
curl -fsS "https://tokenpyxis.com/v1/models" -H "Authorization: Bearer $TOKEN_PYXIS_API_KEY"
curl -fsS "https://tokenpyxis.com/v1beta/models" -H "x-goog-api-key: $TOKEN_PYXIS_API_KEY"浏览模型广场和目录价按应用选择协议
检查公开目录的 capability 对应能力位,再用当前 API Key、目标模型和实际请求做验证。协议能力位用于选型,工具调用、缓存或特定参数还受上游能力影响。
| 协议与端点 | 能力位 | 适合场景 |
|---|---|---|
Chat CompletionsPOST /v1/chat/completions | chat | 新业务的文本对话与已有 chat.completions 工作流。 |
ResponsesPOST /v1/responses | responses | 已有 Responses 请求或使用该协议的客户端。按实际场景验证流式、工具与多轮。 |
Responses CompactPOST /v1/responses/compact | responses_compact | 原生上下文压缩,返回非流式结果。 |
MessagesPOST /v1/messages | messages | 已有 Anthropic Messages 消息结构的应用。 |
GeminiPOST /v1beta/models/{model}:generateContent | chat | 使用 contents 请求结构。安全设置、工具、多模态与显式缓存需要原生 Gemini 渠道,流式端点按 SSE 返回增量。 |
核对价格与用量
词元(Token)是模型处理输入、生成输出的计量单位。词元计费的模型通常分别列出每百万词元的输入、输出及适用的缓存费率。图像、语音、视频等按量接口可能按张、秒或次计费,请以对应模型的单位为准。
模型广场适合比较目录价。上线测算时,以已签署的企业合同为准,在企业控制台核对生效价、钱包和套餐覆盖范围,并抽样按请求编号对账。
