跳到主要内容

选择模型

找到需要的模型,查看它的输入 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 传入最终报价,价格变化时请求会被拒绝。

查看当前价格