Token502 API文档
  1. 在客户端中使用
Token502 API文档
  • 产品介绍
  • 基本使用
    • 在API客户端中使用
    • 获取API令牌(API密钥)
    • 常用大模型
  • API
    • 发出请求
    • 完成对象
    • 常见问题
    • OpenAI
      • 聊天(Chat)
        • 创建聊天补全(带图片)
        • 创建聊天补全
      • 音频(Audio)
        • 创建语音
        • 创建转录
        • 创建翻译
      • 图像(Images)
        • 创建图像
        • 创建图片编辑
      • 自动补全(Completions)
        • 创建 Completions
      • 嵌入(Embeddings)
        • 创建嵌入
      • 模型(Models)
        • 列出模型
        • 检索模型
        • 删除微调模型
    • Anthropic
      • 模型
        • 列出模型
        • 获取模型
      • 消息
        • 消息
        • 强制返回思考
        • 图片理解
        • 函数调用
        • 多轮函数调用
        • Web search / 联网搜索
    • Gemini
      • 图片生成
        • 使用 Gemini 生成图片
        • 使用 Gemini 编辑图片
        • 使用 Imagen 3 生成图片
        • 使用 Gemini 生成图片 Copy
      • 文本生成
        • 文字输入
        • 多轮对话
        • 流式输出
        • 多轮对话(流式)
    • Midjourney
      • 查询
        • 查询接口
        • 批量查询接口
        • 获取种子(Seed)接口
      • 图像
        • 文生图(Imagine)接口
        • 图片融合(Blend)接口
      • 视频
        • 生成视频(Video)接口
      • 其他操作
        • 按钮点击(Action)接口
        • 图生文(Describe)接口
        • 上传(upload)接口
    • 其他厂商LLM
      • grok
        • OpenAI兼容接口
          • 联网搜索 / OpenAI兼容接口
      • 通义千问
    • 图片生成
      • Flux
        • flux-kontext-pro / OpenAI兼容接口
        • flux携带参考图 / OpenAI兼容接口
      • Nano-banana
        • 接口请求和格式
        • chat格式
          • 图片编辑(Nano-banana)
        • dalle格式
          • 图像生成(Nano-banana)
          • 创建图像
          • 创建图片编辑
        • 谷歌官方格式
          • 生成图像
      • seedream
    • 视频生成
      • 如何调用视频模型
      • sora-2
        • chat格式
          • 生成视频
          • 生成视频 Copy
        • 官方格式
          • 生成视频
          • 查询视频
          • 下载视频
          • 编辑视频
      • veo
        • chat 格式
          • 流式请求
          • 流式请求(传图)
        • 视频统一格式
          • 生成视频
          • 查询视频
    • Rerank API
      • Cohere 重排序格式
      • Xinference 重排序格式
      • Jina AI 重排序格式
  • 在客户端中使用
    • cline中使用
    • chatbox中使用大语言模型
  1. 在客户端中使用

cline中使用

在 Cline 中使用 Token502#

Cline 是一款强大的 VSCode AI 编程助手扩展,它能够理解你的代码库、自动生成代码、修复 bug、重构代码,甚至可以执行复杂的多步骤编程任务。通过接入 Token502 的 API,你可以使用顶级的 AI 模型(如 Claude、GPT、Gemini 等)来提升编程效率。

下载安装 Cline#

方式一:VSCode 扩展商店安装(推荐)#

1.
打开 VSCode
2.
点击左侧扩展图标(或按 Ctrl+Shift+X / Cmd+Shift+X)
3.
在搜索框中输入 "Cline"
4.
找到 Cline 扩展,点击"安装"按钮
Pasted image 20251024175333.png

方式二:官网下载#

访问 Cline 官网:https://github.com/cline/cline

配置 Token502 API#

安装完成后,需要配置 ComfyRouter 的 API 信息才能开始使用。

第一步:打开 Cline 设置#

在 VSCode 中有多种方式打开 Cline 设置:
方式一:点击 VSCode 左侧活动栏的 Cline 图标,然后点击设置图标⚙️
Pasted image 20251024180129.png

第二步:选择 API 提供商#

1.
在 Cline 设置页面中,找到 "API Provider"(API 提供商)选项
2.
点击下拉菜单,选择 "OpenAI Compatible"
Pasted image 20251024180129.png
💡 提示:选择 OpenAI Compatible 是因为 ComfyRouter 提供了与 OpenAI API 兼容的接口格式,这样可以使用多种不同厂商的模型。

第三步:填写 Base URL#

在 "Base URL" 输入框中填写 ComfyRouter 的 API 地址:
https://api.token502.com/v1
Pasted image 20251024184532.png
⚠️ 注意:请确保 URL 末尾包含 /v1,这是 API 版本路径的一部分。

第四步:获取并填写 API Key#

