Documentação

Referência da API

Obter cotação de vídeo persistente

POST/v1/video-quotes

retention=persistent; cota com modos aceitos no catálogo e quadros gerenciados. Opção desativada retorna 404 diretamente. Confirme novamente se a cotação expirar ou o preço mudar.

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_KEY

Esquemas de autenticação: BearerAuth

Solicitação

Corpo da solicitação · application/json

Tipo
object
Campos obrigatórios
modelprompt
Propriedades adicionais
false

Corpo da solicitação obrigatório

  • modestringOpcional

    Obrigatório em persistent.

    Enumeração
    ["text_to_video","image_to_video"]
  • retentionstringOpcional

    persistent usa o espaço persistente; omitir cria uma tarefa comum.

  • quote_idstringOpcional

    Novas solicitações persistent precisam confirmar antes uma cotação válida de video-quotes.

  • start_frameobjectOpcional

    Obrigató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ório

      ID 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ório

      ID público de arquivo gerenciado da mesma conta e chave.

  • end_frameobjectOpcional

    Quadro final opcional em persistent, se o recurso oferecer suporte.

    Campos filhos de end_frame (1)
    • file_idstringObrigatório

      ID 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ório

      ID público de arquivo gerenciado da mesma conta e chave.

  • webhook_endpoint_idstringOpcional

    Tarefas comuns podem referenciar receptores do console; persistent proíbe.

  • modelstringObrigatório

    ID público do catálogo da chave atual; não garante disponibilidade de modelos históricos do serviço.

  • promptstringObrigatório

    Prompt de geração.

    Comprimento mínimo
    1
    Comprimento máximo
    2500
  • durationintegerOpcional

    Segundos 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_urlstringOpcional

    Quadro inicial HTTPS público específico do modelo para tarefas comuns; proibido em persistent.

  • end_image_urlstringOpcional

    Quadro final HTTPS público específico do modelo para tarefas comuns; proibido em persistent.

  • resolutionstringOpcional

    Resolução do preset do modelo.

  • aspect_ratiostringOpcional

    Proporção do preset do modelo.

  • generate_audiobooleanOpcionalPermite null

    Conforme modelo, política de áudio e presets do modo; não presuma que todos geram áudio.

Respostas e erros

HTTP 200

Cotação de vídeo persistente obtida com sucesso

application/json

Tipo
object
Campos obrigatórios
idexpires_atrequest_hashpricing_kindcurrencyreserved_quotareserved_amountestimated_final_amountsettlement_note
  • idstringObrigatório

    Identificador público do objeto, usado na sua rota de detalhes.

  • expires_atintegerObrigatório

    Expiração em segundos Unix; 0 indica ausência de expiração fixa.

  • request_hashstringObrigatório

    Resumo da solicitação normalizada que vincula cotação e criação; não é a chave de idempotência.

  • pricing_kindstringObrigatório

    Método de preço realmente usado na cotação.

  • currencystringObrigatório

    Moeda da cotação/cobrança.

  • reserved_quotaintegerObrigatório

    Reserva em unidades quota da plataforma, não em USD.

  • reserved_amountstringObrigatório

    Reserva máxima como string na moeda cotada.

  • estimated_final_amountstringObrigatórioPermite null

    Valor final estimado como string; null indica que não pode ser determinado antes da geração.

  • settlement_notestringObrigatório

    Descrição da medição e liquidação reais.

HTTP 400

Campos ou parâmetros de solicitação inválidos.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 401

A chave está ausente, inválida, expirada ou revogada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 403

Permissões insuficientes de IP, conta, modelo ou ferramenta.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 404

Objeto/recurso indisponível ou função desativada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 409

Conflito de idempotência/cotação, objeto não pronto ou ainda referenciado.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 429

Limite de solicitações/fila.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 500

Falha interna de autenticação ou armazenamento de dados.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 503

Serviço, preços ou armazenamento indisponíveis.

application/json

Tipo
object
Campos obrigatórios
error

Notas do endpoint

Estes parâmetros apenas ilustram um preset completo. Copie o preset inteiro (duration, resolution, aspect_ratio, generate_audio) para o model/mode escolhido no catálogo video-models da chave atual; não troque apenas o modelo nem misture presets.

Pronto para criar? Abra console para criar uma chave de API, ou explore recursos.