跳到正文
EN

选择模型并核对价格与用量

读取 API Key 可访问的模型,按服务档位核对当前价格,并在使用记录中确认请求费用。

更新于 复核于
查看 Markdown

模型目录、服务分组和价格会独立变化。调用前先用目标 API Key 读取模型,再到价格页核对同一模型在对应服务档位中的当前价格。

价格页将不同来源和价格选择称为“服务档位”;API Key 和使用记录中称为“服务分组”。两处指向同一个分组值,本文按你当前操作的页面使用对应名称。

只有一个可用服务档位时,价格页直接显示该档位的价格,无需选择。页面展示简化不改变已有 API Key 的服务分组或账号权限;历史 Key 仍需核对自己的模型范围和实际调用价格。

历史福利组迁移公告

福利组下线公告曾写明福利组将在 2026 年 9 月 30 日后停止使用,并提示提前迁移;该日期已经过去。公告中 Astra Fast 为 Standard 的 2.5 倍消耗,属于当时的迁移说明,不能作为今天的可用分组或价格依据。

如果旧 Key 无法访问模型,请在控制台核对账号当前可选的服务分组、模型和价格,再按应用实际协议发送小请求并核对使用记录。没有可用分组或仍无法访问时,联系 XiuAI 支持。

读取可用模型

curl https://router-api.xiu.ai/v1/models \
  -H "Authorization: Bearer $XIUROUTER_API_KEY"

返回列表受以下条件共同限制:

  • 账号当前可用的服务分组。
  • API Key 绑定或自动选择的服务分组。
  • API Key 的模型范围。
  • 当前有可用渠道的模型。

同一个账号的两把 Key 可能看到不同列表。生产配置应保存精确模型 ID,不要只按厂商名或页面展示名匹配。

Antigravity 资源与图片档位

调用 Gemini 模型时,按客户端使用的原生路径和精确模型 ID 配置请求。

  • Gemini 3.8 Flash 使用基础模型加 thinkingLevel 时可选择 low、medium、high;Argon 要保证档位时使用精确的 gemini-4-argon-low、gemini-4-argon-medium 或 gemini-4-argon-high,基础模型可能按上游映射回退到 high。
  • gemini-3.1-flash-image 已验证 1K、2K、4K;2K + 16:9 返回 2752×1536,4K + 1:1 返回 4096×4096。
  • 图片生成和编辑按图片模型当前按次价格结算;输入图片、生成数量、输出尺寸和费用要分别核对。当前 max 分组有效价为 1K $0.02、2K $0.03、4K $0.06726;其他分组以价格页和使用记录为准。
  • 价格页家族合并只影响展示;请求仍使用精确模型 ID。

客户端不能表达 thinkingLevel 时,使用精确的 -low、-medium 或 -high ID。客户端能表达时,优先使用基础模型和请求参数,再读回 upstream_model。

缓存边界

本文所述的 Antigravity 兼容接入不提供 Gemini 显式上下文缓存,POST /v1beta/cachedContents 返回 404 且不会扣费。不要把重复前缀或一次普通请求成功当成缓存命中。需要显式缓存时,先联系支持确认目标模型和请求路径是否支持,再按使用记录中的 cache_read_tokens 和费用核对结果。

Gemini 模型家族

价格页按模型家族展示 Gemini 的思考档位,避免把同一模型的兼容后缀看成多个独立模型。调用时按客户端能力选择:

  • Gemini 3.x 优先使用基础模型 ID,并传 reasoning_effort。
  • Argon 的 low、medium、high 是 Antigravity 上游原生档位;要保证档位,使用对应的精确模型 ID,基础 Argon 名称可能按上游映射回退到 high。
  • 价格页的合并展示不改变 /v1/models 返回的精确 ID,也不改变 API Key 的模型限制。

切换模型或思考档位后,发一条小请求并在使用记录中核对实际模型、协议、服务分组和费用。

核对协议

价格目录会发布模型可用的端点类型,但最终仍要用目标 Key 验证:

supported_endpoint_types 值 常用接口
openai /v1/chat/completions
openai-response /v1/responses
anthropic /v1/messages
gemini /v1beta/models/{model}:generateContent

网关还存在图片、Embeddings、音频、Rerank 和 Moderation 路由。它们的可用性取决于模型和服务来源;当前文档没有把这些路由列为通用生产能力。Files、Fine-tuning 和图片 Variations 当前未实现。

核对价格

