胜算云文档
胜算云
胜算云
  1. 使用指南
  • 模型API
    • 快速入门
    • 更新公告
    • 使用指南
      • 账号指南
      • 开发者快速入门指南
      • ❇️ Claude Code 配置使用胜算云( Anthropic 兼容接口模式)
      • ❇️ Claude Code 桌面版IDE(免登录、超方便、全功能)
      • ❇️ Claude 桌面端免登录接入胜算云 API
      • ❇️ Codex CLI 接入胜算云API
      • ❇️ Codex 桌面版应用接入胜算云API
      • ❇️ OpenCode 接入胜算云(桌面版IDE)
      • ❇️ OpenClaw 最新版接入胜算云 API 文档
      • ❇️ Hermes Agent 最新版接入胜算云 API 文档
      • N8N-Nodes-Shengsuanyun 安装使用指南(已上线n8n社区)
      • 使用ComfyUI 调用胜算云API (暂支持同步任务节点,异步任务节点开发中)
      • VS Code插件快速入门指南
      • 胜算云AI群聊 Chrome扩展插件
      • LangBot 接入胜算云API
      • 使用Cherry Studio接入胜算云API
      • 使用LobeChat接入胜算云API
      • AI群聊快速入门指南
      • 胜算云Tokens Plan 套餐细则
    • 大厂模型-大语言
      • 错误处理
      • 常见问题
      • API 错误代码说明
      • OpenAI兼容API
        • 联网搜索
        • 模型路由
        • 工具调用
        • 聊天补全
        • 文本向量化
      • Anthropic兼容API
        • 创建消息
      • Google兼容API
        • SDK 调用
        • 内容生成 (v1)
          • 生成内容
          • 流式生成内容
        • 内容生成 (v1beta)
          • 生成内容(Beta)
          • 流式生成内容(Beta)
        • Live API
          • Google Gemini Live API
      • 获取APIKey详情
    • 大厂模型-多媒体
      • 支持的模型(逐步更新)
      • 基础接口
        • 异步任务提交
        • 查询任务状态
        • 同步图像生成
        • 同步图像编辑
        • 同步音频转录
      • 模型特有参数(进行中)
        • 通义千问
          • qwen image 特有参数
          • Wan视频生成
      • 测试API接口
        • 阿里
          • wan
            • 创建 万相 视频生成任务
          • HappyHorse-1.0
            • 创建 HappyHorse 视频生成任务
          • 阿里Paraformer
            • Paraformer-v2音频转录-异步
          • Qwen-Image
            • 千问图像生成/编辑-异步
            • 千问图像编辑-同步
        • 可灵
          • 可灵 API
          • 可灵视频生成
        • 即梦
          • 即梦生图参数详解
          • 即梦视频生成
          • 即梦生图
        • 豆包
          • 豆包视频生成参数详解
          • 豆包生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音频转录-异步
          • Image2 / 1.5 / 1 图像生成/编辑-异步
          • Image2 / 1.5 / 1 图像生成-同步
          • Image2 / 1.5 / 1 图像编辑-同步
        • 火山引擎
          • 火山引擎图片处理
        • Runway
          • 视频生成
          • 文本生成音频
          • 音效生成
        • 腾讯混元
          • 混元生3D-专业版
          • 混元生3D-极速版
          • 纹理生成
          • 智能拓扑
          • UV展开
          • 组件生成
    • GPU租赁
      • GPU租赁与选型指南
      • 容器实例
      • 数据与存储
      • 费用相关
    • 条款与协议
      • 用户协议
      • 隐私政策
      • 用户充值协议
      • 付费充值协议
      • 使用条款
      • 数据安全协议和分析
    • 数据模型
      • Schemas
        • 即梦4.0生图请求
        • Gemini 图片生成请求体-Messages
        • Sora2视频生成请求体
        • 千问文生图异步参数
        • 豆包3D生成请求体
        • HappyHorseVideoRequest
        • WanVideoRequest
        • HappyHorseInput
        • WanInput
        • HappyHorseMediaItem
        • WanMediaItem
        • HappyHorseParameters
        • WanParameters
        • 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
        • 流式响应错误事件
      • LoomLoom(AssembleFlow批处理)
        • GetTemplateFormSchemaResponse 获取官方模板表单 schema 响应
        • TemplateFormColumnSchema 模板表格列定义
        • TemplateFormFieldSchema 模板表单字段定义
        • TemplateFieldAcceptedInputKind 字段允许的输入形态
        • TemplateSampleRow 模板样例行
        • HealthCheckResponse 健康检查响应
        • UploadInputAssetResponse 通用输入资产上传响应
        • ValidateTemplateRowsResponse 校验官方模板表格行响应
        • RowValidationError 行校验错误
        • rpcStatus
        • protobufAny
        • PrecheckTemplateRowsRequest 预估官方模板表格行请求
        • TemplateDisplayRow 模板表格中的一行输入
        • manualSubmitTemplateFileResponse
        • ListTemplatesResponse 列出模板响应
        • TemplateSummary 模板摘要
        • UploadInputAssetRequest 通用输入资产上传请求 第一版使用 unary 上传,单文件大小上限为 10 MiB。
        • manualValidateTemplateFileResponse
        • manualRowValidationError
        • ListRunArtifactsResponse 产物查询响应
        • ArtifactEntry 单个产物条目
        • ValidateTemplateRowsRequest 校验官方模板表格行请求
        • SubmitTemplateRowsRequest 提交官方模板表格行请求
        • SubmitTemplateRowsResponse 提交官方模板表格行响应
        • PrecheckTemplateRowsResponse 预估官方模板表格行响应
        • TemplateBalanceCheck 模板余额检查
        • GetWorkflowRunResponse 运行状态及执行摘要。 summary 字段(total_tasks 等)在终态后由 workflow 回写;运行中时为 0。
        • ListRunTasksResponse 任务列表响应
        • RunTaskItem 单条任务摘要
      • 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
  • LoomLoom
    • LoomLoom内测接口
      • UploadInputAsset 上传通用原始输入资产(文本/图片等) 第一版使用 unary RPC,单文件大小上限 10 MiB。
      • GetWorkflowRun 查询工作流运行
      • ListRunArtifacts 按 run/task/step 查询产物列表
      • ListRunTasks 按 run 查询任务列表
      • HealthCheck 健康检查
      • ListTemplates 列出所有可用的内置模板
      • GetTemplateFormSchema 获取官方模板表单 schema
      • PrecheckTemplateRows 预估官方模板表格行成本
      • SubmitTemplateRows 提交官方模板表格行
      • ValidateTemplateRows 校验官方模板表格行
      • DownloadTemplateExcel 下载模板 Excel 文件
      • ValidateTemplateFile 校验上传的模板 Excel 文件
      • SubmitTemplateFile 提交模板 Excel 文件(校验+编译+执行)
  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-05-12 09:19:29
上一页
❇️ OpenCode 接入胜算云(桌面版IDE)
下一页
❇️ Hermes Agent 最新版接入胜算云 API 文档
Built with