文档中心

Appearance

✨充值控制台

GenStudio API 快速集成 ​

先发送一次 Chat Completions 请求，确认 API Key、Base URL 和模型 ID 可用。请求跑通后，再把同一组连接参数填入常用工具或业务程序。

获取 API Key 并确认模型 ​

登录智算云平台，前往密钥管理页面申请 GenStudio API Key。后续命令只适用于 sk- 开头的 API Key。

API 密钥管理

发送请求前，先在服务列表中确认要使用的模型 ID。只验证接口是否可用时，可选择按量计费模型；如果已经购买包并发服务，请使用对应的专属模型 ID，通常以 pro- 开头。

服务列表

在终端临时保存 API Key ​

把 API Key 写入当前终端的环境变量。这样发送请求时不用把密钥写进请求正文，也能降低复制命令时泄露密钥的风险。关闭终端或打开新终端后，通常需要重新设置。

macOS、Linux、WSL 或 Git Bash ​

language-shell
export API_KEY="sk-..."

Windows PowerShell ​

language-powershell
$env:API_KEY = "sk-..."

Windows CMD ​

language-cmd
set API_KEY=sk-...

信息

以上命令只适合在本机终端中使用。不要把 API Key 写入前端代码、浏览器脚本、公开仓库、截图或工单。

发送第一条请求 ​

选择正在使用的终端，发送一次非流式 Chat Completions 请求。成功后，终端会输出 JSON 响应；先查看 choices[0].message.content，再记录 id 和 usage。

如果要验证其他模型，请把示例中的 kimi-k2.6 替换为服务列表中可用的模型 ID。

macOS、Linux、WSL 或 Git Bash ​

language-shell
curl --request POST \
  --url "https://cloud.infini-ai.com/maas/v1/chat/completions" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "model": "kimi-k2.6",
    "messages": [
      {
        "role": "user",
        "content": "用一句话介绍 GenStudio API。"
      }
    ]
  }'

Windows PowerShell ​

Windows PowerShell 中请使用 curl.exe，避免把命令解析为 PowerShell 的 curl 别名。

language-powershell
$body = @'
{
  "model": "kimi-k2.6",
  "messages": [
    {
      "role": "user",
      "content": "用一句话介绍 GenStudio API。"
    }
  ]
}
'@

curl.exe --request POST `
  --url "https://cloud.infini-ai.com/maas/v1/chat/completions" `
  --header "Authorization: Bearer $env:API_KEY" `
  --header "Content-Type: application/json" `
  --data-raw $body

Windows CMD ​

Windows CMD 中使用 %API_KEY% 读取环境变量，并用 ^ 换行。

language-cmd
curl.exe --request POST ^
  --url "https://cloud.infini-ai.com/maas/v1/chat/completions" ^
  --header "Authorization: Bearer %API_KEY%" ^
  --header "Content-Type: application/json" ^
  --data-raw "{\"model\":\"kimi-k2.6\",\"messages\":[{\"role\":\"user\",\"content\":\"用一句话介绍 GenStudio API。\"}]}"

成功响应通常包含以下字段。实际回答、Token 用量和请求 ID 会随请求变化。

language-json
{
  "id": "15b1845672c7410db3c3157ca8554dff",
  "object": "chat.completion",
  "model": "kimi-k2.6",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "GenStudio API 可通过统一接口调用平台提供的大模型能力。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}

按工具要求填写连接参数 ​

大多数工具只要求填写 Base URL、API Key 和模型 ID。优先按对应工具教程填写；只有在工具要求完整请求地址时，才在 Base URL 后追加具体路径。

  • OpenAI 兼容工具：Base URL 填写 https://cloud.infini-ai.com/maas/v1。如果工具要求 Chat Completions 完整地址，填写 https://cloud.infini-ai.com/maas/v1/chat/completions。
  • Anthropic Messages 兼容工具：Base URL 填写 https://cloud.infini-ai.com/maas。该接口主要用于 Claude Code 或依赖 Anthropic Messages 协议的工具。

配置常用工具 ​

如果要先在工具中使用模型，直接进入对应工具教程。每篇教程会说明该工具需要填写 Base URL 还是完整接口地址。

常用工具集成教程：
📖 使用 Claude Code 集成 GenStudio API
📖 使用 Cline 和 Roo Code 集成 GenStudio API
📖 使用 CherryStudio 集成 GenStudio API
📖 使用 Chatbox 集成 GenStudio API
📖 在 Page Assist 中使用 GenStudio API 服务

按任务进入 API 教程 ​

请求跑通后，保留同一组 Base URL、API Key 和模型 ID，再按任务进入下一篇教程：