Alibaba Cloud Model Studio:Referencia de la API de consulta de artefactos de Travel de HappyOyster-Adventure

Consulta el original grabado y las tres variantes compuestas de un Travel de Adventure completado. Para distribución externa, se recomienda withInstructionAndWatermark.

Ámbito

Consulta el original grabado y las tres variantes compuestas de un Travel de Adventure completado. En Adventure, withInstruction significa la variante de superposición de exploración e interacción, no una variante de subtítulos de instrucciones textuales. Para distribución externa, se recomienda withInstructionAndWatermark. Antes de realizar la llamada, confirme lo siguiente:

• Autenticación: Solo se admite la API Key principal; no se pueden utilizar API Keys temporales (código de error 403003).

  • Obtenga la API Key principal: Obtener y configurar una API Key.

• Requisitos previos: El estado del Travel es completed. Una URL original disponible es la condición previa para devolver una respuesta de artefactos. Confírmelo mediante Consultar estado del Travel.

• Caller: Llamado por su servidor.

Solicitud 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
            }
        }
    }
}

Estados previos y notas de llamada

• Cuando el Travel no está completed, no existe, no le pertenece o no es de tipo Adventure, o cuando el original aún no está disponible, se devuelve 404000; el original constituye la restricción estricta para todo el endpoint.
• El cliente puede sondear a un intervalo controlado mientras composeStatus != ready.
• No interprete withInstruction como un subtítulo de texto directivo; en Adventure, corresponde a la superposición de exploración e interacción.
• Para entrega externa, lea video.withInstructionAndWatermark; si su caso de uso solo necesita el original, continúe leyendo video.original.url.
• Las cuatro variantes de video comparten el mismo resultado de análisis de duración, por lo que dentro de una misma respuesta las variantes listas con una duración analizable devuelven un valor consistente de durationSec.
• Un Travel finalizado por TRAVEL_NO_STREAM_AUTO_END tiene estado failed y no genera artefactos consultables.

Códigos de error

Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

Siguientes pasos

• Consultar lista de Travels: ver otros Travels históricos.
• Finalizar Travel: finalizar un nuevo Travel antes de consultar sus artefactos.