# 一键新机

原地更换云手机的设备标识（一键新机）。
- **前置条件**：云手机必须已开机且未被其他成员占用。传入的品牌与机型必须是该云手机 SKU 支持的。**本操作会消耗当日云手机创建配额**，与 `/cloudphone/create` 用的是同一个配额。
- **副作用**：向设备下发新的品牌与机型、清空该机的已安装应用记录、重置手机号、并中止正在运行的 AI 任务。具体重新生成的标识范围取决于设备类型。
- **完成信号**：**已受理，未完成。** 云手机进入一键新机状态；请轮询 `/cloudphone/info` 直到它离开该状态。
- **并发**：进行期间，开机、关机以及所有需要云手机运行的命令都会被拒绝。并发的第二次调用会被拒绝而不是排队。

已记录的业务错误码：`33300`, `33301`, `33326`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /cloudphone/newMachine
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string)
    云手机ID

  - `brand` (string)
    品牌

  - `modelId` (integer)
    型号 ID

## Response 200:

  - `200` (unknown)
    成功

## Response 200 fields (application/json):

  - `code` (integer, required)
    响应代码：0 表示成功，大于 0 表示失败

  - `msg` (string | null, required)

  - `requestId` (string)
    请求唯一标识；联系支持时请提供