胜算云文档
胜算云
胜算云
  1. 使用指南
  • 快速入门
  • 更新公告
  • 胜算云Tokens Plan 套餐细则
  • 使用指南
    • 账号指南
    • 开发者快速入门指南
    • ❇️Claude Code 配置使用胜算云( Anthropic 兼容接口模式)
    • ❇️ OpenCode 接入胜算云(桌面版IDE)
    • ❇️ Claude Code / Agent 接入胜算云API
    • ❇️ CodeX 接入胜算云API
    • ❇️OpenClaw 最新版接入胜算云 API 文档
    • ❇️Hermes Agent 最新版接入胜算云 API 文档
    • N8N-Nodes-Shengsuanyun 安装使用指南(已上线n8n社区)
    • 使用ComfyUI 调用胜算云API (暂支持同步任务节点,异步任务节点开发中)
    • VS Code插件快速入门指南
    • 胜算云AI群聊 Chrome扩展插件
    • LangBot 接入胜算云API
    • 使用Cherry Studio接入胜算云API
    • 使用LobeChat接入胜算云API
    • AI群聊快速入门指南
  • 大厂模型-大语言
    • 错误处理
    • 常见问题
    • API 错误代码说明
    • OpenAI兼容API
      • 联网搜索
      • 模型路由
      • 工具调用
      • 聊天补全
        POST
      • 文本向量化
        POST
    • Anthropic兼容API
      • 创建消息
        POST
    • Google兼容API
      • SDK 调用
      • 内容生成 (v1)
        • 生成内容
        • 流式生成内容
      • 内容生成 (v1beta)
        • 生成内容(Beta)
        • 流式生成内容(Beta)
      • Live API
        • Google Gemini Live API
    • 获取APIKey详情
      GET
  • 大厂模型-多媒体
    • 支持的模型(逐步更新)
    • 基础接口
      • 异步任务提交
        POST
      • 查询任务状态
        GET
      • 同步图像生成
        POST
      • 同步图像编辑
        POST
      • 同步音频转录
        POST
    • 模型特有参数(进行中)
      • 通义千问
        • qwen image 特有参数
        • Wan视频生成
    • 测试API接口
      • 阿里Paraformer
        • Paraformer-v2音频转录-异步
      • 可灵
        • 可灵 API
        • 可灵视频生成
      • 通义千问
        • 千问图像生成/编辑-异步
        • 千问图像编辑-同步
      • 通义万相
        • Wan 图生视频(i2v)
      • 即梦
        • 即梦生图参数详解
        • 即梦视频生成
        • 即梦生图
      • 豆包
        • 豆包视频生成参数详解
        • 豆包生3D
        • 豆包生视频-异步
        • 豆包生图-异步
        • 豆包生图-同步
        • 豆包视频2.0
      • Google
        • Veo3视频生成
        • 🍌1 / 🍌 pro 图像生成-异步
        • 🍌1 / 🍌 pro 图像生成-同步
        • 🍌 1 图像生成-Chat接口
      • Minimax
        • 视频生成 API
        • Minimax视频生成
      • Vidu
        • 视频生成 API
        • Vidu视频生成
      • OpenAI
        • Sora 视频生成 API
        • Image1 图像生成
        • sora2视频生成
        • sora视频生成
        • Whisper1音频转录-同步
        • Whisper1音频转录-异步
        • Image1.5 / 1 图像生成/编辑-异步
        • Image1.5 / 1 图像生成-同步
        • Image1.5 / 1 图像编辑-同步
      • 火山引擎
        • 火山引擎图片处理
      • Runway
        • 视频生成
        • 文本生成音频
        • 音效生成
      • 腾讯混元
        • 混元生3D-专业版
        • 混元生3D-极速版
        • 纹理生成
        • 智能拓扑
        • UV展开
        • 组件生成
  • GPU租赁
    • GPU租赁与选型指南
    • 容器实例
    • 数据与存储
    • 费用相关
  • 条款与协议
    • 用户协议
    • 隐私政策
    • 用户充值协议
    • 付费充值协议
    • 使用条款
    • 数据安全协议和分析
  • 数据模型
    • Schemas
      • 即梦4.0生图请求
      • Gemini 图片生成请求体-Messages
      • Sora2视频生成请求体
      • 千问文生图异步参数
      • 豆包3D生成请求体
      • RunwayTaskGenerationRequest
      • Runway视频生成请求体
      • 阿里音频转录请求体
      • Whispher 音频转录请求体
      • 即梦文生图请求
      • OpenAI-Chat 请求体
      • OpenAI图像生成参数
      • 可灵视频生成请求体
      • 豆包视频生成请求体
      • Whispher 音频转录 响应- json
      • OpenAI-Chat 请求体-Message
      • Minimax视频生成请求体
      • Gemini 图片生成请求体-常规
      • 即梦视频生成请求体
      • OpenAI-Chat 请求体- StreamOptions
      • Sora1视频生成请求体
      • OpenAI-Chat 请求体-Function
      • 千问图生图同步参数
      • 豆包图片生成请求体
      • OpenAI-Chat 请求体-ToolCall
      • Vidu视频生成请求体
      • 即梦图生图请求
      • OpenAI-Chat 请求体-ResponseFormat
      • Openai 图像生成响应
      • OpenAI-Chat 请求体- FormatJsonSchema
      • OpenAI Chat 响应体
      • 千问图像编辑响应
      • Whispher 音频转录 响应- text
      • 豆包图片生成响应
      • 异步任务响应
      • OpenAI Embedding 响应
      • OpenAI Chat响应体-Choice
      • OpenAI Chat 响应- Usage
      • 任务信息
      • OpenAI Embedding 响应- Item
      • 千问图像编辑响应-Choice
      • 错误响应
      • 千问图像编辑响应-Message
      • Veo视频生成请求体
      • 千问图像编辑响应-Content
      • 图片生成成功事件
      • 千问图像编辑响应-Usage
      • 异步Task响应
      • 图片生成失败事件
      • 异步Task响应Data
      • 图像生成完成事件
      • 异步Task响应Result
      • 流式响应错误事件
    • Runway音效生成请求体
    • Wan图生视频请求体
    • 异步Task响应
    • Gemini Chat 请求体
    • 腾讯3D生成请求体
    • MediaURL
    • Claude 请求体
    • Runway TextToSpeech 请求体
    • 3D专业版请求体
    • Wan异步Task响应
    • 异步Task响应Data
    • Gemini Chat 请求体-Content
    • 多视角图片
    • DraftTaskRef
    • Claude 请求体-Message
    • 3D极速版请求体
    • Wan异步Task响应Data
    • Gemini Chat 请求体-Part
    • 异步Task响应
    • Tool
    • Claude 响应 - messages
    • 纹理生成请求体
    • Gemini Chat 请求体-InlineData
    • 异步Task响应Data
    • ContentItem
    • Claude 响应 - MessageSource
    • 智能拓扑请求体
    • Gemini Chat 请求体-FileData
    • 异步Task响应Result
    • OfficialSeedanceRequest
    • Claude 请求体-Tool
    • UV展开请求体
    • Gemini Chat 请求体-FunctionCall
    • LegacyImageListItem
    • Claude 请求体-Thinking
    • 组件生成请求体
    • Gemini Chat 请求体-FunctionResponse
    • LegacyMediaListItem
    • Claude 响应
    • 多视角图片
    • Gemini Chat 请求体-PartExecutableCode
    • LegacySeedanceRequest
    • Claude 响应-Usage
    • File3D对象
    • Gemini Chat 请求体-PartCodeExecutionResult
    • CreateTaskResponse
    • ClaudeError
    • Image对象
    • Gemini Chat 请求体-ChatGenerationConfig
    • TaskUsage
    • InputFile3D对象
    • Gemini Chat 请求体-ThinkingConfig
    • TaskQueryResponse
    • 异步Task响应
    • Gemini Chat 请求体-ChatSafetySettings
    • 异步Task响应Data
    • Gemini Chat 请求体-ChatTool
    • 异步Task响应Result
    • Gemini Chat 请求体-Config
    • Gemini Chat 请求体-FunctionCallingConfig
    • Gemini Chat 响应
    • Gemini Chat 响应-Candidate
    • Gemini Chat 响应-SafetyRating
    • Gemini Chat 响应-PromptFeedback
    • Gemini Chat 响应-UsageMetadata
    • GeminiError
  1. 使用指南

