API 文档

最近更新时间:2025-09-03 14:10:22

我的收藏

概述

腾讯云手机(Cloud Virtual Phone,CVP)​​ ,提供安全、稳定、流畅的云手机服务。基于 ARM 服务器与虚拟化技术,满足多种接入方式,支持各类终端访问,可覆盖云游戏、云办公、AI 智能体等多元化场景。​​
本章节介绍的腾讯云手机 API 接口均为 API 3.0 接口。您可以调用 API 对云手机进行操作,例如创建安卓实例、创建安卓应用或上传文件到安卓实例。
云手机支持的相关接口信息,请参见下文说明。

术语表

腾讯云手机 API 接口的常见术语请参见下表:
术语
描述
APPID
开发者访问 COS 服务时拥有的用户维度唯一资源标识,用以标识资源,可在 API 密钥管理 页面获取。
SecretId
开发者拥有的项目身份识别 ID,用于身份认证,可在 API 密钥管理 页面获取。
SecretKey
开发者拥有的项目身份密钥,可在 API 密钥管理 页面获取。
AndroidInstances
云手机实例,指在云端运行的独立虚拟手机环境,包含完整的安卓操作系统及基础应用。用户可通过网络远程操控实例,实现应用运行、数据存储等功能,每个实例拥有独立计算资源与存储空间。
AndroidInstanceImage
云手机镜像,指云手机实例的操作系统模板,包含预装软件及系统配置。用户可通过镜像批量创建环境一致的云手机实例,显著提升部署效率,支持自定义镜像备份与迁移。
AndroidInstanceApp
云手机应用,指运行于云手机实例中的安卓应用程序(APK),用户可通过云端调度实现应用的安装、卸载。应用数据存储在云端,无需本地设备支持。

相关接口

注意:
以下给出的接口频率限制维度为 API + 接入地域 + 子账号,有关限频更多说明参考:API 频率限制说明

实例相关接口

接口名称
接口功能
频率限制(次/秒)
创建安卓实例访问 Token。
20
续期安卓实例访问 Token。
20
查询安卓实例。
20
在安卓实例上异步执行命令。
20
在安卓实例上同步执行命令。
20
创建安卓实例。
20
安卓实例截图。
20
销毁安卓实例。
20
批量修改安卓实例的用户 ID。
20
重启安卓实例。
20
重置安卓实例。
20
开机安卓实例。
20
关机安卓实例。
20
连接安卓实例。
20
修改安卓实例信息。
20
批量修改安卓实例属性。
20
修改安卓实例分辨率。
20
批量修改安卓实例分辨率。
20
批量修改安卓实例信息。
20
批量修改安卓实例资源限制。
20

镜像相关接口

接口名称
接口功能
频率限制(次/秒)
创建安卓实例镜像。
20
导入安卓实例镜像。
20
删除安卓实例镜像。
20
查询安卓实例镜像列表。
20
同步安卓实例镜像。
20

应用相关接口

接口名称
接口功能
频率限制(次/秒)
批量查询安装指定应用的安卓实例。
20
查询安卓实例应用黑名单。
20
安装安卓实例应用。
20
通过 URL 安装安卓实例应用。
20
修改安卓实例应用黑名单。
20
重启安卓实例应用。
20
启动安卓实例应用。
20
停止安卓实例应用。
20
卸载安卓实例应用。
20
查询安卓实例应用。
20
创建安卓应用。
20
创建安卓应用版本。
20
删除安卓应用。
20
删除安卓应用版本。
20
查询安卓应用信息。
20
修改安卓应用。
20
修改安卓应用版本。
20
创建 COS 临时密钥。
20
批量清理安卓实例应用数据。
20
批量禁用安卓实例应用。
20
批量启用安桌实例应用。
20
批量设置安卓实例应用后台保活。
20
批量设置安卓实例应用前台保活。
20

文件相关接口

接口名称
接口功能
频率限制(次/秒)
分发文件到安卓实例。
20
分发照片到安卓实例相册。
20
上传文件到安卓实例。
20
批量上传文件到安卓实例。
20

标签相关接口

接口名称
接口功能
频率限制(次/秒)
批量修改安卓实例的标签。
20
创建安卓实例标签。
20
查询安卓实例标签。
20
删除安卓实例标签。
20

任务相关接口

接口名称
接口功能
频率限制(次/秒)
查询安卓实例任务状态。
20

宿主机相关接口

接口名称
接口功能
频率限制(次/秒)
批量重启安卓实例宿主机。
20

备份还原相关接口

接口名称
接口功能
频率限制(次/秒)
复制安卓实例。
20
备份安卓实例到指定存储。
20
批量删除安卓实例备份文件。
20
指定存储还原安卓实例。
20

运维调试相关接口

接口名称
接口功能
频率限制(次/秒)
创建安卓实例 SSH 连接。
20
创建安卓实例 WebShell 连接。
20
批量获取安卓实例日志。
20
创建安卓实例 ADB 连接。
20