unhardcoded
参考

API 参考文档

OpenAI 兼容的 completions 接口、dry-run 辅助工具及字段 schema 查询。

这是一个与 OpenAI 兼容的 completions 接口，附带 dry-run 辅助工具和字段 schema 查询。在请求体中携带 policy_ir 或 flow_ir；推理通过托管方配置的提供商密钥运行。

鉴权

每个请求均需携带 Authorization: Bearer <key>。托管方密钥用于标识你的工作区及其追踪记录，而非提供商账户。提供商密钥（OpenAI、Anthropic、Gemini 等）在托管方侧配置；unhardcoded 使用你自己的账户进行路由，不转售令牌、不对推理费用加价，也不向你收取模型调用费用。

接口端点

POST/v1/chat/completions
OpenAI 兼容的 completions 接口。在请求体中携带 policy_ir 或 flow_ir，其余部分与标准请求格式相同。路由器在实时目录中解析模型，并将决策写入追踪记录。
POST/x/rankdry-run
在不执行推理的情况下，返回候选模型排名及各模型的评定结果。在消耗任何令牌之前，预先确认哪些模型通过了筛选条件及其原因。
POST/x/policy/normalizedry-run
接受一个 policy_ir，返回其规范化形式、内容 fingerprint 及语法 version。无需运行即可识别并缓存一个 term。
POST/x/flow/normalizedry-run
接受并识别一个 flow_ir，验证其有界图及每个节点的策略，使格式错误的工作流在运行中途失败之前就能快速报错。
GET/x/fields
返回实时字段词汇表，包含核心字段及该托管实例注册的扩展字段——策略通过 cmp/is 进行过滤、通过 field 进行评分的依据。这是有效字段名的权威来源。

请求体

policy_ir（或 flow_ir）与 model、messages 同级，位于请求体顶层；若两者同时存在，flow_ir 优先生效。附加策略或工作流后，路由由其驱动，model 仅作为追踪标签使用。若均未提供，则 model 字符串选择路由，如 profile:cheap 或 flow:<id>，并回退至托管方的默认配置。

curl
$ curl https://<your-host>/v1/chat/completions \
    -H "Authorization: Bearer $UNHARDCODED_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "policy:support",
      "messages": [{ "role": "user", "content": "…" }],
      "policy_ir": ["policy", ["and", ["meets_req"]], …]
    }'
← 返回文档