❇️OpenClaw 最新版接入胜算云 API 文档

文档版本:2026 年 4 月(基于 OpenClaw 最新版 openclaw@latest)
适用对象:OpenClaw 最新版用户(Node.js 22+ / 24 推荐)
胜算云特性:提供统一的 OpenAI 兼容接口(https://router.shengsuanyun.com/api/v1),一个 Key 可调用数百种模型,支持 Chat Completions 协议。

1. 前置准备#

1.
安装最新版 OpenClaw
验证:openclaw --version
2.
获取胜算云 API Key
访问 胜算云官网 注册/登录 → 控制台生成 API Key(格式通常为 sk-...)。
3.
确认 Node.js 环境

2. 初始界面引导配置(推荐新手:openclaw onboard)#

OpenClaw 最新版提供交互式向导,一键完成模型、渠道、Gateway 配置。
1.
运行命令:
2.
向导步骤(中文界面会更友好):
安全警告:阅读后输入 Yes 继续。
配置模式:推荐选择 QuickStart(快速开始)。
模型提供商选择:
若出现 “胜算云 (国产模型)” 或 “Shengsuanyun” 选项,直接选择(最新中文版已内置预设)。
若无预设,选择 Custom Provider → OpenAI Compatible。
填写胜算云参数(向导会提示):
Base URL:https://router.shengsuanyun.com/api/v1
API Key:粘贴你的胜算云 Key
Model ID:输入平台支持的模型 ID(示例:gpt-4o、deepseek-chat、qwen-max 等,具体以胜算云控制台模型列表为准)
默认 Agent 模型:选择刚配置的 shengsuanyun/模型ID。
渠道配置(可选):Telegram、飞书、Discord、WhatsApp 等,按提示输入 Token。
完成:向导自动生成 ~/.openclaw/openclaw.json 并验证连接。
3.
启动验证:
提示:向导结束后已可直接使用。若想后续修改,继续第 3 节。

3. 使用 openclaw config 打开配置面板修改(进阶/二次配置)#

向导完成后,可随时通过以下方式打开配置面板进行修改:

方式一:交互式配置面板(推荐)#

进入可视化/命令行交互面板。
选择对应模块(Models → Providers → shengsuanyun)。
修改 Base URL、API Key、默认模型等。
保存后自动校验配置。

方式二:CLI 快捷命令(快速修改)#

方式三:直接编辑配置文件(最灵活)#

配置文件路径:~/.openclaw/openclaw.json(推荐备份后再编辑)。
完整示例配置片段(合并到现有 JSON):
{
  "models": {
    "mode": "merge",
    "providers": {
      "shengsuanyun": {
        "baseUrl": "https://router.shengsuanyun.com/api/v1",
        "apiKey": "sk-你的胜算云API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "胜算云-GPT-4o",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 4096
          },
          {
            "id": "deepseek-chat",
            "name": "胜算云-DeepSeek",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000
          }
          // 可继续添加平台其他模型
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "shengsuanyun/gpt-4o"
      },
      "models": {
        "shengsuanyun/gpt-4o": {
          "alias": "胜算云主模型"
        }
      }
    }
  }
}
修改后生效:

