必须通过兼容层转译Agent Space非标准API为OpenAI格式,首选DreamRouter中转网关配置/v1 endpoint,严格匹配baseURL斜杠;手动配置opencode.json时apiKey填原始密钥、baseURL填中转地址,最后用opencode --debug验证流式响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让OpenCode调用Agent Space提供的AI服务,必须绕过其非标准API格式,通过兼容层转译为OpenCode可识别的OpenAI格式请求。直接填写baseURL会因路径、字段名、响应结构不匹配而报错。
确认Agent Space API是否支持OpenAI兼容模式
访问Agent Space官方文档或控制台,查找“OpenAI兼容端点”“/v1/chat/completions”路径或“兼容OpenAI SDK”字样。若未明确标注,则【必须启用代理中转】,不可直连。
打开Agent Space控制台 → 进入「API设置」→ 查看「兼容模式开关」是否已开启。关闭状态时,所有请求都会返回404或schema mismatch错误。
方法一:使用DreamRouter作为中转网关(推荐)
第一步:在DreamRouter控制台创建新路由,选择「Agent Space」作为上游服务,勾选「启用OpenAI兼容封装」;
第二步:复制生成的DreamRouter endpoint(形如 https://api.dreamrouter.dev/v1),注意末尾必须带 /v1;
第三步:在opencode.json中配置provider,【baseURL必须与DreamRouter endpoint完全一致,多一个斜杠或少一个都会导致400错误】;
这一步操作起来很简单,直接把复制的URL粘贴进配置文件即可,但千万别手敲——大小写和斜杠位置极易出错。
方法二:手动编写opencode.json配置
在项目根目录或 ~/.config/opencode/ 下新建 opencode.json 文件;
填入以下结构(请严格替换尖括号内内容):
{"$schema":"https://opencode.ai/config.json","providers":{"agent-space":{"name":"Agent Space","package":"@opencode-ai/ai/providers/openai-compatible","settings":{"baseURL":"","apiKey":"
⚠️ 注意:apiKey字段填的是Agent Space原始密钥(sk-xxx),不是DreamRouter的token;baseURL填的是中转地址,二者不能互换。
保存后运行 opencode auth list,确认 agent-space 出现在已注册provider列表中。
验证连接是否生效
在终端进入项目目录,执行 opencode --debug;
启动后按 Ctrl+O 打开模型选择面板,上下键定位到 agent-space/default-model;
输入任意提示词(如“写一个Python函数计算斐波那契数列前10项”),观察右下角状态栏是否显示「Streaming…」而非「Error: invalid_request_error」;
若首次响应耗时超过12秒,立即中断并检查DreamRouter日志——大概率是Agent Space上游返回了非JSON格式的HTML错误页。


















