# 启动云端运行环境

把浏览器环境作为云运行时启动。
- **前置条件**：环境必须存在于你的团队，且不能是端到端加密或正在移交。**必须绑定代理**，且在受理启动前会检查其可达性。浏览器内核必须是云浏览器支持的，这排除了 Firefox。会校验团队的打开数量上限；在启用云浏览器计费的部署上还会检查 AI 额度余额。
- **每个环境一个运行**：一名成员对同一环境只能持有一个活跃运行。团队启用安全锁时，其他成员的运行会阻塞你的启动。
- **完成信号**：**已受理，未完成。** `data` 为空；运行时是异步开通的。轮询 `/cloudbrowser/page` 直到 `cloudBrowserStatus` 为 `RUNNING`，再调用 `/cloudbrowser/connect` 获取 `cdpUrl`。启动可能已被受理但随后失败，这会在该页面上体现。
- **并发**：同一环境的并发启动由锁串行化；竞争失败的一方被拒绝，而不是排队。
- **重试**：超时后请读取 `/cloudbrowser/page`——不要重发。

已记录的业务错误码：`19039`, `19065`, `40001`, `40003`, `40015`, `40016`, `40021`, `40023`, `40024`, `40025`, `40026`, `40027`, `40028`, `40029`, `40037`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /api/cloudbrowser/start
Version: 2026-09-05

## Request fields (application/json):

  - `envId` (string, required)
    Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript
precision loss on 64-bit integers.
    Example: 1800000000000001

## Response 200:

  - `200` (unknown)
    Success

## Response 200 fields (application/json):

  - `code` (integer, required)
    Return result code. `0` means success; other codes indicate exceptions.
    Example: 0

  - `msg` (string | null, required)
    Error message. Usually `null` on success.
    Example: null

  - `requestId` (string)
    Operation request ID. This field may be present when the request passes through the API gateway.
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (null)
    Example: null