# Creación de un teléfono en la nube

Compra y aprovisiona uno o varios Cloud Phones.
- **Requisitos previos**: el plan debe tener capacidad restante y la cuota diaria de creación no puede estar agotada. `country`, `timezone` y `language` se validan contra la lista que admite el servicio elegido, por lo que una combinación no admitida se rechaza en lugar de ajustarse en silencio. Las coordenadas se limitan a ±180 de longitud y ±90 de latitud. El número de teléfono se descarta cuando el SKU elegido no admite uno. Los SKU mensuales se pueden crear mediante la API cuando los devuelve [`/cloudphone/monthly/skus`](./open-api.yaml#operation/listMonthlyCloudPhoneSkus); el período actual es de 30 días.
- **Efecto**: crea los registros de Cloud Phone. Los SKU de pago por minuto se pueden usar tras el aprovisionamiento; los mensuales se crean inactivos. La creación no cobra: los teléfonos mensuales solo se cobran mediante [`/cloudphone/monthly/activate`](./open-api.yaml#operation/activateMonthlyCloudPhones), y los de pago por minuto empiezan a consumir saldo o cuota al encenderse.
- **Finalización**: **aceptado, no completado.** La instancia del servicio todavía no está lista, y encenderla demasiado pronto se rechaza. Consulta [`/cloudphone/info`](./open-api.yaml#operation/infoUsingPOST) o [`/cloudphone/page`](./open-api.yaml#operation/pageUsingPOST) hasta que `envStatus` indique que el teléfono está apagado. Para un SKU mensual, completa también [`/cloudphone/monthly/activate`](./open-api.yaml#operation/activateMonthlyCloudPhones) antes de encenderlo.
- **Reintentos**: no es idempotente ni se serializa. No hay clave de idempotencia. No reintentes a ciegas tras un timeout: consulta primero el estado.

Errores de negocio documentados: `19064`, `20018`, `33338`, `33339`, `33340`, `33341`, `33342`, `33343`, `33344`, `33345`, `33398`, `33399`, `33400`, `33408`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `skuId` (string, required)
    Modelo de Cloud Phone
skuId:10002 model:Android 12
skuId:10013 model:Android 13
skuId:10005 model:Android 14
skuId:10004 model:Android 15
skuId:10014 model:Android 15A
skuId:10015 model:Android 16
Consulta la [tabla de países y zonas horarias](/api-reference/appendix/country-time-zone) para ver las regiones admitidas y la correspondencia de zonas horarias

  - `quantity` (integer, required)
    Número de Cloud Phones que se crean. Rango de valores: [1-10]

  - `envRemark` (string)
    Comentario del perfil (máximo 1500 caracteres)

  - `groupId` (string)
    ID del grupo. Usa `"0"` para sin grupo.

  - `groupName` (string)
    Nombre de un grupo existente, o el nombre de un grupo nuevo que se creará si no hay ninguno que coincida.

  - `automaticGeo` (boolean)
    Si se debe hacer coincidir automáticamente la ubicación geográfica. Por defecto: true

  - `automaticLanguage` (boolean)
    Si se debe hacer coincidir automáticamente el idioma. Por defecto: true

  - `automaticLocation` (boolean)
    Si se debe hacer coincidir automáticamente la ubicación (zona horaria, país). Por defecto: true

  - `country` (string)
    Código de país (por ejemplo `us`). Consulta la [tabla de países y zonas horarias](/api-reference/appendix/country-time-zone) para ver la lista completa

  - `timezone` (string)
    Zona horaria, por ejemplo America/New_York

  - `language` (string)
    Idioma, por ejemplo en-US

  - `altitude` (number)
    Altitud

  - `latitude` (number)
    Latitud. Ejemplo: 22.309182

  - `longitude` (number)
    Longitud. Ejemplo: 114.176817

  - `speed` (number)
    Velocidad de movimiento

  - `bearing` (number)
    Dirección del movimiento

  - `accuracy` (number)
    Precisión horizontal

  - `phoneNumber` (string)
    Número de teléfono personalizado. Requisitos de formato: debe empezar por un signo +, el código de país debe tener de 1 a 3 dígitos (sin incluir 86), la longitud total debe ser de 8 a 14 dígitos y solo puede contener + y números.

  - `brand` (string)
    Marca del dispositivo. Puedes consultarla mediante la interfaz https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `modelId` (number)
    ID del modelo de dispositivo. Puedes consultarlo mediante la interfaz https://guide.morelogin.com/api-reference/open-api/open-api/cloud-phone/paths/~1cloudphone~1brand~1models/post.

  - `proxyId` (string)
    ID del proxy

  - `tags` (array)
    Nombres de etiquetas. Los valores vacíos se ignoran.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (array)
    Este es el IDS de teléfono en la nube.

  - `requestId` (string, required)

  - `error` (object)