Documentación

Referencia de API

Obtener cotización de vídeo persistente

POST/v1/video-quotes

retention=persistent; cotiza con modos admitidos del catálogo y fotogramas gestionados. Interruptor apagado devuelve 404 directamente. Reconfirma si caduca la cotización o cambia el precio.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Cuerpo de solicitud · application/json

Tipo
object
Campos obligatorios
modelprompt
Propiedades adicionales
false

Cuerpo de solicitud obligatorio

  • modestringOpcional

    Obligatorio en persistent.

    Enumeración
    ["text_to_video","image_to_video"]
  • retentionstringOpcional

    persistent usa el espacio persistente; omitirlo crea una tarea ordinaria.

  • quote_idstringOpcional

    Las nuevas solicitudes persistent deben confirmar primero una cotización válida de video-quotes.

  • start_frameobjectOpcional

    Obligatorio en imagen a vídeo persistent: archivo gestionado de la misma clave. Prohibido en texto a vídeo.

    Campos secundarios de start_frame (1)
    • file_idstringObligatorio

      ID público de archivo gestionado de la misma cuenta y clave.

    Rama allOf 1

    Tipo: object

    Obligatorio en esta rama: file_id

    • file_idstringObligatorio

      ID público de archivo gestionado de la misma cuenta y clave.

  • end_frameobjectOpcional

    Fotograma final opcional en persistent, si la capacidad lo admite.

    Campos secundarios de end_frame (1)
    • file_idstringObligatorio

      ID público de archivo gestionado de la misma cuenta y clave.

    Rama allOf 1

    Tipo: object

    Obligatorio en esta rama: file_id

    • file_idstringObligatorio

      ID público de archivo gestionado de la misma cuenta y clave.

  • webhook_endpoint_idstringOpcional

    Las tareas ordinarias pueden referenciar receptores de consola; persistent lo prohíbe.

  • modelstringObligatorio

    ID público del catálogo de la clave actual; no garantiza disponibilidad de modelos históricos del servicio.

  • promptstringObligatorio

    Prompt de generación.

    Longitud mínima
    1
    Longitud máxima
    2500
  • durationintegerOpcional

    Segundos según modelo; usa la combinación completa de video-models mode.presets, no producto cartesiano. Wan Turbo no admite este campo; sin valor predeterminado uniforme.

  • image_urlstringOpcional

    Fotograma inicial HTTPS público específico del modelo para tareas ordinarias; prohibido en persistent.

  • end_image_urlstringOpcional

    Fotograma final HTTPS público específico del modelo para tareas ordinarias; prohibido en persistent.

  • resolutionstringOpcional

    Resolución del preset del modelo.

  • aspect_ratiostringOpcional

    Relación de aspecto del preset del modelo.

  • generate_audiobooleanOpcionalAdmite null

    Según modelo, política de audio y presets del modo; no supongas que todos generan audio.

Respuestas y errores

HTTP 200

Cotización de vídeo persistente obtenida correctamente

application/json

Tipo
object
Campos obligatorios
idexpires_atrequest_hashpricing_kindcurrencyreserved_quotareserved_amountestimated_final_amountsettlement_note
  • idstringObligatorio

    Identificador público del objeto, usado en su ruta de detalles.

  • expires_atintegerObligatorio

    Caducidad en segundos Unix; 0 indica que no hay caducidad fija.

  • request_hashstringObligatorio

    Resumen de solicitud normalizada que vincula cotización y creación; no es clave de idempotencia.

  • pricing_kindstringObligatorio

    Método de precios usado realmente en la cotización.

  • currencystringObligatorio

    Moneda de cotización/facturación.

  • reserved_quotaintegerObligatorio

    Reserva en unidades quota de la plataforma, no en USD.

  • reserved_amountstringObligatorio

    Reserva máxima como cadena en la moneda cotizada.

  • estimated_final_amountstringObligatorioAdmite null

    Importe final estimado como cadena; null indica que no puede determinarse antes de generar.

  • settlement_notestringObligatorio

    Descripción de medición y liquidación reales.

HTTP 400

Campos o parámetros de solicitud inválidos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 404

Objeto/capacidad no disponible o función desactivada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 409

Conflicto de idempotencia/cotización, objeto no preparado o aún referenciado.

application/json

Tipo
object
Campos obligatorios
error

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 503

Servicio, precios o almacenamiento no disponibles.

application/json

Tipo
object
Campos obligatorios
error

Notas del endpoint

Estos parámetros solo ilustran un preset completo. Copia el preset entero (duration, resolution, aspect_ratio, generate_audio) para el model/mode elegido del catálogo video-models de la clave actual; no sustituyas solo el modelo ni mezcles presets.