打开模型与价格,完成以下检查:

  1. 搜索精确模型 ID。
  2. 若页面提供多个服务档位,选择与 API Key 服务分组对应的档位;只有一个时直接查看价格。
  3. 确认目标模型可由该 Key 访问;公开价格页不代表账号拥有所有模型的调用权限。
  4. 查看按 Token 或按次计费。
  5. 按 Token 计费时,分别看输入、输出、缓存读取和缓存写入。
  6. 页面列出多个上下文档位时,核对每档的输入长度条件和四项 Token 单价。
  7. 页面列出 Fast 或 Flex 时,核对对应倍率,不要只看默认档价格。
  8. 需要对比时,再看厂商参考价;实际扣费以 XiuAI 当前服务分组价格和使用记录为准。

服务档位表示来源和价格选择,不代表固定速度、质量或 SLA。API Key 使用自动分组时,系统可能在失败后尝试下一个分组,最终承接请求的分组决定价格。

动态阶梯价格

部分模型会根据输入上下文长度切换整套 Token 单价。输入超过页面标出的条件后,输入、输出、缓存读取和缓存写入可能同时进入另一档。不要只用默认输入价乘总 Token,也不要把缓存 Token 重复算进普通输入。

部分 Responses 模型还支持 service_tier:

推荐请求值 价格页显示
省略或默认值 默认处理模式
priority Fast
flex Flex

本文使用 priority 发起 Fast 请求。只使用目标模型价格行中明确显示的模式。倍率应用于该请求命中的 Token 价格;工具调用等附加费用会在使用记录中单独列出。

核对使用记录

需要定期对账或生成内部报表时,可以通过开放接口读取余额、逐条同步请求记录,并按模型与调用密钥汇总费用。

按日期查询费用

登录后打开使用记录,可查看已有调用,无需另外发送请求。

  1. 打开时间范围选择器。可以直接选择“今天”“昨天”“近 7 天”“近 30 天”或“本月”。
  2. 要查某一段时间,在日历中选择开始、结束日期和时间,再点“确定”。
  3. 查看这段时间的 Token 合计和费用记录。需要定位具体调用时,再按 API Key、模型或请求状态筛选请求列表。

日期按浏览器本地时间计算。“近 7 天”和“近 30 天”包含今天;“本月”从本月 1 日开始。刷新自定义范围时,起止时间保持不变。

页面顶部合计按所选时间范围统计;API Key、模型和状态筛选只影响请求列表,不改变顶部合计。

如果没有记录,先核对日期和筛选条件。费用尚未记录的请求不等于免费调用,可稍后刷新并打开请求详情核对。

核对单次请求

发送请求后,打开 XiuAI“使用记录”。每条记录可用于核对:

  • 请求时间和请求 ID。
  • API Key 名称和 public ID。
  • 模型和实际服务分组。
  • 输入、输出 Token。
  • 动态模型实际命中的上下文档位和请求规则。
  • Web search 等工具的调用次数和附加费用。
  • 执行费用和费用状态。
  • 流式或非流式。
  • 首字、总耗时和请求结果。

失败或未知结果先刷新记录。没有请求 ID、Token 或费用时,不要用 0 或客户端估算值代替缺失事实。

使用记录用于核对调用统计,不提供对话原文。XiuAI 不存储模型对话内容,调用统计与模型性能数据长期保留;模型厂商按各自服务的数据政策处理请求。具体范围见数据处理与隐私保护。

建议流程

  1. 在价格页选择模型;有多个服务档位时,再选择与 Key 对应的档位。
  2. 为项目创建专用 Key,并限制模型和剩余额度。
  3. 通过 GET /v1/models 确认 Key 能看到目标模型。
  4. 用项目实际协议发送小请求。
  5. 在使用记录核对模型、分组、Token、费用和结果。
  6. 通过后再提高并发、上下文和任务权限。

来源与核对日期

本文于 2026-09-13 复核公开价格目录的单档位展示、处理模式请求值、数据政策入口及福利组下线公告。福利组迁移期限和 Astra Fast 额度倍率来自该公告;模型列表、API Key 范围和使用记录说明沿用已核对的接口与字段。模型、分组和价格以控制台当前显示为准。

2026-09-17 补充时间范围查询步骤;选项名称、日期范围和刷新规则依据当前产品实现及已发布资源复核。

2026-11-07 补充 Antigravity 原生 Gemini 图片、思考档位、工具和按次图片计费验收;实际模型、尺寸和费用以使用记录为准。

导航

输入关键词开始搜索

↑↓ 移动↵ 打开Esc 关闭