Start Cloud Phone

Fresh

Batch start cloud phones.

URL: https://openapi.geelark.com/open/v1/phone/startMethod: POST

Request Parameters

Parameter	Required	Type	Description	Example
ids	Yes	array[string]	Cloud phone IDs (max 200)	["123456ABCDEF"]
width	No	int	Display width in px (200-600)	336 (default)
center	No	int	Center display: 0=no, 1=yes	1 (default)
energySavingMode	No	integer	Auto-shutdown after 30min idle: 0=off, 1=on	0 (default)
materialTagIds	No	array[string]	Material tag IDs for library filter (max 10, OEM only)

Request Example

{
  "ids": ["123456ABCDEF", "789012GHIJKL"]
}

Response Example

{
  "code": 0,
  "msg": "success",
  "traceId": "12345678ABCDEF",
  "data": {
    "totalAmount": 3,
    "successAmount": 1,
    "failAmount": 2,
    "failDetails": [
      {
        "code": 43004,
        "id": "12345678ABCDEFG",
        "msg": "env is expired"
      }
    ],
    "successDetails": [
      {
        "id": "12345678ABCDEFG",
        "url": "https://speedup.geelark.com/phone-api",
        "chargingMethod": "Per-minute usage"
      }
    ]
  }
}

Response Fields

Field	Type	Description
totalAmount	integer	Total requested
successAmount	integer	Successfully started
failAmount	integer	Failed to start
successDetails[].id	string	Cloud phone ID
successDetails[].url	string	Remote access URL (open in browser)
successDetails[].chargingMethod	string	Billing type
failDetails[].code	integer	Error code
failDetails[].id	string	Failed cloud phone ID
failDetails[].msg	string	Error message

Error Codes

Code	Description
42001	Cloud phone does not exist
43004	Cloud phone has expired
47004	Associated device does not exist
43007	Cloud phone in use by another user
45002	Proxy is unavailable
47002	Insufficient cloud phone resources
43020	Cloud phone currently unavailable
43029	Cloud phone model under maintenance