选择模型
找到需要的模型,查看它的输入 schema 和默认值,请求里只发送它接受的字段。
模型目录
每个模型都有 slug 和输入 schema。 GET /api/v1/models 列出全部模型; GET /api/v1/models/{slug} 返回单个模型。OpenAPI 文档在以下字段中提供每个输入 schema: x-models.
输入校验
只接受模型列出的字段。未知字段、缺少必填字段或超出可选值的输入会以 400 INVALID_MODEL_INPUT 拒绝。
读取价格
GET /api/v1/prices 返回以美元微单位表示的客户价格(1 美元 = 1,000,000 微单位)。提交前检查 enabled。存在 rateCard 时,先应用模型输入默认值,再按 when 匹配一条规则;如果该规则含 quantityField,则将 priceMicros 乘以对应数量,否则使用固定 priceMicros。通过 expectedPriceMicros 传入最终报价,价格变化时请求会被拒绝。