Alibaba Cloud Model Studio:HappyOyster-Acting-Query Travel Artifacts APIリファレンス

完了した Acting Travel の記録済みオリジナルと3つの合成バリアントをクエリします。外部への配信には withInstructionAndWatermark を推奨します。

スコープ

完了した Acting Travel の記録済みオリジナルと3つの合成バリアントをクエリします。withInstruction はユーザーのプロセス指示のオーバーレイバリアントです。外部への配信には withInstructionAndWatermark を推奨します。呼び出す前に、以下を確認してください。

• 認証：プライマリ API Key のみがサポートされています。一時的な API Key は使用できません（エラーコード 403003）。

  • プライマリ API Key を取得する：API Key の取得と設定。

• 前提条件：Travelのステータスがcompletedであること。利用可能なオリジナルURLがアーティファクトレスポンスを返すための前提条件となります。Query Travel Statusで確認してください。

• Caller：サーバーから呼び出されます。

HTTP リクエスト

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/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": 180
            },
            "withWatermark": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_wm.mp4?v=2",
                "status": "ready",
                "resolution": null,
                "durationSec": 180
            },
            "withInstruction": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_overlay.mp4?v=2",
                "status": "ready",
                "resolution": null,
                "durationSec": 180
            },
            "withInstructionAndWatermark": {
                "url": "https://cdn.happyoyster.com/exports/trvl_a1b2c3d4e5f6_all.mp4?v=2",
                "status": "ready",
                "resolution": null,
                "durationSec": 180
            }
        }
    }
}

{
    "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": 180
            },
            "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
            }
        }
    }
}

前提条件となるステータスと呼び出しに関する注意事項

• クライアントは、composeStatus != readyの間、制御された間隔でポーリングできます。
• video.withInstructionは処理指示オーバーレイバリアントであり、指示なしのオリジナルではありません。
• 外部配信の場合はvideo.withInstructionAndWatermarkを参照してください。ビジネスでオリジナルのみが必要な場合は、引き続きvideo.original.urlを参照してください。
• 4つのビデオバリアントは同じ再生時間解析結果を共有するため、1つのレスポンス内で解析可能な再生時間を持つ準備完了のバリアントは一貫した durationSec を返します。
• TRAVEL_NO_STREAM_AUTO_ENDによって終了されたTravelはfailedとなり、クエリ可能なアーティファクトを生成しません。
• 404000 を常に「未完了」としてレンダリングしないでください。まず Query Travel Status または Query Travel List を通じて status と errorCode を読み取ってください。failed の Travel については、失敗理由を表示してください。

404000 シナリオ

エラーコード

モデルの呼び出しに失敗してエラーが返された場合は、HappyOyster エラーコードを参照して解決してください。

次のステップ

• Query Travel List：他の過去のTravelを表示します。
• End Travel：アーティファクトをクエリする前に新しいTravelを終了します。