4. 测试与验证#

1.
打开仪表板:openclaw dashboard
2.
在任意已配置渠道(Telegram/飞书等)发送消息测试。
3.
CLI 测试:
4.
查看日志:

5. 常见问题与注意事项#

Base URL 必须带 /v1:胜算云正确地址为 https://router.shengsuanyun.com/api/v1。
模型 ID:请以胜算云控制台实际模型列表为准(支持 OpenAI 格式的模型均可)。
中文版优势:推荐使用 @qingchencloud/openclaw-zh@latest,onboard 向导已内置“胜算云”预设。
多 Provider 并存:mode: "merge" 可同时保留官方模型和胜算云。
更新 OpenClaw:npm update -g openclaw@latest 后重新运行 openclaw onboard 或 openclaw config 即可。
安全建议:生产环境建议使用 gateway.auth.mode: "token" 并限制访问来源。
配置完成后,你即可通过胜算云的高性价比模型在 OpenClaw 中实现稳定、快速的 AI 智能体体验。如遇问题,可运行 openclaw doctor 进行诊断。
祝使用愉快!如需更多 Skill 或多 Agent 配置,可在 OpenClaw Dashboard 中继续探索。
修改于 2026-04-17 09:31:55
上一页
❇️ CodeX 接入胜算云API
下一页
❇️Hermes Agent 最新版接入胜算云 API 文档
Built with