Alibaba Cloud Model Studio:HappyOyster-Adventure-End Travel API リファレンス

Adventure Travel を能動的に終了します。正常終了後は completed になり、ストリームなしタイムアウトによる終了の場合は failed となり、リプレイ成果物は生成されません。maxExperienceTimeSec に達した場合も、サーバーによって自動的に終了されます。

スコープ

Adventure Travel を能動的に終了します。正常終了後、Travel は completed になります。ストリームなしタイムアウトによる終了の場合は failed になります。呼び出し前に、以下を確認してください。

• 認証：プライマリ API キーは必須ではありません。プライマリまたは一時 API キーのいずれかで呼び出せます。取得方法については、認証情報の取得 を参照してください。
• 前提条件：Travel はまだ終端状態に入っておらず、サーバーが終了できる状態である必要があります。Travel ステータスのクエリ で確認してください。
• 呼び出し元：サーバーまたはクライアントのいずれからも呼び出すことができます。

HTTP リクエスト

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "userAgent": "HappyOyster-Web/0.1.0"
}'

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-adventure/openapi/v1/travels/end' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "failCode": "TRAVEL_NO_STREAM_AUTO_END",
    "userAgent": "HappyOyster-Web/0.1.0"
}'

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "completed",
        "errorCode": null,
        "errorMessage": null,
        "endedAt": "2026-06-04T00:03:00Z",
        "durationSec": 90
    }
}

{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "failed",
        "errorCode": "TRAVEL_NO_STREAM_AUTO_END",
        "errorMessage": "Something went wrong.",
        "endedAt": "2026-06-04T00:03:00Z",
        "durationSec": null
    }
}

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

• encryptedTravelId は現在のプライマリアカウントおよび Adventure モデルに属している必要があります。
• failCode を省略した場合、正常終了として扱われます。サポートされていない値を渡すと 400000 が返されます。
• maxExperienceTimeSec に達すると、サーバーは自動的に Travel を終了します。クライアントは、ステータスコールバックまたはステータス照会結果からローカル状態を収束させる必要があります。
• 正常終了時、durationSec は優先的に利用可能な完成動画の実際の長さを使用します。完成動画の長さをまだ解析できない場合は null になることがあります。
• 正常終了後に completed に達しても、合成済みアーティファクトはまだ処理中の可能性があります。Travel アーティファクトのクエリ に従ってクエリおよびポーリングを行ってください。

エラーコード

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

次のステップ

Travel が completed 状態になった後：

• Travel アーティファクトのクエリ：ポーリングして、記録されたオリジナルおよび合成済みバリアントを取得します。
• Travel リストのクエリ：過去の Travel を表示します。