1.
获取 API Key
访问 ComfyRouter 令牌页面:[Token502](https://comfyrouter.com/console/token))
登录你的账户
在令牌管理页面点击"创建新令牌"或复制现有的 API Key
Pasted image 20251024182259.png
2.
填写 API Key
回到 Cline 设置页面
在 "API Key" 输入框中粘贴刚才复制的 API Key
Pasted image 20251024182351.png
🔒 安全提示:请妥善保管你的 API Key,不要分享给他人或提交到代码仓库中。

第五步:选择模型#

在 "Model ID" 输入框中填写你想使用的模型 ID,点击Done保存设置:
Pasted image 20251024184757.png

推荐模型(2025年10月最新)#

根据不同的编程场景,ComfyRouter 提供了多种优秀的 AI 模型供你选择。以下是基于最新 SWE-bench 评测的推荐模型:

🏆 顶级编码模型(2025年最佳)#

模型 IDSWE-bench得分适用场景特点
claude-sonnet-4.572.7%世界最佳编码模型2025年9月发布,在 SWE-bench 和 OSWorld(61.4%) 基准测试中表现最佳,擅长构建复杂代理和自主编程
claude-opus-472.5%复杂软件工程项目高级推理能力,适合长时间任务和代理工作流,在 AIME 2025 数学竞赛达到90%
gpt-5领先全能型开发OpenAI 最新旗舰模型,支持可调节推理模式,适合跨领域复杂开发任务
gemini-2.5-pro63.8%大型代码库处理2百万 token 超大上下文,适合整库分析和重构,UI 设计表现优秀

⚡ 高性价比快速模型#

模型 ID适用场景特点
claude-haiku-4.5快速开发和高频调用2025年10月发布,接近 Sonnet 级别性能,价格仅 1/5,速度极快
gpt-4.1企业级代码差异100万 token 上下文,54.6% SWE-bench,成本比 GPT-4o 降低83%
gemini-2.5-flash实时应用250+ tokens/秒,0.25秒首token延迟,适合需要即时反馈的场景
qwen3-235b-a22b开源领先者CodeForces ELO 2056,在17/23基准测试中超越 DeepSeek-R1

🔬 专业推理与竞赛编程#

模型 ID适用场景特点
deepseek-v3多语言代码生成SWE-bench Verified 66.0%,JavaScript/Python 表现优异,处理速度比 R1 快47%
deepseek-r1算法竞赛CodeForces 96.3%,适合逻辑密集型任务,推理步骤优化63%
qwen3-coder-480b代码专用CodeForces 领先,SWE-bench 顶级表现,专为编程优化的480B参数模型
o4-miniSTEM任务快速经济,AIME 准确率99.5%,代码编辑准确率极高

开始使用 Cline#

配置完成后,就可以开始使用 Cline 进行 AI 辅助编程了!

基本使用流程#

1.
打开 Cline 聊天界面
点击左侧活动栏的 Cline 图标
Pasted image 20251024183114.png
2.
描述你的需求
在输入框中描述你想要完成的编程任务,例如:
帮我重构 src/utils/helper.ts 文件中的 formatDate 函数,
使其支持更多的日期格式,并添加单元测试
3.
审查和确认 Cline 的操作
Cline 会分析你的代码库,提出执行计划,并请求你的确认。它可能会:
读取相关文件
生成新代码
修改现有代码
创建测试文件
执行命令
4.
查看生成的代码
Cline 会在编辑器中直接修改代码,你可以:
查看 diff 对比
接受或拒绝更改
提出进一步的修改建议

高级功能#

多文件操作#

Cline 可以同时操作多个文件:
创建一个新的用户认证模块,包括:
1. models/User.ts 定义用户模型
2. services/AuthService.ts 实现认证逻辑
3. controllers/AuthController.ts 处理 HTTP 请求
4. tests/auth.test.ts 添加测试用例

自动执行终端命令#

Cline 可以运行终端命令来安装依赖、执行测试等:
安装 axios 库并创建一个 HTTP 客户端封装

理解上下文#

Cline 会自动分析你的项目结构和代码库,理解现有的架构模式和编码风格。

常见问题#

❓ API Key 无效或认证失败#

问题表现:提示 "Invalid API Key" 或 "Authentication failed"
解决方法:
1.
检查 API Key 是否正确复制(注意不要有多余的空格)
2.
确认 API Key 是否已激活(访问 令牌页面 查看状态)
3.
检查账户余额是否充足
4.
尝试重新生成一个新的 API Key

❓ 无法连接到 API#

问题表现:提示 "Connection timeout" 或 "Network error"
解决方法:
1.
检查 Base URL 是否正确:https://api.token502.com/v1
2.
确认网络连接正常
3.
检查防火墙或代理设置是否阻止了连接
4.
如果在国内使用,可能需要配置网络代理

❓ 模型响应慢或超时#

问题表现:等待时间过长或请求超时
解决方法:
1.
尝试切换到更快的模型,如 gemini-2.5-flash-preview 或 gpt-4.1-mini
2.
减少单次请求的上下文大小(避免一次性处理过多文件)
3.
检查账户配额是否达到限制
4.
查看 Token502 服务状态

❓ 如何切换模型#

有两种方式切换模型:
1.
在设置中切换:
打开 Cline 设置
修改 "Model" 字段为新的模型 ID
保存设置
2.
在对话中临时切换:
某些版本的 Cline 支持在聊天界面中临时选择不同的模型

❓ 代码质量不理想#

解决方法:
1.
尝试更换更强大的模型,如 claude-opus-4 或 gemini-2.5-pro-preview
2.
提供更详细、更明确的需求描述
3.
分步骤处理复杂任务,而不是一次性完成
4.
使用示例代码来说明你期望的代码风格

❓ 关于计费和配额#

Token502 按 API 调用的 token 数量计费
不同模型的价格不同,详见 定价说明
可以在 账户页面 查看使用情况和余额
建议设置用量提醒,避免超支

更多资源#

Cline GitHub:https://github.com/cline/cline
ComfyRouter 文档:https://docs.comfyrouter.com
常用大模型说明:常用大模型
API 使用指南:在 API 客户端中使用

💡 提示:建议将多个优秀模型添加到 Cline 的模型列表中,这样可以根据不同任务灵活切换,获得最佳的编程体验和性价比。
修改于 2025-11-16 15:55:06
上一页
Jina AI 重排序格式
下一页
chatbox中使用大语言模型
Built with