3 分钟上手胜算云

不管你是非技术用户、编程工具玩家，还是直接调 API 的开发者——先花 30 秒拿到 Key，再选下面最贴近你的路径，3 分钟内跑通第一次使用。

第 0 步：30 秒拿到 API Key（所有路径共同前置）

1. 访问 胜算云控制台，手机号或微信扫码注册登录。
2. 进入「API 密钥」模块，创建并复制你的专属 Key。
3. 在控制台完成充值，即可开始调用。

选择你的 3 分钟路径

路径 A · 不写代码：AI 群聊体验多模型

适合产品经理、运营、内容创作者。无需任何配置，登录即用。

1. 打开 胜算云 AI 群聊，登录账号。
2. 点右上角「添加模型」，勾选你想对比的模型（如 ChatGPT、Claude、DeepSeek）。
3. 在底部输入框提问，多个模型的回答分组展示，直接对比风格与质量。

路径 B · 编程工具用户：Web to Agent 一键接入（30 秒）

适合在 Claude Code、Codex、Cline、OpenCode 里直接调用模型的开发者。无需手动编辑配置文件。

1. 打开对应工具的配置指南页（如 Claude Code / Codex CLI / OpenCode），找到页面里的 Web to Agent 组件。
2. 输入胜算云 Key（旁边有「🗝 控制台获取 Key」链接），组件自动拉取全部可用模型。
3. 授权配置目录后点「一键写入」，组件自动备份原文件并写入配置。回到工具里即可直接使用模型。

路径 C · 开发者：直接调 LLM API

适合在自己的代码/服务里调用大语言模型。一个 Key、一个 Base URL，切换模型只改 model 字段。

1) 先验证 Key 是否可用

curl https://router.shengsuanyun.com/api/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

返回模型列表 JSON，说明 Key 和入口都正常。

2) 发出第一条对话请求

curl https://router.shengsuanyun.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [
      { "role": "user", "content": "请用一句话介绍你自己。" }
    ]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://router.shengsuanyun.com/api/v1"
)

resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash",
    messages=[{"role": "user", "content": "请用一句话介绍你自己。"}]
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://router.shengsuanyun.com/api/v1"
});

const resp = await client.chat.completions.create({
  model: "deepseek/deepseek-v4-flash",
  messages: [{ role: "user", content: "请用一句话介绍你自己。" }]
});
console.log(resp.choices[0].message.content);

返回 choices.message.content，第一次调用就成功了。已在用 OpenAI SDK 的，只改 api_key 和 base_url 两行即可迁移。

路径 D · 多媒体创作：3 分钟生成第一张图

图像 / 视频 / 音频 / 3D 走异步任务接口：提交任务拿 request_id → 轮询拿产物 URL。下面以文生图为例。

1) 提交任务

curl -X POST https://router.shengsuanyun.com/api/v1/tasks/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "一只戴眼镜的橘猫坐在书堆上读书，暖光，胶片质感"
  }'

返回 request_id，把它记下来。

2) 轮询结果

curl https://router.shengsuanyun.com/api/v1/tasks/generations/YOUR_REQUEST_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

任务完成后，响应里的 image_urls（视频为 video_urls、音频为 audio_urls）就是产物地址，直接下载即可。

路径 E · 批量与工作流：LoomLoom 引擎

适合批量内容生成、多模型协同、复杂 Agent 编排等需要可追踪交付的场景。LoomLoom 把工作流编译为可执行产物，支持 DAG 编排、FanOut 并行、中间结果缓存、逐步计量。

1. 在 LoomLoom 开发者指南 了解概念与提交方式。
2. 按 LoomLoom 使用手册 编排并提交你的第一条工作流。

第一次调用失败？先看这里

大部分首调失败都不是代码问题，而是 Key、URL、模型名或请求格式问题。