讯飞星辰 Astron Token Plan 开源AI工具完整配置文档

文档来源：https://www.xfyun.cn/doc/spark/TokenPlan

说明：Token Plan为团队包月积分订阅套餐，独立API、独立域名，不可与Coding Plan/按量计费接口混用；支持OpenAI、Anthropic双兼容协议，覆盖主流编程Agent、IDE插件、终端CLI工具。

1. API Key 获取

登录讯飞星辰MaaS平台：https://maas.xfyun.cn
进入【Astron Token Plan套餐订阅页面】完成购买
在订阅详情页复制专属Token Plan API Key

重要：每个套餐独立密钥，与Coding Plan、按量计费Key完全不互通，混用直接鉴权401报错。

2. 两套兼容接口域名

兼容协议	Base URL	适用工具范围
Anthropic兼容	`https://maas-token-api.cn-huabei-1.xf-yun.com/anthropic`	Claude Code、OpenClaw（推荐，缓存优化更好）
OpenAI兼容	`https://maas-token-api.cn-huabei-1.xf-yun.com/v2`	Cursor、Cline、Kilo、OpenCode、Codex、TRAE、Hermes、Dify

3. 接口快速测试示例

Anthropic协议测试

bash

curl https://maas-token-api.cn-huabei-1.xf-yun.com/anthropic/v1/messages \
-H "Authorization: Bearer 你的TokenPlan密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
  "model": "xopglm52",
  "max_tokens": 4096,
  "messages": [{"role":"user","content":"写一个Python快速排序"}]
}'

OpenAI协议测试

bash

curl https://maas-token-api.cn-huabei-1.xf-yun.com/v2/chat/completions \
-H "Authorization: Bearer 你的TokenPlan密钥" \
-H "Content-Type: application/json" \
-d '{
  "model": "xopdeepseekv4pro",
  "messages": [{"role":"user","content":"写一个Python快速排序"}]
}'

4 通用前置清理（必做）

清除系统旧环境变量，避免本地配置被覆盖

bash

# macOS / Linux
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset OPENAI_BASE_URL
unset OPENAI_API_KEY

# Windows PowerShell
$env:ANTHROPIC_BASE_URL=""
$env:ANTHROPIC_AUTH_TOKEN=""
$env:OPENAI_BASE_URL=""
$env:OPENAI_API_KEY=""

终端CLI编程工具

1. Claude Code（Anthropic协议）

安装

bash

npm install -g @anthropic-ai/claude-code
claude --version

跳过初始化登录文件

路径：~/.claude.json（macOS/Linux）、C:\Users\用户名\.claude.json

json

{
  "hasCompletedOnboarding": true
}

核心配置 `~/.claude/settings.json`

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的Token Plan API Key",
    "ANTHROPIC_BASE_URL": "https://maas-token-api.cn-huabei-1.xf-yun.com/anthropic",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "API_TIMEOUT_MS": 600000,
    "ANTHROPIC_MODEL": "xopglm52",
    "ANTHROPIC_SMALL_FAST_MODEL": "xsparkx2flash"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

使用

bash

cd 项目文件夹
claude
# 输入 /status 校验接口、密钥、模型是否正常

2. OpenCode（OpenAI协议）

安装

bash

npm install -g opencode-ai
opencode --version

配置文件（项目/全局）

文件路径：opencode.config.json

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "AstroTokenPlan": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "讯飞星辰Token Plan",
      "options": {
        "baseURL": "https://maas-token-api.cn-huabei-1.xf-yun.com/v2",
        "apiKey": "你的Token Plan API Key"
      },
      "models": {
        "xopglm52": {
          "name": "xopglm52"
        },
        "xsparkx2flash": {
          "name": "xsparkx2flash"
        }
      }
    }
  }
}

启动切换模型

bash

opencode
/models

3. Codex CLI（OpenAI协议）

安装

bash

npm i -g @openai/codex
codex --version

配置文件 `~/.codex/config.toml`

toml

model = "xopglm52"
model_provider = "iflytek-tokenplan"

[model_providers.iflytek-tokenplan]
name = "讯飞星辰Token Plan"
base_url = "https://maas-token-api.cn-huabei-1.v2"
env_key = "XUNFEI_TOKEN_KEY"
wire_api = "responses"

环境变量

bash

# mac/linux
export XUNFEI_TOKEN_KEY="你的Token Plan API Key"
# windows cmd
set XUNFEI_TOKEN_KEY=你的Token Plan API Key

启动

bash

codex

4. OpenClaw（支持Anthropic/OpenAI双协议，推荐Anthropic）

安装

macOS/Linux

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

配置文件 `~/.openclaw/openclaw.json`

json

{
  "models": {
    "mode": "merge",
    "providers": {
      "iflytek-tokenplan": {
        "baseUrl": "https://maas-token-api.cn-huabei-1.xf-yun.com/v2",
        "apiKey": "你的Token Plan API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "xopglm52",
            "name": "xopglm52",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 92160,
            "maxTokens": 32768
          },
          {
            "id": "xsparkx2flash",
            "name": "xsparkx2flash",
            "contextWindow": 256000,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "iflytek-tokenplan/xopglm52"
      },
      "models": {
        "iflytek-tokenplan/xopglm52": {
          "alias": "iflytek-tokenplan"
        }
      }
    }
  }
}

