marble-developer-api

World Labs API

ユーザーが公開されている World Labs ／ Marble Public API v1 を利用している場合に、このスキルを使用してください。

API 契約に関する質問に回答する前、または統合コードを記述する前に、 references/api.md を読んでください。現在のエンドポイントとスキーマの正確な詳細については、 references/openapi.yaml も確認してください。

作業スタイル

• Bearer 認証ではなく、WLT-Api-Key ヘッダーで認証してください。
• API キーはシークレットとして扱ってください。実際のキーを表示、コミット、ログ出力しないでください。
• marble-1.1 や marble-1.1-plus など、明示的なモデル名を優先してください。
• ワールド生成の前に、ローカルの画像／動画ファイルをメディアアセットとしてアップロードしてください。
• done が true になるまで /marble/v1/operations/{operation_id} をポーリングしてください。呼び出し元が最新のワールドオブジェクトを必要とする場合は、world_id でワールドを取得してください。
• クライアントを生成するときやリクエストフィールドに名前を付けるときは、references/openapi.yaml で確認してください。

一般的なタスク

• ワールド生成、操作のポーリング、ワールドの取得、メディアアセットのアップロード、パノラマの深度から RGB への変換について、curl、Python、TypeScript、または SDK 形式のサンプルを作成します。
• OpenAPI 仕様からクライアントコードを生成または更新します。
• テキスト、画像、複数画像、動画、メディアアセット、URL ベースのワールドプロンプトのリクエスト形式を説明します。
• 認証、検証、メディアのアップロード、操作ステータス、アセット URL に関する問題をデバッグします。