AI 怎么用命令行调用模型接口
网页对话适合试想法,接进流程就得走接口。这篇从拿密钥到跑通第一次请求,讲清请求体里放哪些字段、流式怎么读、报错先看哪里。
网页版对话适合试想法,不适合接进流程。要让脚本批量处理、要接进自己的工具、要固定参数复现结果,最后都得回到接口。这篇讲从拿到密钥到跑通第一次请求要准备什么、请求里放哪些字段、出错时先看哪里。
入口在哪
- 密钥在服务商控制台的密钥页面生成,通常只完整显示一次。不同版本入口名称略有差别,有的叫 API 密钥,有的叫访问令牌。
- 接口地址在控制台的概览页或接口文档里能查到。多数服务提供一个兼容 OpenAI 格式的基地址,聊天补全的路径通常是 /v1/chat/completions 这一类。
- 模型名在模型列表里,必须写服务端认识的准确字符串,写错一般直接返回模型不存在,不会自动回退。
- 请求从哪儿发随你。终端里的 curl 最省事,不用装任何 SDK,出了问题也看得清是哪一层。
具体步骤
- 把密钥写进环境变量,别写进脚本。例如在 shell 里导出成一个大写变量,后续用变量名引用。脚本要进版本库时,这一步能救你一次。
- 把请求体单独存成一个文件。里面至少要有模型名、消息数组、输出长度上限。消息数组按角色分,系统角色放规则,用户角色放任务。
- 发请求时带两个请求头:认证头写持有者加密钥,内容类型写 application/json。少一个的常见结果是 400 或 401。
- 加超时参数。默认不限时的客户端会在服务端卡住时一直挂着,批量跑的时候很难发现。
- 用 jq 之类的工具从返回里取出正文,不要肉眼复制。正文在选项数组第一项的消息内容字段里。
- 跑通之后再加失败重试。限流一般返回 429,按指数退避等一秒、两秒、四秒再试。
几个坑
- 把密钥贴进聊天记录或截图。泄露后只能作废重发,账单还记在你头上。发现泄露立刻去控制台吊销。
- 忘记设输出上限。长回答会一路生成到模型的硬上限,费用和等待时间都不可控。
- 把上下文塞到超限。超出模型窗口会直接报错,不会自动截断。长文档要先分段或先摘要。
- 开着流式输出却按整段解析。流式返回是逐行推送的分片,每行带一个前缀,最后有一行表示结束,需要按行读并拼接。
- 不加错误处理就上批量。一次失败整批中断,日志里只剩一个非零退出码。
怎么验证
- 让客户端把状态码打出来。200 并且返回里有用量字段,才算真的通。
- 看用量字段里的输入和输出 token 数,和你估算的对一下。差得离谱通常是消息拼错了或者重复发送。
- 故意换一个错密钥跑一次,确认能得到 401。这说明你的错误分支是活的,不是被静默吞掉。
- 同一条请求连跑三次,结果应基本一致;差异很大说明参数没固定。
常见问题
一定要用官方 SDK 吗
不必。接口本质是 HTTP 加 JSON,curl 能跑通就说明理解对了。SDK 省的是重试、超时、流式解析这些样板代码,团队协作时更值得用,自己排查问题时反而不如裸请求清楚。
密钥放在环境变量里就安全了吗
比写在代码里好,但仍然会出现在进程环境、日志和容器配置里。更稳妥的做法是放在服务端的密钥管理里,由服务在运行时读取,并给密钥设额度上限和到期时间。
报 400 但看不出哪里错
先只留模型名和一条最短的用户消息,跑通后再逐项加回字段。大多数 400 来自字段名拼错、消息数组结构不对、或者模型名不属于当前接入点。
一句话总结:接口调用就是三件事,密钥放环境变量、请求体存文件、状态码和用量都看一眼。