重启网关生效

bash

openclaw gateway restart
# 终端面板
openclaw tui

5. Hermes Agent（OpenAI兼容）

安装

bash

# mac/linux
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# Windows WSL/PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

配置命令

bash

hermes model
# 选择 Custom endpoint
# API base URL：https://maas-token-api.cn-huabei-1.xf-yun.com/v2
# API Key：你的Token Plan密钥
# 默认模型：xopglm52

配置文件 `config.yaml`

yaml

custom_providers:
- name: ifly-tokenplan
  base_url: "https://maas-token-api.cn-huabei-1.xf-yun.com/v2"
  api_key_env: "IFLY_TOKEN_KEY"
  model:
    default: "xopglm52"

VSCode IDE扩展

1. Cline

VSCode扩展市场搜索Cline安装
打开插件选择「自定义API密钥」
配置项填写值
API Provider OpenAI Compatible
Base URL https://maas-token-api.cn-huabei-1.xf-yun.com/v2
API Key Token Plan专属密钥
Model ID xopglm52 / xopdeepseekv4pro

配置项	填写值
API Provider	OpenAI Compatible
Base URL	`https://maas-token-api.cn-huabei-1.xf-yun.com/v2`
API Key	Token Plan专属密钥
Model ID	xopglm52 / xopdeepseekv4pro

2. Kilo Code

VSCode安装kilo code扩展
设置 → 自定义供应商
配置项值
API类型 OpenAI Compatible
Base URL https://maas-token-api.cn-huabei-1.xf-yun.com/v2
API Key Token Plan密钥
模型 xopglm52

配置项	值
API类型	OpenAI Compatible
Base URL	`https://maas-token-api.cn-huabei-1.xf-yun.com/v2`
API Key	Token Plan密钥
模型	xopglm52

3. Roo Code

安装Roo Code插件
API Provider选择OpenAI Compatible
BaseURL填https://maas-token-api.cn-huabei-1.xf-yun.com/v2，填入Token Plan密钥，模型填写xopglm52

桌面AI编辑器

1. Cursor（仅Pro及以上支持自定义接口）

打开Cursor → Settings → Models
开启Override OpenAI Base URL
OpenAI API Key填入Token Plan密钥
覆盖地址：https://maas-token-api.cn-huabei-1.xf-yun.com/v2
自定义模型添加：xopglm52、xopdeepseekv4pro

注意：Override是全局开关，切换Cursor官方GPT/Claude模型时必须关闭

2. TRAE

打开TRAE设置 → 模型 → 添加自定义模型
服务商：自定义OpenAI兼容
BaseURL：https://maas-token-api.cn-huabei-1.xf-yun.com/v2
填入Token Plan密钥，模型选择xopglm52

CC Switch 一键可视化配置

安装

macOS

bash

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows：GitHub Releases下载.msi安装包

配置步骤

打开CC Switch，右上角+新增供应商
自定义服务商，填入讯飞Token Plan两套地址
API Key粘贴Token Plan专属密钥
预设模型添加xopglm52、xsparkx2flash
保存启用，自动同步本地所有CLI工具配置

通用兼容模板（Dify/Cherry Studio）

适用于所有自定义OpenAI兼容第三方工具

参数	配置值
Base URL	`https://maas-token-api.cn-huabei-1.xf-yun.com/v2`
API Key	讯飞Astron Token Plan专属密钥
请求路径	`/chat/completions`
默认模型	xopglm52

Dify专项配置

模型供应商新增「自定义OpenAI兼容」
API Base填写Token Plan OpenAI域名
填入Token Plan密钥，绑定全部可用模型

套餐与计费简介

套餐档位（按月订阅，积分计费）

套餐	月积分额度	TPM	活动折后月费（截止7.2）
标准成员	20000	200w	160元
高级成员	60000	300w	420元
尊享成员	200000	500w	1200元

积分消耗规则

实际消耗积分 =（输入Token积分 + 缓存积分 + 输出积分 + 思考积分）× 时段系数
时段系数：工作日8:00-22:00=1.0；其余时段0.8折

套餐权益

订阅即赠AstronClaw月度会员
免费配套语音、OCR、翻译、图片理解等Skill能力
支持套餐升级，不支持降级、无理由退款

支持完整模型列表

