跳转到主要内容
千问云 home page
开放平台文档
客户端与工具

OpenCode

在 OpenCode 中使用 Token Plan

安装 OpenCode

  1. 安装或更新 Node.js（v18.0 或更高版本）。
  2. 在终端中执行以下命令安装 OpenCode。 
npm install -g opencode-ai
在终端中执行以下命令，若输出版本号，则表示安装成功。 
opencode -v

配置 Token Plan 团队版

请在以下路径创建并打开配置文件 opencode.json：
  • macOS / Linux：~/.config/opencode/opencode.json
  • Windows：C:\Users\<用户名>\.config\opencode\opencode.json
将以下配置写入文件，关键配置项：
  • Base URL：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1，请勿使用其他套餐的地址。
  • API Key：将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。
保存配置文件后，请退出并重新启动 OpenCode 使新配置生效。 
{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "qwencloud-token-plan": {
            "npm": "@ai-sdk/openai-compatible",
            "name": "千问云 Token Plan",
            "options": {
                "baseURL": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
                "apiKey": "YOUR_API_KEY"
            },
            "models": {
                "qwen3.6-plus": {
                    "name": "Qwen3.6 Plus",
                    "modalities": {
                        "input": ["text", "image"],
                        "output": ["text"]
                    },
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 8192
                        }
                    },
                    "limit": {
                        "context": 1000000,
                        "output": 65536
                    }
                },
                "qwen3.6-flash": {
                    "name": "Qwen3.6 Flash",
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 8192
                        }
                    }
                },
                "deepseek-v4-pro": {
                    "name": "DeepSeek V4 Pro"
                },
                "deepseek-v4-flash": {
                    "name": "DeepSeek V4 Flash"
                },
                "deepseek-v3.2": {
                    "name": "DeepSeek V3.2"
                },
                "kimi-k2.6": {
                    "name": "Kimi K2.6",
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 8192
                        }
                    }
                },
                "kimi-k2.5": {
                    "name": "Kimi K2.5",
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 8192
                        }
                    }
                },
                "glm-5.1": {
                    "name": "GLM-5.1",
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 8192
                        }
                    }
                },
                "glm-5": {
                    "name": "GLM-5",
                    "options": {
                        "thinking": {
                            "type": "enabled",
                            "budgetTokens": 8192
                        }
                    }
                },
                "MiniMax-M2.5": {
                    "name": "MiniMax M2.5"
                }
            }
        }
    }
}
budgetTokens 用于控制模型思考过程的最大 Token 预算，若设置过低可能导致模型思考过程中断。

配置按量计费

OpenCode 内置 Alibaba (China) 提供商，设置环境变量即可直接使用千问云按量计费服务，无需创建配置文件。 将 YOUR_API_KEY 替换为千问云 API Key。可用模型请参考支持的模型。
配置项说明
Base URL内置，无需配置
API Key千问云 API Key（格式为 sk-xxxxx）
可用模型支持的模型
在 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中添加： 
export DASHSCOPE_API_KEY="YOUR_API_KEY"
保存后执行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

使用 OpenCode

在终端中执行以下命令进入 OpenCode。 
opencode
  • Token Plan 团队版：在命令行输入 /models，输入 千问云 Token Plan 进行搜索，选择模型后即可使用。
  • 按量计费：在命令行输入 /models，输入 Alibaba (China) 进行搜索，选择模型后即可使用。
图像生成模型需通过 Agent 接入，参见接入图像生成模型。

接入图像生成模型

通过 OpenCode 的 Agent 机制，可以调用 Token Plan 团队版的图像生成模型（qwen-image-2.0、wan2.7-image 等）。

步骤一：创建 Agent

在项目根目录创建 .opencode/agents/text-to-image.md，写入以下内容： 
---
description: "调用 Token Plan 文生图模型，根据文字描述生成图像。当要求画图、生成图片时使用。"
mode: subagent
tools:
  bash: true
  write: false
  edit: false
---
根据文字描述调用 Token Plan 文生图 API 生成图像。

## 执行步骤

1. 从用户输入中提取 prompt（图像描述）、model（默认 qwen-image-2.0）、size（默认 1024*1024）。

2. 使用 bash 执行 curl 命令生成图像：

```bash
RESPONSE=$(curl -s -X POST "https://token-plan.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $TOKEN_PLAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<模型>","input":{"messages":[{"role":"user","content":[{"text":"<prompt>"}]}]},"parameters":{"size":"<尺寸>"}}')
echo "$RESPONSE"
```

3. 从返回 JSON 中提取 output.choices[*].message.content[*].image 的 URL，下载到当前目录。

4. 返回图片文件路径。

## 可用模型
- qwen-image-2.0（默认）— 通用，擅长中文文本渲染
- qwen-image-2.0-pro — 质量更高
- wan2.7-image — 多风格，默认出 4 张
- wan2.7-image-pro — 支持 4K

## 可用尺寸
1024*1024、720*1280、1280*720

步骤二：配置环境变量

确保环境变量 TOKEN_PLAN_API_KEY 已设置为 Token Plan 团队版专属 API Key。可在 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中添加： 
export TOKEN_PLAN_API_KEY="YOUR_API_KEY"

步骤三：使用

在 OpenCode 中直接描述需要生成的图像（如"画一只猫"），OpenCode 会自动调用该 Agent。

常见问题

错误码

配置过程中遇到报错，请参考对应计费方案的常见问题文档：
OpenCode - 千问云