Comece
Seu primeiro aparelho
De uma conta nova a um celular controlado por script, em cinco passos.
Cinco passos
Crie uma conta
Cadastre-se com e-mail, Google ou GitHub. O plano Grátis é um teste de 30 minutos em um Pixel 7, 7a ou 8 com Android 14, sem cartão.
Escolha um plano ou adicione saldo
No painel, abra o cartão da conta no fim do menu e escolha Ver todos os planos, ou adicione saldo em Configurações → Cobrança para pagar por minuto conforme o uso. O plano define quantos celulares ficam ligados ao mesmo tempo e inclui minutos de telefone. Veja Planos e cobrança.
Crie uma chave de API
Abra Configurações → Conexões → Chaves de API e crie uma chave. Ela aparece uma única vez.
Crie um aparelho
Liste os modelos e crie um celular do modelo que você precisa.
Espere ele ligar
O celular aparece como
startinge passa arunningem cerca de um minuto.
Criar um aparelho
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"
No painel
Abra Aparelhos → Novo aparelho, escolha uma versão do Android (de 12 a 17) e clique em Criar; o modelo é escolhido para você. Pela API, você escolhe o modelo. O celular mostra Iniciando e fica pronto em cerca de um minuto. Abra-o para ver a tela ao vivo e controlá-lo com o mouse e o teclado.
Se a criação falhar
| Resposta | O que significa |
|---|---|
| 402 no_plan | O plano da conta não está pago. Atualize o cartão em Configurações → Cobrança. |
| 402 insufficient_funds | O pagamento por minuto precisa de saldo. Adicione saldo em Configurações → Cobrança ou escolha um plano. |
| 409 plan_full | Todos os celulares do plano estão em uso. Pare ou exclua um celular, ou adicione celulares ao plano. |
| 400 bad_request | Falta profile no corpo, ou o id do modelo não existe. Confira GET /v1/models. |