opencode v1 快速接入体验小红书新模型 Dots3 Note Prev：opencode.json 配置与验证

1. opencode v1 接入 Dots3 Note Prev 的场景与准备opencode v1 是一个跑在终端里的 AI 编码助手它通过opencode.json声明模型 provider把不同厂商的模型统一成一套调用方式。小红书新出的 Dots3 Note Prev 模型目前可以免费体验限制是 20 RPM / 500K TPM全模态支持音视频图像不过在 opencode 里只能用到图像输入这一部分。这篇就聚焦一件事怎么在 opencode v1 里通过opencode.json的 provider 配置把 Dots3 Note Prev 接进来填好 APIKEY然后跑通第一次对话验证。适合谁看已经在用 opencode、想尝鲜新模型但不想改代码的人或者刚装好 opencode、想拿一个免费模型练手配置 provider 的新手。整个过程不需要写业务代码改一个 JSON 文件、填一个 Key、发一条请求就能看到结果。我试过把 Dots3 Note Prev 挂到 opencode 里跑图像理解任务配置本身不复杂但有几个字段容易写错比如interleaved和modalities的位置写错了不会报错只是模型行为不对。下面按「先拿 Key、再写配置、再验证、最后排障」的顺序走一遍。需要提前准备的东西opencode v1 已经装好并能正常启动一个 Dots 平台的 APIKEY本地能编辑opencode.json或opencode.jsonc。如果你还没装 opencode先去它的官方仓库按说明装好这里不展开安装步骤重点放在 provider 配置上。2. TaoToken 前置APIKEY 与接入信息从哪来Dots3 Note Prev 的 APIKEY 需要去 Dots 平台获取地址是https://dots.ai/platform/apikeys登录后创建一个 Key 复制出来。API 文档在https://dots.ai/platform/docs里面有模型列表和参数说明。注意这个 Key 是 Dots 平台发的不是 opencode 的也不是 TaoToken 的别搞混。那 TaoToken 在这里的角色是什么它是一个统一的模型接入网关官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 入口是https://taotoken.net/api。如果你后面想把多个模型统一管理、或者想用 Coding Plan 跑长期编码任务可以走 TaoToken 的接入方式。本篇为了让你最快跑通 Dots3 Note Prev直接用 Dots 官方给的 baseURL这样链路最短、排障最简单。先把 Key 拿到手放在一个安全的地方。下面配置里出现的你的APIKEY全部替换成这个真实 Key。如果你打算把配置提交到 Git记得把 Key 放到环境变量里别硬编码进opencode.json后面排障章节会讲怎么用环境变量。注意Dots3 Note Prev 目前免费但有速率限制20 RPM 表示每分钟最多 20 次请求500K TPM 表示每分钟最多 50 万 token。跑批量任务时如果报 429先降并发不是配置错了。3. 可复制的 opencode.json provider 配置打开你的opencode.json或opencode.jsonc找到provider字段。如果文件里还没有provider就新建一个。把下面这段插进去注意 JSON 的逗号位置插在已有 provider 后面要补逗号。{ provider: { dots: { models: { dots3-note-prev: { attachment: true, interleaved: reasoning_content, limit: { context: 524288, output: 65536 }, modalities: { input: [text, image], output: [text] }, name: Dots3 Note Prev, options: { thinking: { type: enabled } }, reasoning: true, tool_call: true } }, name: Dots, npm: ai-sdk/openai-compatible, options: { apiKey: 你的APIKEY, baseURL: https://note3-prev-api.askdiandian.com/v1, setCacheKey: true } } } }逐条解释关键字段方便你按需改字段作用注意点npm指定用哪个 SDK 适配器必须是ai-sdk/openai-compatibleDots 是 OpenAI 兼容接口baseURL请求地址用https://note3-prev-api.askdiandian.com/v1结尾带/v1apiKey鉴权 Key替换成你的真实 Key建议用环境变量attachment是否支持附件设为true才能传图片interleaved推理内容字段设为reasoning_content让思考过程能显示modalities.input支持的输入类型[text, image]opencode 里用不到音视频limit.context上下文窗口524288约 512Klimit.output最大输出65536reasoning是否开启推理truetool_call是否支持工具调用true如果你想把 Key 从文件里挪出去把apiKey那行改成apiKey: {env:DOTS_API_KEY}然后在启动 opencode 前设置环境变量export DOTS_API_KEY你的真实KEYWindows PowerShell 用$env:DOTS_API_KEY你的真实KEY这样配置文件可以安全地进版本库Key 留在本地环境里。4. 验证请求与成功结果配置写完后先做一次语法检查确保 JSON 没写坏。用jq快速验证jq . opencode.json /dev/null echo JSON OK如果输出JSON OK说明格式没问题。如果报错看报错行号多半是逗号或括号问题。接着启动 opencode列出可用模型确认dots3-note-prev出现在列表里opencode models预期能看到类似输出dots/dots3-note-prev Dots3 Note Prev然后发一条最简单的文本请求验证链路opencode run --model dots/dots3-note-prev 用一句话说明什么是递归如果返回一段正常的中文解释说明 provider 声明、APIKEY、baseURL 全部通了。第一次请求可能稍慢因为要建立连接。再验证图像输入因为 Dots3 Note Prev 的卖点之一是全模态。准备一张本地图片比如test.png然后opencode run --model dots/dots3-note-prev --attach test.png 描述这张图里有什么预期返回对图片内容的文字描述。如果这一步成功说明attachment和modalities配置生效了。如果文本能通但图片报错多半是attachment没设成true或者模型不支持你传的格式。验证推理字段是否生效可以发一个需要多步思考的问题opencode run --model dots/dots3-note-prev 一个班有30人60%喜欢数学其中一半喜欢物理问既喜欢数学又喜欢物理的有多少人如果终端里能看到思考过程reasoning 内容和最终答案分开显示说明interleaved和reasoning配置正确。5. 本篇常见错误排查配置过程中最容易踩的坑集中在几个地方逐个说。报 401 或 unauthorizedAPIKEY 错了或没填。检查apiKey字段是不是还是占位符你的APIKEY或者环境变量DOTS_API_KEY没设置成功。用echo $DOTS_API_KEY确认一下。报 404 或 model not foundbaseURL写错了。确认是https://note3-prev-api.askdiandian.com/v1结尾的/v1不能少也不能多斜杠。另外模型 ID 是dots3-note-prev别写成dots3_note_prev。报 429 或 rate limit触发了 20 RPM / 500K TPM 限制。降低请求频率或者把批量任务拆开跑。这不是配置问题等一分钟再试。图片传不进去检查attachment是否为truemodalities.input是否包含image。另外 opencode 只支持图像音视频传了也不会处理。思考过程不显示检查interleaved是否为reasoning_contentreasoning是否为true。有些终端对多段输出渲染不同可以换一个终端试试。JSON 解析失败最常见的是在已有 provider 后面插入时漏了逗号或者多了一个逗号。用jq . opencode.json定位到具体行。opencode.jsonc支持注释但注释位置不对也会导致解析问题。改了配置没生效opencode 可能缓存了配置。重启 opencode或者确认你改的是它实际读取的那个配置文件路径。有些项目里会有多个opencode.json优先级不同。如果排障时想确认模型本身是否可用可以先用 TaoToken 的模型对话页面发一条请求地址是https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content这样能把「模型问题」和「opencode 配置问题」分开定位。6. 接入后的下一步与 CTA跑通之后你可以把 Dots3 Note Prev 设成 opencode 的默认模型省得每次加--model参数。在opencode.json顶层加{ model: dots/dots3-note-prev }这样直接opencode run 你的问题就会走这个模型。如果你打算长期用 opencode 做编码或 Agent 任务建议把 Key 管理、多模型切换统一起来。TaoToken 的 Coding Plan 页面在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有长期编码场景的接入方式。API Keys 管理在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。如果你更想先验证模型效果再决定直接去模型对话页发几条请求最省事。最后提醒一句Dots3 Note Prev 现在是免费体验期速率限制随时可能调整配置本身不会因为限流变化而失效但跑批量任务前先看一眼官方文档的当前限制免得跑到一半被 429 打断。