自动化打包接口文档

接入信息

基础说明

完整接口地址由 Host 与前缀组成。所有示例均使用生产环境，调试时请勿填写无效密钥，以免触发错误次数限制。

基础地址https://app.tt906.com/xcapi

鉴权方式地址参数 key

请求数据表单数据

响应格式JSON

接口不要求携带自定义请求头。鉴权密钥只通过文档标注的 Query 或 Path 位置传递。

{
  "code": 0,
  "message": "操作成功",
  "data": {},
  "total_count": 0
}

接入步骤

接入流程

先读取项目参数定义，再上传素材和提交任务。任务创建成功后通过任务 ID 查询构建进度。

01获取项目读取 project_id、价格与 keys

02上传素材取得 icon 与 background 文件 ID

03提交任务根据 keys 构造 args

04查询结果读取状态与多端下载地址

开发辅助

复制给 AI 使用

复制一份结构化的接口说明，再告诉 AI 你使用的开发语言和需要实现的功能，即可生成更准确的调用代码。

AI 对接说明

包含调用顺序、鉴权规则、接口路径、请求参数和风险限制

复制内容使用 YOUR_KEY 占位，不会包含当前登录密钥。创建任务接口可能产生费用，生成的代码也必须保留人工确认。

推荐调用顺序：获取项目 → 上传素材 → 提交任务 → 查询结果
鉴权方式：通过 key 参数传递，不需要自定义请求头
请求格式：GET 查询参数 / POST 表单数据
响应格式：JSON，先判断 code，再读取 data 和 message

素材接口

上传图片

上传图标或启动图并取得文件 ID。图片必须完整且不超过 2 MB。

上传图片

multipart/form-data

POST https://app.tt906.com/xcapi/files?key={密钥}

参数	类型	位置	必填	说明
`key`	String	Query	是	32 位用户密钥
`file`	File	Form	是	jpg / jpeg / png 图片
`default`	String	Query	否	`icon` 或 `background`，更新账户默认图片

curl -X POST 'https://app.tt906.com/xcapi/files?key=YOUR_KEY' \
  -F 'file=@/path/to/icon.png'

任务接口

提交打包任务

创建真实构建任务。项目参数必须与项目列表返回的 keys 一致，额外字段会被服务端移除。

创建打包任务

application/x-www-form-urlencoded 或 Form Data

POST https://app.tt906.com/xcapi/tasks?key={密钥}

参数	类型	必填	说明	示例
`project_id`	Int	是	项目 ID	1
`name`	String	是	应用名称，以中文或英文字母开头	我的应用
`icon`	Int	是	图标文件 ID；1 使用默认图标	1
`background`	Int	是	启动图 ID；2 使用默认启动图	2
`args`	JSON String	是	由项目 `keys` 决定	{"url":"https://example.com"}
`package`	String	否	三段式小写包名，留空自动生成	com.demo.app
`notice_url`	String	否	完成后 GET 回调，附加 id 参数	https://example.com/callback
`app_cdk`	String	否	对应项目的 App 卡密	—

在线调试会真实创建任务，并可能扣除余额、包月额度或消耗卡密。页面发送前会要求二次确认。

curl -X POST 'https://app.tt906.com/xcapi/tasks?key=YOUR_KEY' \
  --data-urlencode 'project_id=1' \
  --data-urlencode 'name=我的应用' \
  --data-urlencode 'icon=1' \
  --data-urlencode 'background=2' \
  --data-urlencode 'args={"url":"https://www.example.com"}'

项目接口

获取项目与参数定义

返回当前账户可见、可用的 App 类型。keys 的键名就是任务 args 允许并要求提交的字段。

获取项目列表

项目价格与显示范围会根据账户动态计算

GET https://app.tt906.com/xcapi/projects?key={密钥}

返回字段	说明
`project_id`	提交任务时使用的项目 ID
`name` / `tags` / `img`	项目名称、标签和预览图
`version_code` / `version_name`	当前构建版本
`money`	当前账户单次价格（元）
`is_vip`	0 按次；1 普通包月可免；2 高级包月可免
`keys`	在线表单字段定义，用于构造 `args`
`status`	当前账户是否可使用该项目

参数工具

项目参数生成器

使用全局密钥读取真实项目列表。选择项目后自动从 keys 生成 args JSON，可一键带入任务调试。

可用 App 类型

登录密钥会从首页自动同步，无需重复填写

项目列表

等待加载

登录后即可读取可用项目，自动生成任务参数

尚未选择项目
加载项目后可查看动态参数定义

任务查询

查询任务

按任务、项目、状态或 args 字段筛选。返回总数、任务状态和各平台下载地址。

查询打包任务

limit 最大为 50

GET https://app.tt906.com/xcapi/tasks/query?key={密钥}

Query 参数	类型	说明
`id`	Int	指定任务 ID
`name`	String	应用名称精确筛选
`project_id`	Int	按项目筛选
`status`	Int	-1 / 0 / 1 / 2 / 4
`page` / `limit`	Int	默认 1 / 10，limit 最大 50
`is_icon_base64`	String	传任意值后返回图标 Base64
其他字段	String	作为 `args` 字段进行精确筛选，例如 `url`

不要在列表查询中随意开启 is_icon_base64，这会显著增加响应体积。

分发工具

获取本地分发页 ZIP

为生成成功且仍有效的任务创建可下载的本地分发页压缩包。

GET https://app.tt906.com/xcapi/tasks/create_download_page_zip/{任务ID}?key={密钥}

{
  "code": 0,
  "data": { "download_url": "https://..." },
  "message": "获取成功"
}

账户接口

查询账户信息

读取余额、包月状态、每日额度、默认素材 ID 和任务统计。

GET https://app.tt906.com/xcapi/users/{密钥}

返回字段	说明
`money`	账户余额
`vip_status` / `vip_level` / `vip_active`	包月描述、等级与有效状态
`vip_time` / `daily_quota`	到期时间与每日免费额度
`icon_id` / `background_id`	默认图标和启动图 ID
`task_succeeded_total_count` / `task_failed_total_count`	成功与失败任务数量
`download_exp_time_status`	下载有效期权益状态

请求工具

在线调试

请求固定发送到 https://app.tt906.com/xcapi。POST 操作会先显示风险确认，不会静默提交。

请求参数GET

基础地址固定

接口

请求地址预览https://app.tt906.com/xcapi/projects?key=YOUR_KEY

响应结果

尚未请求— ms

等待请求响应状态、耗时和格式化 JSON 将显示在这里。

状态参考

响应与任务状态

HTTP 成功不等于业务成功。始终检查响应中的 code 和 message。

1生成成功可读取下载地址

0 / 2生成中稍后重新查询

3队列等待任务尚未开始

-1生成失败检查退款状态

4链接过期下载地址已失效

接口文档与在线调试

基础说明

接入流程

复制给 AI 使用

AI 对接说明

上传图片

上传图片

提交打包任务

创建打包任务

获取项目与参数定义

获取项目列表

项目参数生成器

可用 App 类型

查询任务

查询打包任务

获取本地分发页 ZIP

查询账户信息

在线调试

响应与任务状态

确认发送真实请求