AHOLO Open API（OpenAPI 3.0.3，info.version=1.0.0）

本文件在每次聚合 OpenAPI 时自动生成，与下列 openapi.yaml / openapi.json 同源；若与手工文档不一致，以 OpenAPI 为准。

主文档首页：
- https://labs.aholo3d.cn/api-docs/

机器可读 API 规范（聚合）：
- OpenAPI YAML（全部服务）：https://labs.aholo3d.cn/api-docs/openapi.yaml
- OpenAPI JSON（全部服务）：https://labs.aholo3d.cn/api-docs/openapi.json

机器可读 API 规范（按服务）：
- asset 服务（上传凭证与 OUS）：
  - YAML：https://labs.aholo3d.cn/api-docs/specifications/services/asset/openapi.yaml
  - JSON：https://labs.aholo3d.cn/api-docs/specifications/services/asset/openapi.json
- world 服务（世界重建、世界生成）：
  - YAML：https://labs.aholo3d.cn/api-docs/specifications/services/world/openapi.yaml
  - JSON：https://labs.aholo3d.cn/api-docs/specifications/services/world/openapi.json
- rendercloud 服务：
  - YAML：https://labs.aholo3d.cn/api-docs/specifications/services/rendercloud/openapi.yaml
  - JSON：https://labs.aholo3d.cn/api-docs/specifications/services/rendercloud/openapi.json
- lux3d 服务：
  - YAML：https://labs.aholo3d.cn/api-docs/specifications/services/lux3d/openapi.yaml
  - JSON：https://labs.aholo3d.cn/api-docs/specifications/services/lux3d/openapi.json

OpenAPI info（摘要一行）：
- 本文档为 AHOLO OpenAPI 说明，侧重世界重建与世界生成：从图片、视频等资源发起 3D 高斯溅射（3DGS）世界重建，或使用文案与图片发起 世界生成（Spatial Gen），并支持按 worldId 查询详情与分页列表等。请在请求头按平台约定携带 Authorization（见各接口安全定义）。默认网关地址见 Servers。

Servers（与 openapi.yaml 一致）：
  - https://api.aholo3d.cn (Aholo 开放平台 HTTPS 入口)

侧栏 Tags（与 openapi.yaml 一致）：
  - Asset
  - World
  - RenderCloud
  - Lux3D

聚合 operationId 索引（实现细节以 openapi.yaml 为准）：
  - closeRenderCloudRealtimeStream  (DELETE /rendercloud/v1/streams/{sessionId})
  - createImgTo3dTask  (POST /lux3d/v1/generate/img-to-3d/task/create)
  - createMaterialTransferTask  (POST /lux3d/v1/generate/material-transfer/task/create)
  - createMeshUploadAndProcessTask  (POST /rendercloud/v1/mesh-upload-process/task/create)
  - createRenderCloudRealtimeStream  (POST /rendercloud/v1/streams)
  - createTextTo3dTask  (POST /lux3d/v1/generate/text-to-3d/task/create)
  - createWorld  (POST /world/v1/reconstructions)
  - describeRenderCloudOpenUsdFormat  (GET /rendercloud/v1/openusd-format)
  - generateWorld  (POST /world/v1/generations)
  - getMyWorldList  (POST /world/v1/list)
  - getRenderCloudInstanceInAholo  (GET /rendercloud/v1/mesh-upload-process/task/get)
  - getTask  (GET /lux3d/v1/generate/task/get)
  - getUploadToken  (GET /asset/v1/token)
  - getWorldDetail  (GET /world/v1/{worldId})
  - ousCosBlockUploadInit  (POST /ous/api/v2/block/upload/init)
  - ousCosBlockUploadPart  (POST /ous/api/v2/block/upload/part)
  - ousCosSingleUpload  (POST /ous/api/v2/single/upload)
  - ousCosUploadStatus  (GET /ous/api/v2/upload/status)
  - pushRenderCloudRealtimeStreamUpdate  (POST /rendercloud/v1/streams/{sessionId}:push)
  - runRenderCloudOfflineJob  (POST /rendercloud/v1/jobs)

参考与指南（Docusaurus）：
- 指南首页：https://labs.aholo3d.cn/api-docs/intro
- 快速开始：https://labs.aholo3d.cn/api-docs/quickstart
- Agent Skills 索引：https://labs.aholo3d.cn/api-docs/skills
- Skill aholo-3dgs-reconstruction：https://labs.aholo3d.cn/api-docs/skills/aholo-3dgs-reconstruction
- Skill Lux3D：https://labs.aholo3d.cn/api-docs/skills/lux3d
- 鉴权说明：https://labs.aholo3d.cn/api-docs/authentication
- 交互 API：https://labs.aholo3d.cn/api-docs/api-reference/

鉴权要求：
- 开放平台网关：每个请求在 Header 中设置 Authorization，值为平台申请的 API key，无需 Bearer 前缀；细节见指南「授权」与 openapi components.securitySchemes。
- 上传（OUS）：获取上传凭证仍使用上述 Authorization；对 OUS globalDomain 的请求使用 ous-token-v2 等，与网关 Authorization 独立；见指南「授权」与 OpenAPI Upload 相关路径。
- 若多份说明不一致，以 openapi.yaml 与指南 authentication 页面为权威。

Agent 路由建议：
- 若任务涉及多个服务，优先读取聚合 OpenAPI。
- 若任务只涉及单个服务，优先读取该服务的 openapi.yaml。
- 若聚合与单服务规范冲突，以单服务规范为准。

数据约定：
- 除状态字段外，枚举入参使用小写。
- 状态值使用大写。
- World 详情/列表中的 createTime、updateTime 为 Unix 毫秒时间戳；其它服务以各 OpenAPI 为准。

执行与可靠性建议：
- 优先使用 operationId 作为动作选择标识。
- 执行前先校验必填字段与枚举值。
- 异步流程先创建任务，再轮询查询接口直到终态。
- 遇到 429 或瞬时 5xx，采用有上限的指数退避重试。
- 遇到 401，检查 API key 后重试一次。

典型调用链（示例）：
- 世界重建：createWorld → getWorldDetail（轮询至终态）。
- 世界生成：generateWorld → getWorldDetail（轮询至终态）。
- 世界列表：getMyWorldList → getWorldDetail。

备注：
- 文档中仅包含已发布 API。