Empieza
Tu primer dispositivo
De una cuenta nueva a un teléfono que controlas desde un script, en cinco pasos.
Cinco pasos
Crea una cuenta
Regístrate con tu correo, Google o GitHub. El plan Gratis es una prueba de 30 minutos en un Pixel 7, 7a u 8 con Android 14, sin tarjeta.
Elige un plan o recarga saldo
En el panel, abre la tarjeta de la cuenta al final del menú y elige Ver todos los planes, o recarga saldo en Ajustes → Facturación para pagar por minuto según el uso. El plan define cuántos teléfonos funcionan a la vez e incluye minutos de teléfono. Consulta Planes y facturación.
Crea una clave de API
Abre Ajustes → Conexiones → Claves de API y crea una clave. Se muestra una sola vez.
Crea un dispositivo
Consulta la lista de modelos y crea un teléfono del que necesites.
Espera a que esté encendido
El teléfono aparece como
startingy pasa arunningen aproximadamente un minuto.
Crear un dispositivo
export CLOUSD_KEY=cl_live_your_key # 1. the models you can create curl https://api.clousd.com/v1/models -H "Authorization: Bearer $CLOUSD_KEY" # 2. create a phone of one model curl -X POST https://api.clousd.com/v1/devices \ -H "Authorization: Bearer $CLOUSD_KEY" \ -H "Idempotency-Key: first-device-001" \ -d '{"profile":"MODEL_ID"}' # → 202 {"ok": true, "name": "c3f9a41d2", "state": "starting", "poll": "/v1/devices/c3f9a41d2"} # 3. poll until it is running curl https://api.clousd.com/v1/devices/c3f9a41d2 -H "Authorization: Bearer $CLOUSD_KEY"
En el panel
Abre Dispositivos → Nuevo dispositivo, elige una versión de Android (de 12 a 17) y pulsa Crear; el modelo se asigna automáticamente. Con la API eliges tú el modelo. El teléfono muestra Iniciando y está listo en aproximadamente un minuto. Ábrelo para ver su pantalla en vivo y controlarlo con el mouse y el teclado.
Si la creación falla
| Respuesta | Qué significa |
|---|---|
| 402 no_plan | El plan de la cuenta no está pagado. Actualiza la tarjeta en Ajustes → Facturación. |
| 402 insufficient_funds | El pago por minuto necesita saldo. Recarga en Ajustes → Facturación o elige un plan. |
| 409 plan_full | Todos los teléfonos del plan están en uso. Detén o elimina un teléfono, o agrega teléfonos al plan. |
| 400 bad_request | Falta profile en el cuerpo o el id del modelo no existe. Revisa GET /v1/models. |