Consulta o original gravado e as três variantes compostas de uma Viagem de Acting concluída. Para entrega externa, recomenda-se withInstructionAndWatermark.
Escopo
Consulta o original gravado e as três variantes compostas de uma Viagem de Acting concluída. withInstruction é a variante de sobreposição das instruções de processo do usuário; para entrega externa, recomenda-se withInstructionAndWatermark. Antes de chamar, confirme o seguinte:
-
Autenticação: Apenas a API Key primária é suportada; API Keys temporárias não podem ser usadas (código de erro
403003).- Obtenha a API Key primária: Obter e configurar uma API Key.
-
Pré-requisitos: O status da Viagem é
completed. Uma URL original disponível é a pré-condição para retornar uma resposta de artefatos. Confirme via Consultar Status da Viagem. - Caller: Chamado pelo seu servidor.
Solicitação HTTP
- Singapore
- EUA (Virgínia)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-acting/openapi/v1/travels/artifactsSubstitua {WorkspaceId} pelo seu ID do Workspace real.Parâmetros da solicitação |
|
Authorization string (Obrigatório)Autenticação por API Key. Apenas a API Key primária é suportada; ela começa com sk-, ex. sk-xxx. É tipicamente configurada como a variável de ambiente $DASHSCOPE_API_KEY. Uma API Key temporária (começando com st-) retorna 403003. | |
Parâmetros de consulta | |
encryptedTravelId string (Obrigatório)Um ID de Viagem criptografado do Acting com status completed. Retornado por Entrar na Viagem. |
Parâmetros de resposta |
|
code integerCódigo de retorno. 0 indica sucesso; diferente de zero é um código de erro. | |
message stringMensagem de erro. null em caso de sucesso. | |
data objectDados da resposta. null em caso de falha.
Propriedades encryptedTravelId stringTravel ID criptografado.composeStatus stringO status agregado das três variantes compostas:
original.video objectAs quatro variantes fixas do vídeo principal. Cada item contém url, status, resolution e durationSec.
stringURL de download; null quando processing ou unavailable.video.*.status stringStatus por item:
string"720p" quando original corresponde a 720p; caso contrário, pode ser null.video.*.durationSec integerA duração do vídeo uniformemente analisada em segundos; quando analisável, todas as variantes ready carregam este valor. Pode ser null quando processing / unavailable ou quando a duração ainda não pode ser analisada. |
Estados pré-requisitos e notas de chamada
- O cliente pode consultar em um intervalo controlado enquanto
composeStatus != ready. video.withInstructioné a variante de sobreposição de instrução de processo, não o original sem instrução.- Para entrega externa, leia
video.withInstructionAndWatermark; se o seu negócio precisar apenas do original, continue lendovideo.original.url. - As quatro variantes de vídeo compartilham o mesmo resultado de análise de duração, portanto, dentro de uma única resposta, as variantes prontas com duração analisável retornam um
durationSecconsistente. - Um Travel encerrado por
TRAVEL_NO_STREAM_AUTO_ENDéfailede não gera artefatos consultáveis. - Não renderize sempre
404000como "ainda não concluído": primeiro leiastatuseerrorCodevia Consultar Status da Viagem ou Consultar Lista de Viagens; para uma Viagemfailed, mostre o motivo da falha.
Cenários 404000
| Cenário | Comportamento do endpoint |
|---|---|
A Viagem ainda está em andamento (init / pending / running / paused) | Retorna o código de negócio 404000, com message = Video is still being generated, please try again once the process is complete |
A Viagem está failed | Retorna o código de negócio 404000, com message = Experience failed and no video was produced (errorCode=<errorCode>): <errorMessage>; a falha é terminal e nenhum vídeo será produzido |
| A Viagem não existe, não pertence a você ou não é do tipo Acting | Retorna o código de negócio 404000 |
| A URL original está indisponível | Retorna o código de negócio 404000; o original é o bloqueio rígido para todo o endpoint |
| O original está pronto e a composição ainda está em processamento | HTTP 200; o item composto correspondente tem status=processing, url=null |
| A composição falhou ou a URL está temporariamente indisponível | HTTP 200; o item composto correspondente tem status=unavailable, url=null |
Códigos de erro
Se a chamada do modelo falhar e retornar um erro, consulte Códigos de Erro do HappyOyster para resolvê-lo.
Próximos passos
- Query Travel List: visualizar outros Travels históricos.
- End Travel: encerrar um novo Travel antes de consultar seus artefatos.