Referência da API
Consultar histórico de vídeos persistentes
/v1/videosApenas registros persistent não excluídos da mesma conta e chave. Cobrança e armazenamento são independentes; ler histórico não garante a mesma política de modelos da geração.
Autenticação e permissões
Use sua chave atual do GloopAPI. Modelos, recursos e permissões disponíveis dependem do catálogo da chave e da documentação do endpoint.
Authorization: Bearer $GLOOP_API_KEYEsquemas de autenticação: BearerAuth
Solicitação
Parâmetros de consulta
qstringOpcionalBusca de prompt.
modelstringOpcionalID público do modelo.
statusstringOpcionalFiltro queued/processing/succeeded/failed/unknown.
cursorstringOpcionalnext_cursor da resposta original.
fromintegerOpcionalLimites de tempo em segundos Unix, from <= to.
- Mínimo
0
tointegerOpcionalLimites de tempo em segundos Unix, from <= to.
- Mínimo
0
limitintegerOpcionalQuantidade por página.
- Valor padrão
20- Mínimo
1- Máximo
50
Respostas e erros
HTTP 200
Histórico de vídeos persistentes consultado com sucesso
application/json
- Tipo
- object
- Campos obrigatórios
data
dataarrayObrigatórioArray de dados da página/catálogo atual.
Campos filhos de data (1)
[]objectOpcionalCampos filhos de [] (12)
updated_atintegerOpcionalÚltima atualização em segundos Unix.
retentionstringOpcionalPolítica de retenção do resultado; persistent é o espaço persistente.
inputobjectOpcionalEntrada original da tarefa ou do contrato da ferramenta.
Campos filhos de input (14)
modestringOpcionalObrigatório em persistent.
- Enumeração
["text_to_video","image_to_video"]
retentionstringOpcionalpersistent usa o espaço persistente; omitir cria uma tarefa comum.
quote_idstringOpcionalNovas solicitações persistent precisam confirmar antes uma cotação válida de video-quotes.
start_frameobjectOpcionalObrigatório em imagem para vídeo persistent: arquivo gerenciado da mesma chave. Proibido em texto para vídeo.
Campos filhos de start_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
end_frameobjectOpcionalQuadro final opcional em persistent, se o recurso oferecer suporte.
Campos filhos de end_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
webhook_endpoint_idstringOpcionalTarefas comuns podem referenciar receptores do console; persistent proíbe.
modelstringObrigatórioID público do catálogo da chave atual; não garante disponibilidade de modelos históricos do serviço.
promptstringObrigatórioPrompt de geração.
- Comprimento mínimo
1- Comprimento máximo
2500
durationintegerOpcionalSegundos conforme modelo; use a combinação completa de video-models mode.presets, não produto cartesiano. Wan Turbo não aceita este campo; sem padrão uniforme.
image_urlstringOpcionalQuadro inicial HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
end_image_urlstringOpcionalQuadro final HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
resolutionstringOpcionalResolução do preset do modelo.
aspect_ratiostringOpcionalProporção do preset do modelo.
Conforme modelo, política de áudio e presets do modo; não presuma que todos geram áudio.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: model, prompt
Propriedades adicionais:
falsemodestringOpcionalObrigatório em persistent.
- Enumeração
["text_to_video","image_to_video"]
retentionstringOpcionalpersistent usa o espaço persistente; omitir cria uma tarefa comum.
quote_idstringOpcionalNovas solicitações persistent precisam confirmar antes uma cotação válida de video-quotes.
start_frameobjectOpcionalObrigatório em imagem para vídeo persistent: arquivo gerenciado da mesma chave. Proibido em texto para vídeo.
Campos filhos de start_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
end_frameobjectOpcionalQuadro final opcional em persistent, se o recurso oferecer suporte.
Campos filhos de end_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
webhook_endpoint_idstringOpcionalTarefas comuns podem referenciar receptores do console; persistent proíbe.
modelstringObrigatórioID público do catálogo da chave atual; não garante disponibilidade de modelos históricos do serviço.
promptstringObrigatórioPrompt de geração.
- Comprimento mínimo
1- Comprimento máximo
2500
durationintegerOpcionalSegundos conforme modelo; use a combinação completa de video-models mode.presets, não produto cartesiano. Wan Turbo não aceita este campo; sem padrão uniforme.
image_urlstringOpcionalQuadro inicial HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
end_image_urlstringOpcionalQuadro final HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
resolutionstringOpcionalResolução do preset do modelo.
aspect_ratiostringOpcionalProporção do preset do modelo.
Conforme modelo, política de áudio e presets do modo; não presuma que todos geram áudio.
billingobjectOpcionalStatus de cobrança independente, não substituível pelo status de geração.
Campos filhos de billing (7)
currencystringObrigatórioMoeda da cotação/cobrança.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
reserved_quotaintegerObrigatórioReserva em unidades quota da plataforma, não em USD.
Cobrança final em unidades quota da plataforma; null indica ainda não determinada.
reserved_amountstringObrigatórioReserva máxima como string na moeda cotada.
Cobrança final como string; null indica não liquidada.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: currency, status, reserved_quota, final_quota, reserved_amount, final_amount
currencystringObrigatórioMoeda da cotação/cobrança.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
reserved_quotaintegerObrigatórioReserva em unidades quota da plataforma, não em USD.
Cobrança final em unidades quota da plataforma; null indica ainda não determinada.
reserved_amountstringObrigatórioReserva máxima como string na moeda cotada.
Cobrança final como string; null indica não liquidada.
storageobjectOpcionalStatus independente de salvamento.
Campos filhos de storage (3)
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: status
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
availabilityobjectOpcionalAções disponíveis atualmente.
Campos filhos de availability (4)
can_cancelbooleanObrigatórioSe a tarefa atual permite solicitar cancelamento.
can_deletebooleanObrigatórioSe a tarefa atual permite exclusão.
can_retry_storagebooleanObrigatórioSe a tarefa atual permite tentar salvar novamente.
reasonstringOpcionalMotivo público de ação indisponível ou revisão de cobrança.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: can_cancel, can_delete, can_retry_storage
can_cancelbooleanObrigatórioSe a tarefa atual permite solicitar cancelamento.
can_deletebooleanObrigatórioSe a tarefa atual permite exclusão.
can_retry_storagebooleanObrigatórioSe a tarefa atual permite tentar salvar novamente.
reasonstringOpcionalMotivo público de ação indisponível ou revisão de cobrança.
idstringObrigatórioIdentificador público do objeto, usado na sua rota de detalhes.
modelstringObrigatórioID público do modelo no catálogo da chave atual.
statusstringObrigatórioStatus comum/persistente: pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown. Estado terminal não implica liquidação nem arquivamento ready.
created_atintegerObrigatórioData de criação em segundos Unix.
resultobjectOpcionalMetadados de resultados prontos; podem não existir antes da conclusão.
Campos filhos de result (8)
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
storage_statusstringOpcionalStatus de arquivamento; download gerenciado garantido apenas após ready.
deliverystringOpcionalauthenticated_content exige o caminho de conteúdo; não presuma a existência de URL direta.
content_pathstringOpcionalCaminho de conteúdo autenticado pela plataforma; solicite binário com a mesma chave.
urlstringOpcionalURL de acesso ao resultado ou referência; assinadas só valem temporariamente.
content_typestringOpcionalTipo MIME do resultado.
file_namestringOpcionalNome público do arquivo baixado.
file_sizeintegerOpcionalBytes do arquivo de resultado.
Ramificação allOf 1
Tipo: object
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
storage_statusstringOpcionalStatus de arquivamento; download gerenciado garantido apenas após ready.
deliverystringOpcionalauthenticated_content exige o caminho de conteúdo; não presuma a existência de URL direta.
content_pathstringOpcionalCaminho de conteúdo autenticado pela plataforma; solicite binário com a mesma chave.
urlstringOpcionalURL de acesso ao resultado ou referência; assinadas só valem temporariamente.
content_typestringOpcionalTipo MIME do resultado.
file_namestringOpcionalNome público do arquivo baixado.
file_sizeintegerOpcionalBytes do arquivo de resultado.
errorstringOpcionalCategoria pública de falha ou objeto de erro.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: id, model, status, created_at
updated_atintegerOpcionalÚltima atualização em segundos Unix.
retentionstringOpcionalPolítica de retenção do resultado; persistent é o espaço persistente.
inputobjectOpcionalEntrada original da tarefa ou do contrato da ferramenta.
Campos filhos de input (14)
modestringOpcionalObrigatório em persistent.
- Enumeração
["text_to_video","image_to_video"]
retentionstringOpcionalpersistent usa o espaço persistente; omitir cria uma tarefa comum.
quote_idstringOpcionalNovas solicitações persistent precisam confirmar antes uma cotação válida de video-quotes.
start_frameobjectOpcionalObrigatório em imagem para vídeo persistent: arquivo gerenciado da mesma chave. Proibido em texto para vídeo.
Campos filhos de start_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
end_frameobjectOpcionalQuadro final opcional em persistent, se o recurso oferecer suporte.
Campos filhos de end_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
webhook_endpoint_idstringOpcionalTarefas comuns podem referenciar receptores do console; persistent proíbe.
modelstringObrigatórioID público do catálogo da chave atual; não garante disponibilidade de modelos históricos do serviço.
promptstringObrigatórioPrompt de geração.
- Comprimento mínimo
1- Comprimento máximo
2500
durationintegerOpcionalSegundos conforme modelo; use a combinação completa de video-models mode.presets, não produto cartesiano. Wan Turbo não aceita este campo; sem padrão uniforme.
image_urlstringOpcionalQuadro inicial HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
end_image_urlstringOpcionalQuadro final HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
resolutionstringOpcionalResolução do preset do modelo.
aspect_ratiostringOpcionalProporção do preset do modelo.
Conforme modelo, política de áudio e presets do modo; não presuma que todos geram áudio.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: model, prompt
Propriedades adicionais:
falsemodestringOpcionalObrigatório em persistent.
- Enumeração
["text_to_video","image_to_video"]
retentionstringOpcionalpersistent usa o espaço persistente; omitir cria uma tarefa comum.
quote_idstringOpcionalNovas solicitações persistent precisam confirmar antes uma cotação válida de video-quotes.
start_frameobjectOpcionalObrigatório em imagem para vídeo persistent: arquivo gerenciado da mesma chave. Proibido em texto para vídeo.
Campos filhos de start_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
end_frameobjectOpcionalQuadro final opcional em persistent, se o recurso oferecer suporte.
Campos filhos de end_frame (1)
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: file_id
file_idstringObrigatórioID público de arquivo gerenciado da mesma conta e chave.
webhook_endpoint_idstringOpcionalTarefas comuns podem referenciar receptores do console; persistent proíbe.
modelstringObrigatórioID público do catálogo da chave atual; não garante disponibilidade de modelos históricos do serviço.
promptstringObrigatórioPrompt de geração.
- Comprimento mínimo
1- Comprimento máximo
2500
durationintegerOpcionalSegundos conforme modelo; use a combinação completa de video-models mode.presets, não produto cartesiano. Wan Turbo não aceita este campo; sem padrão uniforme.
image_urlstringOpcionalQuadro inicial HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
end_image_urlstringOpcionalQuadro final HTTPS público específico do modelo para tarefas comuns; proibido em persistent.
resolutionstringOpcionalResolução do preset do modelo.
aspect_ratiostringOpcionalProporção do preset do modelo.
Conforme modelo, política de áudio e presets do modo; não presuma que todos geram áudio.
billingobjectOpcionalStatus de cobrança independente, não substituível pelo status de geração.
Campos filhos de billing (7)
currencystringObrigatórioMoeda da cotação/cobrança.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
reserved_quotaintegerObrigatórioReserva em unidades quota da plataforma, não em USD.
Cobrança final em unidades quota da plataforma; null indica ainda não determinada.
reserved_amountstringObrigatórioReserva máxima como string na moeda cotada.
Cobrança final como string; null indica não liquidada.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: currency, status, reserved_quota, final_quota, reserved_amount, final_amount
currencystringObrigatórioMoeda da cotação/cobrança.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
reserved_quotaintegerObrigatórioReserva em unidades quota da plataforma, não em USD.
Cobrança final em unidades quota da plataforma; null indica ainda não determinada.
reserved_amountstringObrigatórioReserva máxima como string na moeda cotada.
Cobrança final como string; null indica não liquidada.
storageobjectOpcionalStatus independente de salvamento.
Campos filhos de storage (3)
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: status
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
statusstringObrigatórioStatus atual do objeto; avalie separadamente da cobrança e do salvamento.
error_codestringOpcionalCódigo público de erro para decisões de fluxo.
availabilityobjectOpcionalAções disponíveis atualmente.
Campos filhos de availability (4)
can_cancelbooleanObrigatórioSe a tarefa atual permite solicitar cancelamento.
can_deletebooleanObrigatórioSe a tarefa atual permite exclusão.
can_retry_storagebooleanObrigatórioSe a tarefa atual permite tentar salvar novamente.
reasonstringOpcionalMotivo público de ação indisponível ou revisão de cobrança.
Ramificação allOf 1
Tipo: object
Obrigatório nesta ramificação: can_cancel, can_delete, can_retry_storage
can_cancelbooleanObrigatórioSe a tarefa atual permite solicitar cancelamento.
can_deletebooleanObrigatórioSe a tarefa atual permite exclusão.
can_retry_storagebooleanObrigatórioSe a tarefa atual permite tentar salvar novamente.
reasonstringOpcionalMotivo público de ação indisponível ou revisão de cobrança.
idstringObrigatórioIdentificador público do objeto, usado na sua rota de detalhes.
modelstringObrigatórioID público do modelo no catálogo da chave atual.
statusstringObrigatórioStatus comum/persistente: pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown. Estado terminal não implica liquidação nem arquivamento ready.
created_atintegerObrigatórioData de criação em segundos Unix.
resultobjectOpcionalMetadados de resultados prontos; podem não existir antes da conclusão.
Campos filhos de result (8)
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
storage_statusstringOpcionalStatus de arquivamento; download gerenciado garantido apenas após ready.
deliverystringOpcionalauthenticated_content exige o caminho de conteúdo; não presuma a existência de URL direta.
content_pathstringOpcionalCaminho de conteúdo autenticado pela plataforma; solicite binário com a mesma chave.
urlstringOpcionalURL de acesso ao resultado ou referência; assinadas só valem temporariamente.
content_typestringOpcionalTipo MIME do resultado.
file_namestringOpcionalNome público do arquivo baixado.
file_sizeintegerOpcionalBytes do arquivo de resultado.
Ramificação allOf 1
Tipo: object
file_idstringOpcionalID público de arquivo gerenciado da mesma conta e chave.
storage_statusstringOpcionalStatus de arquivamento; download gerenciado garantido apenas após ready.
deliverystringOpcionalauthenticated_content exige o caminho de conteúdo; não presuma a existência de URL direta.
content_pathstringOpcionalCaminho de conteúdo autenticado pela plataforma; solicite binário com a mesma chave.
urlstringOpcionalURL de acesso ao resultado ou referência; assinadas só valem temporariamente.
content_typestringOpcionalTipo MIME do resultado.
file_namestringOpcionalNome público do arquivo baixado.
file_sizeintegerOpcionalBytes do arquivo de resultado.
errorstringOpcionalCategoria pública de falha ou objeto de erro.
next_cursorstringOpcionalPróximo cursor; use sem alterações na paginação deste endpoint. Vazio indica a última página.
HTTP 400
Campos ou parâmetros de solicitação inválidos.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 401
A chave está ausente, inválida, expirada ou revogada.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 403
Permissões insuficientes de IP, conta, modelo ou ferramenta.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 404
Objeto/recurso indisponível ou função desativada.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 409
Conflito de idempotência/cotação, objeto não pronto ou ainda referenciado.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 429
Limite de solicitações/fila.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 500
Falha interna de autenticação ou armazenamento de dados.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional
HTTP 503
Serviço, preços ou armazenamento indisponíveis.
application/json
- Tipo
- object
- Campos obrigatórios
error
errorobjectObrigatórioCampos filhos de error (4)
codestringOpcionalmessagestringOpcionaltypestringOpcionalrequest_idstringOpcional