# 启动云端运行环境

把浏览器环境作为云运行时启动。
- **前置条件**
：环境必须存在于你的团队，且不能是端到端加密或正在移交。
**必须绑定代理**
，且在受理启动前会检查其可达性。浏览器内核必须是云浏览器支持的，这排除了 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](/zh/api-reference/getting-started/error-codes)。任何接口还可能返回通用错误码。

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

