Alibaba Cloud Model Studio:Referencia de API de HappyOyster-Acting-Query Travel Artifacts

Consulta el original grabado y las tres variantes compuestas de un Travel de Acting completado. Para entrega externa, se recomienda withInstructionAndWatermark.

Ámbito

Consulta el original grabado y las tres variantes compuestas de un Travel de Acting completado. withInstruction es la variante con superposición de las instrucciones de proceso del usuario; para entrega 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-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
            }
        }
    }
}

Estados previos y notas de llamada

• El cliente puede sondear a un intervalo controlado mientras composeStatus != ready.
• video.withInstruction es la variante con superposición de instrucciones de proceso, no el original sin instrucciones.
• 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.
• No interprete siempre 404000 como "aún no completado": primero lea status y errorCode mediante Consultar estado del Travel o Consultar lista de Travels; para un Travel con estado failed, muestre el motivo del fallo.

Escenarios 404000

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.