New API 手册 / 模型与定价

模型与定价

网关能转发的所有模型,取决于管理员在「渠道」里配置了什么。你实际能调用哪些,还受你的分组与令牌可用模型限制。

查询可用模型

curl https://ai.moespark.dev/v1/models \
  -H "Authorization: Bearer sk-你的令牌"

返回示例:

{
  "object": "list",
  "data": [
    {"id": "gpt-4o-mini", "object": "model", "owned_by": "openai"},
    {"id": "gpt-4o", "object": "model", "owned_by": "openai"},
    {"id": "claude-3-5-sonnet", "object": "model", "owned_by": "anthropic"},
    {"id": "gemini-1.5-pro", "object": "model", "owned_by": "google"}
  ]
}

把 data[].id 作为请求里的 model 值即可。

提示
控制台首页的「模型价格」页面会展示每个模型的计费单价与可用分组,是最权威的清单。

常见模型类别

类别典型用途举例(以实际配置为准)
通用对话问答、写作、总结gpt-4o、gpt-4o-mini、claude-3-5-sonnet、gemini-1.5-pro
推理型复杂推理、数学、代码o 系列 / deepseek-reasoner 等
轻量快速高并发、低延迟gpt-4o-mini、claude-3-5-haiku
向量 Embedding检索、相似度text-embedding-3-small / large
多模态视觉图像理解gpt-4o、claude-3 系列、gemini 1.5
图像生成文生图dall-e-3 等(若渠道支持)

计费口径

对话类模型通常按 输入 token(prompt) 与 输出 token(completion) 分别计价;嵌入按输入 token;图像按张。网关会把上游单价折算后从你的额度中扣减。

# 从响应里读取本次用量
"usage": {
  "prompt_tokens": 128,       # 输入
  "completion_tokens": 256,   # 输出
  "total_tokens": 384
}
说明
具体单价随上游与渠道浮动,以控制台「模型价格」展示为准。缓存命中(如提示词缓存)在支持的上游上可能更便宜。

分组与可见性

管理员会把模型划分到不同分组(例如 default / vip / 内部)。你的令牌属于某个分组,只能看到并使用该分组开放的模型。若某个模型调用时报「无权限/模型不存在」,通常是分组或令牌白名单没放开。