# Tạo hồ sơ điện thoại đám mây

Mua và cấp phát một hoặc nhiều cloud phone.
- **Điều kiện tiên quyết**: gói phải còn dung lượng và hạn mức tạo trong ngày chưa được dùng hết. `country`, `timezone` và `language` được kiểm tra theo danh sách mà dịch vụ thiết bị đã chọn hỗ trợ, nên một tổ hợp không được hỗ trợ sẽ bị từ chối chứ không bị âm thầm điều chỉnh. Tọa độ bị giới hạn trong ±180 kinh độ và ±90 vĩ độ. Số điện thoại bị bỏ qua khi SKU đã chọn không hỗ trợ. Có thể tạo SKU theo tháng qua API khi sản phẩm được [`/api/cloudphone/monthly/skus`](./local-api.yaml#operation/listMonthlyCloudPhoneSkus) trả về; kỳ hiện tại là 30 ngày.
- **Tác động**: tạo các bản ghi cloud phone. SKU tính theo phút dùng được sau khi cấp phát; SKU theo tháng được tạo ở trạng thái chưa kích hoạt. Bước tạo không thu phí; Cloud Phone theo tháng chỉ bị tính phí khi gọi [`/api/cloudphone/monthly/activate`](./local-api.yaml#operation/activateMonthlyCloudPhones), còn loại theo phút bắt đầu dùng số dư hoặc hạn mức khi bật nguồn.
- **Hoàn tất**: **đã tiếp nhận, chưa hoàn tất.** Máy ảo phía dịch vụ thiết bị chưa sẵn sàng, và bật quá sớm sẽ bị từ chối. Hãy hỏi vòng [`/api/cloudphone/info`](./local-api.yaml#operation/infoUsingPOST) hoặc [`/api/cloudphone/page`](./local-api.yaml#operation/pageUsingPOST) cho đến khi `envStatus` báo máy đã tắt. Với SKU theo tháng, cũng phải hoàn tất [`/api/cloudphone/monthly/activate`](./local-api.yaml#operation/activateMonthlyCloudPhones) trước khi bật nguồn.
- **Thử lại**: không idempotent và không được xếp tuần tự. Không có khóa idempotency. Đừng thử lại một cách mù quáng sau khi hết thời gian chờ: hãy truy vấn trạng thái trước.

Các mã lỗi nghiệp vụ đã ghi nhận: `19064`, `20018`, `33338`, `33339`, `33340`, `33341`, `33342`, `33343`, `33344`, `33345`, `33398`, `33399`, `33400`, `33408`. 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/create
Version: 2026-09-05

## Request fields (application/json):

  - `skuId` (string, required)
    Dòng máy cloud phone
| Dòng máy cloud phone | SKU ID (`skuId`) |
|  --- | --- |
| Android 12 | `10002` |
| Android 13 | `10013` |
| Android 14 | `10005` |
| Android 15 | `10004` |
| Android 15A | `10014` |
| Android 16 | `10015` |
| Android 17 | `10105` |

Xem [bảng quốc gia và múi giờ](/api-reference/appendix/country-time-zone) để biết các khu vực được hỗ trợ và cách đối chiếu múi giờ

  - `quantity` (integer, required)
    Số lượng cloud phone được tạo. Phạm vi giá trị: [1-10]

  - `envRemark` (string)
    Ghi chú của profile (giới hạn 1500 ký tự)

  - `groupId` (string)
    ID nhóm. Dùng `"0"` cho trường hợp chưa thuộc nhóm nào.

  - `groupName` (string)
    Tên một nhóm đã có, hoặc tên nhóm mới sẽ được tạo khi không có nhóm nào khớp.

  - `automaticGeo` (boolean)
    Có tự động khớp vị trí địa lý hay không. Mặc định: true

  - `automaticLanguage` (boolean)
    Có tự động khớp ngôn ngữ hay không. Mặc định: true

  - `automaticLocation` (boolean)
    Có tự động khớp vị trí (múi giờ, quốc gia) hay không. Mặc định: true

  - `country` (string)
    Mã quốc gia (ví dụ `us`). Xem [bảng quốc gia và múi giờ](/api-reference/appendix/country-time-zone) để biết danh sách đầy đủ

  - `timezone` (string)
    Múi giờ, ví dụ America/New_York

  - `language` (string)
    Ngôn ngữ, ví dụ en-US

  - `altitude` (number)
    Độ cao

  - `latitude` (number)
    Vĩ độ. Ví dụ: 22.309182

  - `longitude` (number)
    Kinh độ. Ví dụ: 114.176817

  - `speed` (number)
    Tốc độ di chuyển

  - `bearing` (number)
    Hướng di chuyển

  - `accuracy` (number)
    Độ chính xác theo phương ngang

  - `phoneNumber` (string)
    Số điện thoại tùy chỉnh. Yêu cầu về định dạng: phải bắt đầu bằng dấu +, mã quốc gia phải có 1-3 chữ số (không bao gồm 86), tổng độ dài 8-14 chữ số, và chỉ được chứa dấu + cùng các chữ số.

  - `brand` (string)
    Thương hiệu thiết bị. Bạn có thể tra cứu qua giao diện https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `modelId` (number)
    ID dòng máy thiết bị. Bạn có thể tra cứu qua giao diện https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `proxyId` (string)
    ID proxy

  - `tags` (array)
    Tên các thẻ. Giá trị rỗng sẽ bị bỏ qua.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (array)
    Đây là hệ thống xác thực danh tính điện thoại đám mây (Cloud phone IDS).

  - `requestId` (string, required)

  - `error` (object)