# Điện thoại đám mây mới chỉ với một cú nhấp chuột

Thay thế danh tính thiết bị của cloud phone ngay tại chỗ (đổi thiết bị một cú nhấp).
- **Điều kiện tiên quyết**: cloud phone phải đang bật và không bị thành viên khác chiếm giữ. Nếu bạn cung cấp thương hiệu và dòng máy, chúng phải nằm trong danh sách mà SKU của máy hỗ trợ. **Tác vụ này tiêu tốn hạn mức tạo cloud phone trong ngày** — cùng hạn mức mà `/cloudphone/create` sử dụng.
- **Tác động**: đẩy thương hiệu và dòng máy mới xuống thiết bị, xóa các bản ghi ứng dụng đã cài của máy đó, đặt lại số điện thoại của nó, và hủy mọi tác vụ AI đang chạy. MoreLogin không quy định chính xác tập định danh nào sẽ được dịch vụ thiết bị tạo lại.
- **Hoàn tất**: **đã tiếp nhận, chưa hoàn tất.** Cloud phone chuyển sang trạng thái đang đổi thiết bị một cú nhấp; hãy hỏi vòng `/cloudphone/info` cho đến khi nó rời khỏi trạng thái đó.
- **Đồng thời**: trong lúc tác vụ chạy, lệnh bật, lệnh tắt và mọi lệnh cần máy đang chạy đều bị từ chối. Một lệnh gọi thứ hai đồng thời sẽ bị từ chối thay vì xếp hàng đợi.

Các mã lỗi nghiệp vụ đã ghi nhận: `33300`, `33301`, `33326`. Xem [Error Codes](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Endpoint: POST /api/cloudphone/newMachine
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string)
    ID điện thoại đám mây

  - `brand` (string)
    Thương hiệu

  - `modelId` (integer)
    Mã số mẫu

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã phản hồi: 0 biểu thị thành công, >0 biểu thị thất bại

  - `msg` (string | null, required)

  - `requestId` (string)
    Định danh yêu cầu duy nhất; hãy cung cấp khi liên hệ hỗ trợ