AI AI Skills 开放平台

API密钥与计费

product-catalog API-KEY.md

API密钥与计费

推荐在平台创建通用 Key，并执行 openclaw config set env.AI_SKILLS_API_KEY "你的平台APIKey" 和 openclaw gateway restart，全平台 Skill 只需配置一次。仍需开通目标产品。调用优先使用 AI_SKILLS_API_KEY，为空时才读取兼容变量 PRODUCT_CATALOG_API_KEY。两者均缺失时停止调用，不发送空 Bearer 请求。

用户只需平台 Key，不提供模型或 S3 凭证。优先 AI_SKILLS_API_KEY，为空使用 PRODUCT_CATALOG_API_KEY，两者均缺失时停止。不要记录、输出或要求对话中粘贴完整密钥。

catalog.translate 按已验证的实际输入/输出Token收费，已批准且源文未变的译文可复用而不调用模型。catalog.generate 使用 canonical data，每语言每100个启用SKU向上取整，1–100为1单元，101–200为2单元；只有完整PDF、页图和清单质量通过并成功保存后计成功生成费。其余四个操作、上传、管理、导出、下载免费并限流；同任务幂等重放不重复扣款。页面显示当前人民币价格，使用前核对报价。

响应计费头为 X-AI-Skills-Billing-Currency、X-AI-Skills-Billing-Charged 和 X-AI-Skills-Billing-Balance。失败与不确定上游状态遵循平台对账，不能另建任务试图重复执行。

费用确认的实际入口

目前没有对 OpenClaw 开放的价格查询、余额查询或翻译预留试算 API。让用户在登录后的产品工作台取得当前单价/翻译预留上限与余额，并明确授权；无法取得当前价格依据时停在免费资料整理阶段。不能提交一次收费任务来探价，不能虚构 /quote 或 /balance 接口。

生成前展示语言、已确认版本、产品数、计费单元及当前单价；翻译前展示将传输的文字范围、Token 单价、预留上限及按实际用量结算方式。英文目录的翻译与生成是两次不同收费，确认译文不等于授权生成费。工作台的费用确认表单不是 Bearer API；通用任务 API 没有 generation_fee、translation_maximum_fee 等网页字段，不能夹带到 API 请求或宣称 API 已强制限制用户预算。

配置冲突、迁移与鉴权失败

  • 首次调用前选定凭证来源。两种变量同时存在且值不同时，采用 AI_SKILLS_API_KEY 并提示忽略了 PRODUCT_CATALOG_API_KEY，仅显示变量名，不输出或记录密钥、密钥片段或 Authorization 请求头。同一逻辑任务固定所选 API Key 和原 Idempotency-Key，重试与查询沿用原凭证。
  • 迁移前先查询并核对旧 Key 下已提交任务的结果与账单；幂等记录按 Key 隔离，即使 Idempotency-Key 相同，换 API Key 仍可能重复执行或扣费。确认旧任务后再清理旧产品变量及 skills.entries.product-catalog.apiKey / skills.entries.product-catalog.env 中的遗留凭证，检查实际执行环境（宿主、服务进程或沙箱），重启 Gateway 并在新会话验证。不要自动修改或撤销用户的 Key。产品隔离场景须明确让该执行环境不提供通用变量，再使用产品变量。
  • 收到 401（invalid_api_key、key_revoked、key_expired）时停止自动重试，检查当前凭证来源、密钥状态和目标产品范围；不要自动切换到另一把 Key 重发，也不要仅凭间歇性恢复断言是网关或缓存故障。排查保留 request_id、接口、时间及变量名，不保留密钥；确需切换凭证前先核对原任务和账单。