入门大模型应用开发,第 1 件事是把 1 次接口调用跑通:1 个 key、1 段 20 行脚本、1 个能打印出来的回答。这一步走完,再去谈提示词编排、工具调用和检索。
我 2025 年带过 3 个刚转岗的同事,其中 2 个卡在同一个位置:文档看了 40 分钟,脚本 1 行没跑,第 2 天就没了兴趣。第 3 个按先跑通再补课的顺序,第 1 天下午就拿到了自己的第 1 条回答。
这 4 样里,第 1 样最容易出问题。key 写进代码再传到代码仓库,1 次误传就可能被人跑掉几百次调用,账单出来才发现。
做法是 2 步:先在系统里设 1 个环境变量,名字自己定,值填 key;脚本里读这个变量名,代码里不出现明文。换机器时只改变量,代码不动。
团队协作时再加 1 层:本地用 .env 文件,把文件名写进版本控制的忽略清单,1 行配置就能拦住 90% 的误传。
第 4 步的耗时值得记。同样的提示词,早 9 点和晚 9 点差 1 到 3 秒是常态,做批量任务时按最慢的那档估时间,别按最快的一次估。
返回体字段不少,入门只需要盯 4 个:回答文本、输入用量、输出用量、结束原因。结束原因显示为长度截断,说明输出上限给小了,回答没写完。
用量这 2 个数字决定成本。1 次 800 字的回答大约 1200 个输出单位,1 天跑 200 次就是 24 万个,先按这个量级估预算,别等账单。
| 字段 | 填什么 | 常见错填 |
|---|---|---|
| 模型名 | 控制台文档里列的完整名字 | 写简称,报模型不存在 |
| 温度 | 归类、抽取填 0 到 0.3,写作用 0.7 上下 | 写 2,输出乱序 |
| 输出上限 | 按任务定,摘要 300 到 500,长文 2000 | 不填,默认值不够,回答半截断 |
| 超时 | 脚本侧设 30 秒,超过就当失败重试 | 用默认,卡住时线程一直挂着 |
| 重试 | 失败重试 2 次,间隔 2 秒 | 重试 10 次,遇到限流越试越糟 |
第 2 行是新手最容易踩的。温度写 0 不代表每次结果都一样,平台版本更新后输出仍会有细微差别,测试用例要按关键字段比对,别整段字符串对等。
第 3 条要按顺序改。先把并发降下来,再加间隔,2 个动作都做完还是 429,才去看账号的额度档位,顺序反了会白折腾 1 小时。
跑通之后加 1 个系统提示,写明角色和输出格式,例如「只输出 JSON,字段为类别和建议」。加完这 1 段,后续解析代码能少写 20 行。
第 3 次调用再加 1 个校验步骤:把返回的 JSON 解析 1 遍,解析失败就把错误信息回给它重试 1 次。这个循环能把格式错误率从 1 成降到 1% 上下。
跑通之后第 1 周只练 3 件事:把 1 段 800 字材料压成 3 条摘要、把 3 条摘要扩回 1 段话、让同一段材料按 3 种格式输出。3 个练习都不碰框架,只改提示词。
每天的练习量按 10 次调用算,1 周 70 次,够形成手感。练完这 3 项,再看框架文档里的链式调用和工具定义,能看懂 7 成以上,不用回头补基础概念。
第 1 处是环境变量,打印出来看是不是空串或带引号。第 2 处是密钥权限,控制台里能看到这把 key 允许调用哪几个模型。第 3 处是网络出口,公司网限制外连时,报错会伪装成超时。
这 3 处按顺序排,是因为排查成本从低到高。1 个 print 语句 10 秒能写完,改网络配置要半天,顺序反了会白折腾 1 个工作日。
成本按输入加输出算。1 次 500 字输入的问答,输入约 700 个单位、输出约 600 个单位,跑 1000 次的量级在几万单位。先按这个量估月账单,再看平台的免费额度能覆盖多少。
并发按任务类型定。同步的对话类并发 3 到 5 就够,批量抽取类可以放到 10,超过 10 容易触发限流,重试反而更慢。测试阶段先把并发定为 2,跑通再加。
第 3 条最能说明问题。很多人的脚本在本地能跑,换机器就崩,原因是依赖装在全环境里,没写进依赖清单。把依赖清单固定下来,1 行命令就能重建。
再加 1 条日常习惯:每次改提示词都留 1 个版本号,注释里写改了什么。1 个月后回看,能说清哪次改动让准确率从 6 成涨到 8 成,比凭记忆复盘强。
这套 20 行脚本能撑到日调用量 1 万次左右。超过这个量再看队列、重试和缓存这 3 件事,入门阶段不用提前搭,先让任务跑起来更重要。
最后补 1 个常见卡点:本地跑通、部署到服务器报连不上。多数是出口 IP 没加白名单,或服务器的系统时间偏差超过 5 分钟,签名校验直接失败。2 处各查 1 分钟。
整套流程走完大约 1 个工作日。上午装环境、拿 key、写脚本,下午换 3 个真实问题调提示词,第 2 天开始做第 1 个小功能,这个节奏多数人能跟上。
跑通这 1 次调用之后,学习顺序会清楚很多:先练提示词的写法,再练结构化输出的校验,最后才碰检索和工具调用。跳过第 1 步直接看框架文档,多数人会在第 3 天放弃。
本文信息核对时间:2026-11