进度查询
查询任务状态、阶段与进度。
任务已创建
数据处理中
训练中
68%
任务已完成--:--
任务已创建
正在处理
成果已就绪
POINTCOSM API / 3DGS CLOUD
将 3DGS 重建能力
接入你的产品
通过 Pointcosm API 上传照片、视频或 360 影像，
创建重建任务、查询进度，并获取三维模型成果。
通过 API，将照片、视频与 360 影像转化为三维模型。
HTTP API 与 Python SDK- 状态与进度可查询
- 模型成果按需获取
3DGS 训练管线
普通影像
建筑、街景与室内外场景
标准影像重建 V2 PP1-V2普通照片、视频与航拍照片。
不适用全景、普通鱼眼或已有 COLMAP 数据集。
展开输入要求
输入要求
适合普通照片、普通视频与航拍照片。不适用于全景、普通鱼眼或已有 COLMAP 数据集。
查看接入文档
360 场景
室内外大场景与多源融合
360 长视频标准重建 PP5-V1连续 INSV / OSV；大空间、长路径。展开输入要求
输入要求
使用连续采集的原始 INSV / OSV 360 视频，适合大空间、长路径与闭环采集。
查看接入文档360 多视频标准重建 PP6-V1一条或多条同格式 INSV / OSV。展开输入要求
输入要求
支持一条或多条原始 360 视频，同一任务保持 INSV / OSV 格式一致。
查看接入文档360 多源融合重建 PP7-V2至少一个 360 来源，可结合补拍。展开输入要求
输入要求
至少包含一个 360 来源，可结合普通照片、视频、航拍与立面补拍素材。
查看接入文档360 高精度重建 V2 PP9-V2根目录原始 INSV / OSV 视频。展开输入要求
输入要求
在数据集根目录提供原始 INSV / OSV 视频；不接受拆帧、已拼接全景或 COLMAP 包。
查看接入文档五步接入
- 1
创建凭证
在控制台创建 API 凭证。
- 2
获取令牌
使用凭证获取短期访问令牌。
- 3
上传数据集
上传照片、视频或 360 影像，等待就绪。
- 4
创建训练
选择产品并创建异步训练任务。
- 5
获取成果
查询任务产物，获取限时下载链接。
示例前提：已获取访问令牌，数据集已就绪。
# 1. 创建训练任务
POST https://api.pointcosm.cn/api/v1/tasks
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json
{
"product_id": "<PRODUCT_UUID>",
"asset_id": "<ASSET_UUID>"
}
# 2. 查询任务状态
GET /api/v1/tasks/{id}
# 响应示意，仅展示结构
{
"success": true,
"data": { "id": "<TASK_UUID>" },
"error": null
}# Python 标准库 HTTP 示例
import json
from urllib.request import Request, urlopen
request = Request(
"https://api.pointcosm.cn/api/v1/tasks",
data=json.dumps({
"product_id": "<PRODUCT_UUID>",
"asset_id": "<ASSET_UUID>"
}).encode(),
headers={
"Authorization": "Bearer <ACCESS_TOKEN>",
"Content-Type": "application/json"
},
method="POST"
)
with urlopen(request, timeout=30) as response:
result = json.load(response)
if not result["success"]:
raise RuntimeError(result["error"])
print(result["data"])产品与数据集使用 UUID完整文档与 SDK
任务管理与模型下载
错误追踪
获取失败阶段、原因与重试建议。
获取错误码与原因，定位失败问题。
{
"status": "FAILED",
"error": {
"code": "INVALID_INPUT",
"message": "输入素材不符合要求"
}
}训练失败
查看失败信息后，按提示调整并重试。
模型下载
获取模型与配套文件的下载链接。
查询任务成果
获取下载链接下载模型与配套文件