Skip to content

快速开始 ​

从登录到第一次调用模型、开第一个沙盒。

开始之前

你需要一个 Yi Labs 账号。第一次登录时就会建好你在 Yi Cloud 的工作区。

1. 登录 ​

  1. 打开控制台 https://cloud.theyilabs.com,点登录按钮。
  2. 用你的 Yi Labs 账号登录。

进来后是「概览」页,显示你的可用余额、已预扣的金额和本月用量。见工作区与登录。

2. 拿到额度 ​

模型调用和资源的费用从你 Yi Labs 账号里的付费额度扣。请在 Yi Labs 账号里充值或选一个付费套餐:https://account.theyilabs.com/billing。免费额度不能用在 Yi Cloud。

「账单」页显示你的 Yi Labs 钱包里 Yi Cloud 能用的钱。使用 Yi Cloud 时,钱会一小笔一小笔地从那里转到你的工作区。见计费与回执。

3. 创建 API Key ​

  1. 点左栏的「模型 API」,再点「管理 API Key」。
  2. 在「项目」下填一个项目名称,点「新建项目」。
  3. 在「新建 key」下选这个项目,「用途」勾上「模型 API」和「沙盒」。限额可以不填。点「创建」。
  4. 复制 key。它只显示这一次。

把 key 放进环境变量,不要写在代码里:

sh
export YI_CLOUD_API_KEY='pwc_live_…'

详见 API Key 与限额。

4. 调用模型 ​

模型目录列出了能调用的模型,不需要 key:

sh
curl https://cloud.theyilabs.com/v1/catalog

用 curl 调用一个对话模型:

sh
curl https://cloud.theyilabs.com/v1/chat/completions \
  -H "Authorization: Bearer $YI_CLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-4-argon","messages":[{"role":"user","content":"Hello"}],"max_tokens":128}'

也可以用 Python 版的 OpenAI SDK,只需要换 base URL 和 key:

python
import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["YI_CLOUD_API_KEY"], base_url="https://cloud.theyilabs.com/v1")
response = client.chat.completions.create(
    model="gemini-4-argon",
    messages=[{"role": "user", "content": "Hello"}],
    max_completion_tokens=128,
)
print(response.choices[0].message.content)

这次调用会出现在「模型 API」页的「最近请求」里,带着费用。设一个输出上限,调用的预扣就小。见模型 API。

5. 开一个沙盒 ​

先请求 GET https://cloud.theyilabs.com/v1/compute/classes,从 classes 中选择可用规格。列表为空时,算力暂不可创建,请先使用模型 API。以下创建示例需要可用规格和足够的可用余额。

key 的「用途」里要有「沙盒」。规格和每小时价格在 GET https://cloud.theyilabs.com/v1/compute/classes 里。

创建一个最多运行 10 分钟的沙盒。规格用列表里的某个 id,这里用 small。创建时要带 Idempotency-Key,先存进变量,重试时才能发同一个:

sh
RETRY_KEY=$(uuidgen)
curl https://cloud.theyilabs.com/v1/sandboxes \
  -H "Authorization: Bearer $YI_CLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $RETRY_KEY" \
  -d '{"class":"small","timeout_s":600}'

返回的是新沙盒,id 以 sb_ 开头,"state": "requested"。反复查询,直到 state 变成 ready:

sh
SANDBOX=sb_…   # 返回结果里的 id
curl https://cloud.theyilabs.com/v1/sandboxes/$SANDBOX -H "Authorization: Bearer $YI_CLOUD_API_KEY"

执行一条命令:

sh
curl https://cloud.theyilabs.com/v1/sandboxes/$SANDBOX/exec \
  -H "Authorization: Bearer $YI_CLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cmd":"uname -a && pwd","timeout_s":30}'

返回里有 stdout、stderr 和 exit_code。用完删掉:

sh
curl -X DELETE https://cloud.theyilabs.com/v1/sandboxes/$SANDBOX \
  -H "Authorization: Bearer $YI_CLOUD_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

沙盒从可用开始按秒计费,到删除为止,最低 60 秒。忘了删也没关系:10 分钟到了会自动删除,连续 5 分钟没有命令或文件操作也会删除。

下一步 ​

  • 模型 API:流式输出、向量、Anthropic Messages、自动切换和各项限制。
  • Codex 与 Claude Code:让编程 agent 用 Yi Cloud 的模型。
  • 沙盒:传文件、流式命令输出、运行时长和空闲回收。
  • 云主机:SSH 登录、租期和停机。
  • 常见问题:每个错误码是什么意思。