3 分钟上手胜算云

获取 API Key

API Key 是用于身份验证和计费的调用凭证。创建一次后，可以同时用于 AI 工具和 API 调用。

1. 登录胜算云 打开 胜算云控制台，使用手机号或微信扫码登录。
2. 创建 API Key 进入「API 密钥」页面，点击创建，并复制保存生成的 Key。
3. 确认账户余额 模型按实际使用量计费。开始使用前，请确认账户中有可用余额。

路径 B：在 AI 工具中使用

胜算云支持多种 AI 编程工具、桌面客户端、Agent 和自动化平台。所有工具的接入说明参考下列对应工具，你可以在那里查找对应配置指南。

第 1 步：进入 AI 工具接入中心

第 2 步：按照对应指南完成配置

不同工具的配置入口和字段名称可能不同。打开对应指南后，按以下顺序操作即可：

1. 填写 API Key 将准备好的胜算云 API Key 粘贴到工具的服务商或凭据设置中。
2. 选择模型并保存 支持 Web to Agent 的工具可一键写入；其他工具请按指南填写 Base URL、模型 ID 或服务商类型。
3. 重启并测试 完全退出工具后重新打开，发送一条简单消息，确认模型能够正常回复。

没有找到你使用的工具？如果它支持 OpenAI 兼容接口，可以参考 路径 A，填写胜算云的 API Key、Base URL 和模型 ID。

路径 A：在代码中调用 API

适合希望在网站、应用、脚本或后端服务中使用 AI 模型的用户。本次调用以 OpenAI SDK 为例，如果你的项目已经使用 OpenAI SDK，通常只需替换 API Key、Base URL 和模型 ID。详情请见OpenAI 兼容 API。

第 1 步：填写 API 地址

请按上表填写，不要遗漏 Base URL 中的 /api/v1。如果你选择的是 Anthropic SDK，Base URL 中无需 /v1，接口协议填写 Messages，详情请见Anthropic 兼容 API。

第 2 步：检查 API Key 是否可用

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

如果返回模型列表，说明 API Key 和访问地址均可正常使用。请从返回结果中复制你要使用的模型 ID。

第 3 步：发送第一次请求

下面以 deepseek/deepseek-v4-flash 为例。若该模型暂时不可用，请替换为上一步模型列表中的其他模型 ID。

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": "请用一句话介绍你自己。"
      }
    ]
  }'

# 安装：pip install openai
from openai import OpenAI

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

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

print(response.choices.message.content)

// 安装：npm install openai
import OpenAI from "openai";

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

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

console.log(response.choices.message.content);

需要查看完整参数或更多语言示例，请前往 OpenAI 兼容 API。如需使用 Anthropic 或 Google 原生格式，请查看 Anthropic 兼容 API 或 Google（Gemini）兼容 API。

调用没有成功？

先不用修改整段代码。大多数首次调用问题都可以通过检查 API Key、账户余额、接口地址、模型 ID 和请求格式解决。

完成后，继续探索

跑通第一条路径后，你还可以继续使用多媒体生成、不同接口格式和批量工作流。