AHOLO World Open API (OpenAPI 3.0.3, info.version=1.0.0)

This file is auto-generated alongside openapi.en.yaml / openapi.en.json on every build. If docs conflict, the OpenAPI spec is authoritative.

Documentation home:
- https://labs.aholo3d.com/api-docs/

Machine-readable API specs (aggregate):
- OpenAPI YAML (all services): https://labs.aholo3d.com/api-docs/openapi.en.yaml
- OpenAPI JSON (all services): https://labs.aholo3d.com/api-docs/openapi.en.json

Machine-readable API specs (per service):
- asset service (upload credentials & OUS):
  - YAML: https://labs.aholo3d.com/api-docs/specifications/services/asset/openapi.en.yaml
  - JSON: https://labs.aholo3d.com/api-docs/specifications/services/asset/openapi.en.json
- world (reconstruction, generation):
  - YAML: https://labs.aholo3d.com/api-docs/specifications/services/world/openapi.en.yaml
  - JSON: https://labs.aholo3d.com/api-docs/specifications/services/world/openapi.en.json
- rendercloud service:
  - YAML: https://labs.aholo3d.com/api-docs/specifications/services/rendercloud/openapi.en.yaml
  - JSON: https://labs.aholo3d.com/api-docs/specifications/services/rendercloud/openapi.en.json
- lux3d service:
  - YAML: https://labs.aholo3d.com/api-docs/specifications/services/lux3d/openapi.en.yaml
  - JSON: https://labs.aholo3d.com/api-docs/specifications/services/lux3d/openapi.en.json

OpenAPI info (one-line summary):
- AHOLO OpenAPI documentation focused on world reconstruction and world generation (Spatial Gen): start 3D Gaussian Splatting (3DGS) world reconstruction from images or videos, or generate worlds from text and/or images, then poll details and paginate lists by worldId. Send Authorization as required (see each operation’s security definitions). The default gateway is under Servers. The sidebar groups operations by service (World, Render Cloud, Lux3D, …), then by tags within each service.

Servers (matches openapi.en.yaml):
  - https://api.aholo3d.com (Aholo Open Platform HTTPS entry (International))

Sidebar Tags (matches openapi.en.yaml):
  - Asset
  - World
  - RenderCloud
  - Lux3D

Aggregated operationId index (see openapi.en.yaml for full details):
  - closeRenderCloudRealtimeStream  (DELETE /global/rendercloud/v1/streams/{sessionId})
  - createImgTo3dTaskGlobal  (POST /global/lux3d/v1/generate/img-to-3d/task/create)
  - createMaterialTransferTaskGlobal  (POST /global/lux3d/v1/generate/material-transfer/task/create)
  - createMeshUploadAndProcessTask  (POST /global/rendercloud/v1/mesh-upload-process/task/create)
  - createRenderCloudRealtimeStream  (POST /global/rendercloud/v1/streams)
  - createTextTo3dTaskGlobal  (POST /global/lux3d/v1/generate/text-to-3d/task/create)
  - createWorld  (POST /global/world/v1/reconstructions)
  - describeRenderCloudOpenUsdFormat  (GET /global/rendercloud/v1/openusd-format)
  - generateWorld  (POST /global/world/v1/generations)
  - getMyWorldList  (POST /global/world/v1/list)
  - getRenderCloudInstanceInAholo  (GET /global/rendercloud/v1/mesh-upload-process/task/get)
  - getTaskGlobal  (GET /global/lux3d/v1/generate/task/get)
  - getUploadToken  (GET /global/asset/v1/token)
  - getWorldDetail  (GET /global/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 /global/rendercloud/v1/streams/{sessionId}:push)
  - runRenderCloudOfflineJob  (POST /global/rendercloud/v1/jobs)

Reference docs (Docusaurus):
- Introduction: https://labs.aholo3d.com/api-docs/intro
- Quick Start: https://labs.aholo3d.com/api-docs/quickstart
- Agent Skills index: https://labs.aholo3d.com/api-docs/skills
- Skill aholo-3dgs-reconstruction: https://labs.aholo3d.com/api-docs/skills/aholo-3dgs-reconstruction
- Skill Lux3D: https://labs.aholo3d.com/api-docs/skills/lux3d
- Authentication: https://labs.aholo3d.com/api-docs/authentication
- Interactive API: https://labs.aholo3d.com/api-docs/api-reference/

Authentication:
- Gateway: set Authorization header to your API key (no Bearer prefix). See openapi.en.yaml components.securitySchemes.
- Upload (OUS): use Authorization to get an upload token via GET /asset/v1/token; then use ous-token-v2 for requests to the OUS globalDomain — independent of the gateway Authorization.
- If docs conflict, openapi.en.yaml and the Authentication page are authoritative.

Agent routing hints:
- For tasks spanning multiple services, use the aggregate OpenAPI.
- For single-service tasks, prefer the per-service openapi.en.yaml.
- If aggregate and per-service specs conflict, the per-service spec wins.

Data conventions:
- Enum inputs use lowercase (except status values which use UPPER_CASE).
- createTime / updateTime in World responses are Unix millisecond timestamps.

Reliability hints:
- Use operationId to identify actions.
- Validate required fields and enum values before calling.
- Async flows: create task → poll until terminal state.
- On 429 or transient 5xx: exponential backoff with a cap.
- On 401: verify API key and retry once.

Typical call chains:
- World reconstruction: createWorld → getWorldDetail (poll until terminal).
- World generation: generateWorld → getWorldDetail (poll until terminal).
- World list: getMyWorldList → getWorldDetail.

Notes:
- Only published APIs are included.