Saltar al contenido principal
POST
API gemini-omni-1.2-flash-video-upscale

Autorizaciones

Authorization
string
header
requerido

##Todas las APIs requieren autenticacion Bearer Token##

Obtener API Key:

Visita la Pagina de gestion de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Cuerpo

application/json
model
enum<string>
predeterminado:gemini-omni-1.2-flash-video-upscale
requerido

Nombre del modelo, fijo en gemini-omni-1.2-flash-video-upscale.

Opciones disponibles:
gemini-omni-1.2-flash-video-upscale
Ejemplo:

"gemini-omni-1.2-flash-video-upscale"

video_urls
string<uri>[]
requerido

Array de vídeos para aumentar la resolución; obligatorio, exactamente 1 vídeo. Solo URL HTTP/HTTPS, formato mp4, hasta 15 segundos. Tamaños admitidos: 640×360, 1280×720, 1920×1080, o verticales 360×640, 720×1280, 1080×1920.

Required array length: 1 element
Ejemplo:
quality
enum<string>
requerido

Resolución de destino; obligatoria y superior a la de entrada.

  • Entrada 360p: 720p, 1080p.
  • Entrada 720p: 1080p, 4k.
  • Entrada 1080p: 4k.

Facturación: Se factura según el uso real de tokens de vídeo de salida, sin cargos por tokens de entrada ni de razonamiento. Los tokens de salida dependen de la duración del vídeo de entrada y de la combinación de resoluciones de entrada y destino. El importe al enviar la solicitud es una estimación; la facturación final se basa en el uso real.

Opciones disponibles:
720p,
1080p,
4k
Ejemplo:

"1080p"

duration
enum<string>
predeterminado:auto

Se puede omitir; si se envía, solo admite auto. La duración de salida sigue la del vídeo de entrada. No se puede especificar una duración en segundos.

Opciones disponibles:
auto
Ejemplo:

"auto"

aspect_ratio
enum<string>
predeterminado:auto

Se puede omitir; si se envía, solo admite auto. La relación de aspecto de salida sigue la del vídeo de entrada. No se pueden especificar otras relaciones de aspecto.

Opciones disponibles:
auto
Ejemplo:

"auto"

seed
integer

Semilla aleatoria; aleatoria por defecto. Rango: 0–4294967295. Una semilla fija mejora la reproducibilidad.

Rango requerido: 0 <= x <= 4294967295
Ejemplo:

42

callback_url
string<uri>

Direccion de callback HTTPS despues de completar la tarea

Momento del callback:

  • Se activa cuando la tarea se completa (completed), falla (failed) o se cancela (cancelled)
  • Se envia despues de completar la confirmacion de facturacion

Restricciones de seguridad:

  • Solo se admite el protocolo HTTPS
  • El callback a direcciones IP internas esta prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

  • Tiempo de espera: 10 segundos
  • Maximo 3 reintentos en caso de fallo (reintentos despues de 1 segundo/2 segundos/4 segundos)
  • El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
  • La direccion de callback que devuelve un codigo de estado 2xx se considera exitosa, otros codigos de estado activaran reintentos
Ejemplo:

"https://your-domain.com/webhooks/video-task-completed"

Respuesta

Tarea de video creada exitosamente

created
integer

Marca de tiempo de creacion de la tarea

Ejemplo:

1757169743

id
string

ID de tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

model
string

Nombre del modelo real utilizado

Ejemplo:

"gemini-omni-1.2-flash-video-upscale"

object
enum<string>

Tipo de tarea especifico

Opciones disponibles:
video.generation.task
progress
integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100
Ejemplo:

0

status
enum<string>

Estado de la tarea. El endpoint de creación siempre devuelve processing; el estado interno pending también se presenta a los clientes como processing.

Opciones disponibles:
pending,
processing,
completed,
failed
Ejemplo:

"processing"

task_info
object

Informacion detallada de la tarea de video

type
enum<string>

Tipo de salida de la tarea

Opciones disponibles:
text,
image,
audio,
video
Ejemplo:

"video"

usage
object

Informacion de uso y facturacion