计费说明

蜀农 API 按实际使用量计费，费用通常与输入 Token、输出 Token 以及所使用的模型有关。具体价格和可用额度以控制台展示为准。

Token 用量

一次请求的用量通常包括：

• 输入 Token：系统提示词、历史消息、用户输入、工具定义和多模态输入对应的内容。
• 输出 Token：模型生成的回复内容。
• 总 Token：输入 Token 与输出 Token 之和。

非流式响应会在 usage 字段中返回统计信息：

{
  "usage": {
    "prompt_tokens": 120,
    "completion_tokens": 80,
    "total_tokens": 200
  }
}

成本控制

• 根据任务难度选择合适的模型。
• 使用明确、紧凑的系统提示词。
• 限制历史消息长度，定期摘要长对话。
• 设置合理的 max_tokens，避免无界输出。
• 为用户、项目和环境设置独立的额度与限流策略。
• 在正式上线前用真实业务样本进行成本估算。

用量查询

可以在蜀农 API 控制台查看请求次数、Token 用量和余额信息。建议按天或按项目导出数据，跟踪异常增长。

余额不足与限额

当账户余额不足或触发用量限制时，请求可能返回 429。应用应向用户返回可理解的提示，并记录服务端错误；不要通过无限重试来恢复请求。

费用安全

API Key 泄露可能导致额度被他人消耗。请将密钥存放在环境变量或密钥管理服务中，定期轮换，并在发现异常用量时立即撤销相关密钥。

价格、计费周期和退款规则可能调整，正式部署前请以控制台和服务协议中的最新说明为准。