modelId	模型名称	上下文窗口
xsparkx2	Spark X2	192K
xsparkx2flash	Spark-X2-Flash	256K
xopglm52	GLM-5.2	1M
xopglm51	GLM-5.1	200K
xopglm5	GLM-5	200K
xopdeepseekv4pro	DeepSeek-V4-Pro	1M
xopdeepseekv4flash	DeepSeek-V4-Flash	1M
xopdeepseekv32	DeepSeek-V3.2	128K
xopkimik26	Kimi-K2.6	256K
xopkimik25	Kimi-K2.5	128K
xminimaxm25	MiniMax-M2.5	128K
xopqwen35397b	Qwen3.5-397B-A17B	256K
xopqwen36v35b	Qwen3.6-35B-A3B	128K
xopqwen35v35b	Qwen3.5-35B-A3B	128K
xop3qwencodernext	Qwen3-Coder-Next-FP8	256K
xopglmv47flash	GLM-4.7-Flash	128K

优化配置建议：GLM-5系列contextWindow建议限制96k以内，大幅降低限流报错概率

常见错误排查

错误码	故障原因	解决方案
401 密钥错误	Key填错/混用Coding/按量Key	复制订阅页专属Token Plan密钥
403 地域限制	境外网络访问	使用国内网络环境
429 限流	TPM/5h额度耗尽	等待周期重置或升级套餐
11221 模型不支持	modelId填写错误	严格使用上表modelId，不可填别名
10907 超长上下文	对话过长	`/compact`压缩会话或新建对话
503 引擎过载	高峰排队	切换xsparkx2flash轻量模型重试

关键使用注意事项

域名严禁混用 Token Plan：maas-token-api.cn-huabei-1.xf-yun.com Coding Plan：maas-coding-api.cn-huabei-1.xf-yun.com 按量计费：maas-api.cn-huabei-1.xf-yun.com 三套域名、三套密钥完全隔离，混用直接鉴权失败、不抵扣对应套餐额度。
额度重置规则 M2.7等长文本模型5小时滚动限额；多模态模型按自然日重置积分。
使用限制 仅允许OpenClaw/Claude Code等交互式编程Agent工具，禁止后端批量API调用，违规冻结密钥。
缓存优惠 工具开启上下文缓存可大幅降低输入积分消耗，优先使用支持Anthropic协议的工具。
地域限制 接口仅支持中国大陆网络，海外无直连，需国内代理。

讯飞星辰 Astron Token Plan 开源AI工具完整配置文档 ​

1. API Key 获取 ​

2. 两套兼容接口域名 ​

3. 接口快速测试示例 ​

Anthropic协议测试 ​

OpenAI协议测试 ​

4 通用前置清理（必做） ​

终端CLI编程工具 ​

1. Claude Code（Anthropic协议） ​

安装 ​

跳过初始化登录文件 ​

核心配置 ~/.claude/settings.json ​

使用 ​

2. OpenCode（OpenAI协议） ​

安装 ​

配置文件（项目/全局） ​

启动切换模型 ​

3. Codex CLI（OpenAI协议） ​

安装 ​

配置文件 ~/.codex/config.toml ​

环境变量 ​

启动 ​

4. OpenClaw（支持Anthropic/OpenAI双协议，推荐Anthropic） ​

安装 ​

配置文件 ~/.openclaw/openclaw.json ​

重启网关生效 ​

5. Hermes Agent（OpenAI兼容） ​

安装 ​

配置命令 ​

配置文件 config.yaml ​

VSCode IDE扩展 ​

1. Cline ​

2. Kilo Code ​

3. Roo Code ​

桌面AI编辑器 ​

1. Cursor（仅Pro及以上支持自定义接口） ​

2. TRAE ​

CC Switch 一键可视化配置 ​

安装 ​

配置步骤 ​

通用兼容模板（Dify/Cherry Studio） ​

Dify专项配置 ​

套餐与计费简介 ​

套餐档位（按月订阅，积分计费） ​

积分消耗规则 ​

套餐权益 ​

支持完整模型列表 ​

常见错误排查 ​

关键使用注意事项 ​

关于本站

讯飞星辰 Astron Token Plan 开源AI工具完整配置文档

1. API Key 获取

2. 两套兼容接口域名

3. 接口快速测试示例

Anthropic协议测试

OpenAI协议测试

4 通用前置清理（必做）

终端CLI编程工具

1. Claude Code（Anthropic协议）

安装

跳过初始化登录文件

核心配置 `~/.claude/settings.json`

使用

2. OpenCode（OpenAI协议）

安装

配置文件（项目/全局）

启动切换模型

3. Codex CLI（OpenAI协议）

安装

配置文件 `~/.codex/config.toml`

环境变量

启动

4. OpenClaw（支持Anthropic/OpenAI双协议，推荐Anthropic）

安装

配置文件 `~/.openclaw/openclaw.json`

重启网关生效

5. Hermes Agent（OpenAI兼容）

安装

配置命令

配置文件 `config.yaml`

VSCode IDE扩展

1. Cline

2. Kilo Code

3. Roo Code

桌面AI编辑器

1. Cursor（仅Pro及以上支持自定义接口）

2. TRAE

CC Switch 一键可视化配置

安装

配置步骤

通用兼容模板（Dify/Cherry Studio）

Dify专项配置

套餐与计费简介

套餐档位（按月订阅，积分计费）

积分消耗规则

套餐权益

支持完整模型列表

常见错误排查

关键使用注意事项