把模型调用做成一个可控的 CI 步骤
DevFlow Models 面向 CI、代码审查和服务端任务，用独立凭证、确定性输出和可追踪失败，把模型调用从临时脚本变成流水线里一个可复现、可校验、可回滚的步骤，而不是每次都靠人盯着输出。
建议顺序：注册 → 在测试 runner 建 Key → 用 CI Secret 注入 → 先跑一步验证鉴权、超时与退出码。
放进流水线的三个前提
环境隔离
本地、CI、测试和生产分别使用 Key 与环境变量，避免权限和消耗混在一起；某把 Key 泄露或需要回收时，不牵连其他环境。
机器可读结果
CI 节点优先采用结构化输出，并为校验失败设置明确的退出条件，让流水线能自动判断这一步是通过还是失败，而不是靠人读文字。
版本显式固定
流水线中明确配置模型 ID，变更前先用回归样本验证结果差异；具体可用模型以 /v1/models 实际返回为准，不照抄文档示例名。
在 CI 里配置一次调用
把 Key 写进工作流文件或提交进仓库，等于公开泄露。用 CI 的 Secret 注入环境变量，并为 CI、测试和生产分别建 Key，方便单独回收。
# .github/workflows/ci.yml
jobs:
model-check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: 调用模型并校验输出
env:
# 在仓库 Secret 中配置，不要写进文件或日志
DEVFLOW_API_KEY: ${{ secrets.DEVFLOW_API_KEY }}
run: |
# 模型名以 /v1/models 实际返回为准
resp=$(curl -sS https://devflowmodels.work/v1/chat/completions \
-H "Authorization: Bearer $DEVFLOW_API_KEY" \
-H "Content-Type: application/json" \
--max-time 30 \
-d '{"model":"<从 /v1/models 复制>","messages":[{"role":"user","content":"ping"}]}')
# 结构化校验：字段缺失就让这一步以非零退出码失败
echo "$resp" | jq -e '.choices[0].message.content' > /dev/null让结果机器可读
在流水线里，模型输出要能被脚本直接判断真假，而不是留给人去读。为每种任务约定固定格式，并配一个能返回非零退出码的校验方式。
| 场景 | 输出约定 | 校验方式 |
|---|---|---|
| 代码审查评论 | 固定 JSON 字段（file、line、severity、message） | 用 schema 校验字段与枚举值，缺字段或越界即判失败 |
| 测试用例生成 | 仅返回代码块，不含解释文字 | 提取代码块后跑编译或语法检查，不通过则退出非零 |
| 变更摘要 / release note | Markdown 列表，每条一行 | 校验行数与非空，超长自动截断并标记 |
| 分类 / 打标签 | 取值来自固定枚举集合 | 断言返回值落在枚举内，否则以非零退出码结束 |
| 提交信息生成 | 首行不超过限定长度 | 正则校验格式，不合规时回退到模板 |
重试要有边界
流水线里的重试不是越多越好。先区分哪些请求可以安全重放，哪些必须直接失败，再决定重试策略。
可重试的幂等任务
读取类、无副作用的请求（如生成摘要、分类、审查建议）可设有限次重试并配合退避；每次都带上 request id 便于对账，避免无上限重放。
必须显式失败的任务
已经写入结果或触发了下游动作的步骤不要盲目重放，遇到错误直接让步骤以非零退出码结束，把处理权交回流水线，而不是静默吞掉。
记录与告警
无论成功或失败,都记录模型、request id、耗时和原始错误；连续失败或额度异常应触发告警，让问题在流水线里被看见,而不是等业务报障。
额度与计费
充值 ¥1 到账 $1 API 额度。充值兑换率与调用倍率是分开的两件事，不要混在一起估算成本。
- 低价来源倍率：default 0.24x、Kiro Pro 0.24x、特惠 0.24x、GPT Team 0.24x。
- 官转档为独立计费分组（特惠来源），倍率 1.7x，不代表模型厂商官方服务。
- 调用扣费 = 模型基准价 × 来源倍率。
- Claude 与 GPT 通过现有分组路由，实际可用模型以 /v1/models 实际返回为准。
- 本站由 DevFlow Models 运营团队运营，是第三方兼容 API 服务，不是 Anthropic / OpenAI 或其他厂商官方服务。
额度赠送活动符合最新活动资格的用户，累计前 ¥50 实付享 1:1 API 额度赠送，最多赠送 $50；超过部分及达到上限后的充值不再赠送。资格与口径以本站公告和后台核验为准。
常见问题
在 CI 里应该怎么放 API Key？
不要把 Key 写进仓库或工作流文件，用 CI 的 Secret 注入环境变量，并为 CI、测试和生产分别建 Key，方便某一把泄露时单独回收。
流水线里模型名要写死吗？
模型 ID 需要显式固定以保证结果可复现，但具体可用模型以 /v1/models 实际返回为准；升级前先用回归样本比对结果差异。
调用失败了 CI 要不要自动重试？
只对幂等、可重放的请求设有上限的重试，写操作或已产生副作用的任务应显式失败并告警，同时记录 request id、模型和原始错误。
扣费怎么算，和充值兑换率一样吗？
不一样。充值 ¥1 到账 $1 是兑换率，调用扣费 = 模型基准价 × 来源倍率，两者分开计算，不要混为一谈。
DevFlow Models 是官方服务吗？
不是。本站是第三方兼容 API 服务，通过兼容网关路由 Claude / GPT 请求，不是 Anthropic、OpenAI 或其他厂商的官方服务。