用途:当用户使用已发布的 World Labs / Marble Public API v1 时,可用该技能回答 API 契约问题或编写集成代码。回答前应先阅读 references/api.md,需要精确的端点与 schema 细节时再查看 references/openapi.yaml。
主要能力:编写 curl、Python、TypeScript 或 SDK 风格示例,覆盖世界生成、操作轮询、世界获取、媒体资产上传以及全景深度转 RGB;可根据 OpenAPI 规范生成或更新客户端代码;解释文本、图像、多图、视频、媒体资产和基于 URL 的世界提示的请求结构;排查鉴权、校验、媒体上传、操作状态和资产 URL 问题。
使用方式:鉴权使用 WLT-Api-Key 请求头,而非 bearer 认证;API 密钥视为机密,绝不打印、提交或记录真实密钥;优先使用显式模型名,如 marble-1.1 或 marble-1.1-plus;世界生成前先用媒体资产上传处理本地图像/视频文件;轮询 /marble/v1/operations/{operation_id} 直到 done 为 true,调用方需要最新世界对象时按 world_id 获取世界;生成客户端或命名请求字段时对照 references/openapi.yaml 验证。
适用场景:需要解释或实现 World API 集成的编码智能体任务。
限制:资料未提供具体端点清单、完整 schema、价格、平台支持范围或效果说明,需以 references/api.md 与 references/openapi.yaml 为准。