入力とメディアアセット
World タスクは、モデルとリクエスト形式に応じて、テキスト、画像、複数画像、動画から開始できます。再利用するメディアプロンプトは先に media asset を準備し、World リクエスト内で参照します。 メディアとワールドの記録へのアクセスは API キーの所属組織で確認されます。共有前にモデルのpermission 設定を確認してください。返されたアセットや閲覧 URL には別のアクセス規則がある場合があります。
作成と polling
作成レスポンスには公開タスク ID と通常 poll_url が含まれます。進捗表示の前に ID を保存し、poll_url または GET /v1/tasks/ を completed または failed まで確認します。完了済み Worlds の管理
Worlds の list/get は自分のアカウントで利用できる完了済み World 用です。pending または failed の生成タスクは task status endpoint を使います。delete はユーザーが生成 World を削除する意図を示した時だけ使います。よくある落とし穴
- すべての World モデルがすべての入力タイプを支援するとは限らない。
- 署名付き画像・動画 URL はサービス側取得の再試行に十分な有効期限を持たせる。
- timeout 後に再試行する前に、返された task ID を保存して確認する。
- ダウンロード可能なモデルファイルが必要なら Worlds ではなく 3D 生成を使う。