关于 marble-developer-api
供开发者使用的参考技能，面向已发布的 World Labs / Marble Public API v1。它依据 API 文档和 OpenAPI 规范，协助解释接口、编写集成代码、生成客户端及排查问题。
主要功能
- 01查阅 API 与 OpenAPI 参考资料
- 02编写多种语言的 API 示例
- 03说明世界生成请求格式
- 04根据 OpenAPI 生成或更新客户端
- 05排查认证、上传和操作问题
适用场景
- 01构建 Marble Public API v1 集成
- 02根据 API 规范生成客户端代码
- 03排查 API 密钥或验证错误
- 04跟踪生成操作并获取世界数据
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/marble-developer-api确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/api.mdopenapi.yaml详细介绍
World Labs API
当用户使用已发布的 World Labs / Marble Public API v1 时，使用此技能。
回答 API 契约相关问题或编写集成代码前，请先阅读 references/api.md。如需了解当前准确的端点和架构详情，还请查看 references/openapi.yaml。
工作方式
- 使用
WLT-Api-Key请求头进行身份验证，不要使用 bearer 身份验证。 - 将 API 密钥视为机密。切勿打印、提交或记录真实密钥。
- 优先使用明确的模型名称，例如
marble-1.1或marble-1.1-plus。 - 生成世界前，先使用媒体资源上传功能上传本地图片或视频文件。
- 轮询
/marble/v1/operations/{operation_id}，直到done为true；当调用方需要最新的世界对象时，请使用world_id获取该对象。 - 生成客户端或命名请求字段时，请对照
references/openapi.yaml进行验证。
常见任务
- 编写用于世界生成、操作轮询、世界获取、媒体资源上传和 pano depth-to-RGB 的 curl、Python、TypeScript 或 SDK 风格示例。
- 根据 OpenAPI 规范生成或更新客户端代码。
- 说明文本、图片、多图片、视频、媒体资源和基于 URL 的世界提示词的请求结构。
- 排查身份验证、验证、媒体上传、操作状态和资源 URL 相关问题。
评论
支持 Markdown