Skip to main content
POST
cURL
Usa magnific_video_upscaler_creative para aumentar la resolución de un vídeo de origen. La solicitud devuelve un id de tarea para recuperar el resultado finalizado.

Prepara la solicitud

  • Autentícate con tu clave de API de CometAPI.
  • Establece model en magnific_video_upscaler_creative y proporciona videoUri para un vídeo de hasta 30 segundos.
  • Sustituye la URL de vídeo de ejemplo por una URL HTTPS accesible. videoUri también acepta un URI de datos de vídeo Base64 con un tamaño codificado de hasta 5 MB.
  • Elige resolution: 720p, 1k, 2k o 4k. Omite el campo para 2k.

Ajusta la mejora

Omite un control numérico para usar el valor predeterminado del modelo. Un valor de 0 se considera una omisión, por lo que no selecciona explícitamente intensidad cero. Del mismo modo, fpsBoost: false se considera una omisión y no desactiva explícitamente la mejora de la velocidad de fotogramas. Omite los campos opcionales en lugar de enviar null.

Recupera el resultado

Guarda el id devuelto y usa Obtener una tarea de Runway para recuperar el estado de la tarea. Cuando status sea SUCCEEDED, lee las URL del resultado en output. Si la tarea falla, inspecciona failure y failureCode cuando estén presentes.

Autorizaciones

Authorization
string
header
requerido

Your CometAPI API key.

Cuerpo

application/json

Magnific video-upscaling request.

model
enum<string>
requerido

Model ID for this request.

Opciones disponibles:
magnific_video_upscaler_creative
videoUri
requerido

Video to upscale, with a maximum duration of 30 seconds. Use an accessible HTTPS URL or a Base64 data URI with an encoded size of up to 5 MB.

Required string length: 13 - 2048
Pattern: ^https://
resolution
enum<string>

Target output resolution. Omit for 2k.

Opciones disponibles:
720p,
1k,
2k,
4k
creativity
integer

Amount of generated detail to add. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

Rango requerido: 0 <= x <= 100
sharpen
integer

Sharpness intensity. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

Rango requerido: 0 <= x <= 100
smartGrain
integer

Grain and texture enhancement intensity. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

Rango requerido: 0 <= x <= 100
flavor
enum<string>

Processing style: vivid emphasizes color and detail; natural favors faithful reproduction.

Opciones disponibles:
vivid,
natural
fpsBoost
boolean

Set true to request an increased output frame rate. Omit to leave this option unspecified; false is treated as omission.

Respuesta

The task was created. Save its id for task retrieval.

id
string
requerido

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Última modificación el 18 de septiembre de 2026