Alibaba Cloud Model Studio：HappyOyster-Adventure-查詢Travel產物 API參考

查詢已完成 Adventure Travel 的錄製原片和三個合成變體。對外交付建議使用 withInstructionAndWatermark。

適用範圍

查詢已完成 Adventure Travel 的錄製原片和三個合成變體。withInstruction 在 Adventure 中表示探索互動貼圖版，不是文字指令字幕版。對外交付建議使用 withInstructionAndWatermark。呼叫前請確認以下事項：

• 驗證要求：僅支援 主 API Key 呼叫，臨時 API Key 無法使用（錯誤碼 403003）。

  • 取得主 API Key：取得與設定 API Key。

• 前置條件：Travel 狀態為 completed。原片 URL 可用是返回產物回應的前提。可透過查詢Travel狀態介面确认。

• 呼叫方：您的伺服器端呼叫。

HTTP 呼叫

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/artifacts?encryptedTravelId={encryptedTravelId}' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "composeStatus": "ready",
        "video": {
            "original": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_raw.mp4?v=2",
                "status": "ready",
                "resolution": "720p",
                "durationSec": 90
            },
            "withWatermark": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_wm.mp4?v=2",
                "status": "ready",
                "resolution": null,
                "durationSec": 90
            },
            "withInstruction": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_overlay.mp4?v=2",
                "status": "ready",
                "resolution": null,
                "durationSec": 90
            },
            "withInstructionAndWatermark": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_all.mp4?v=2",
                "status": "ready",
                "resolution": null,
                "durationSec": 90
            }
        }
    }
}

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "composeStatus": "processing",
        "video": {
            "original": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_raw.mp4?v=2",
                "status": "ready",
                "resolution": "720p",
                "durationSec": 90
            },
            "withWatermark": {
                "url": null,
                "status": "processing",
                "resolution": null,
                "durationSec": null
            },
            "withInstruction": {
                "url": null,
                "status": "processing",
                "resolution": null,
                "durationSec": null
            },
            "withInstructionAndWatermark": {
                "url": null,
                "status": "processing",
                "resolution": null,
                "durationSec": null
            }
        }
    }
}

前置狀態與呼叫注意事項

• Travel 不是 completed、不存在、不歸屬或不是 Adventure、原片尚不可用時，均返回 404000；原片是整個介面的硬門檻。
• 用戶端可在 composeStatus != ready 時按受控間隔輪詢。
• 不要把 withInstruction 解釋為導演文字字幕；在 Adventure 中它是探索互動貼圖。
• 對外交付建議讀取 video.withInstructionAndWatermark；若業務僅需原片，可繼續讀取 video.original.url。
• 四個影片變體共用同一時長解析結果，因此同一次回應中已就緒且時長可解析的變體會返回一致的 durationSec。
• TRAVEL_NO_STREAM_AUTO_END 結束的 Travel 為 failed，不會產生可查詢產物。

錯誤碼

如果模型呼叫失敗並返回錯誤訊息，請參閱 HappyOyster 錯誤碼進行解決。

下一步

• 查詢Travel列表：檢視其他歷史 Travel。
• 結束Travel：結束新的 Travel 後再查詢產物。