Skip to main content
POST
cURL
Utilisez magnific_video_upscaler_creative pour améliorer la résolution d’une vidéo source. La requête renvoie un id de tâche permettant de récupérer la sortie terminée.

Préparer la requête

  • Authentifiez-vous avec votre clé API CometAPI.
  • Définissez model sur magnific_video_upscaler_creative et fournissez videoUri pour une vidéo d’une durée maximale de 30 secondes.
  • Remplacez l’URL de vidéo d’exemple par une URL HTTPS accessible. videoUri accepte également un URI de données vidéo Base64 d’une taille encodée maximale de 5 Mo.
  • Choisissez resolution : 720p, 1k, 2k ou 4k. Omettez le champ pour 2k.

Ajuster l’amélioration

Omettez un contrôle numérique pour utiliser la valeur par défaut du modèle. Une valeur de 0 est considérée comme une omission ; elle ne sélectionne donc pas explicitement une intensité nulle. De même, fpsBoost: false est considéré comme une omission et ne désactive pas explicitement l’amélioration de la fréquence d’images. Omettez plutôt les champs facultatifs que d’envoyer null.

Récupérer le résultat

Enregistrez le id renvoyé et utilisez Obtenir une tâche Runway pour récupérer l’état de la tâche. Lorsque status est SUCCEEDED, lisez les URL des résultats dans output. Si la tâche échoue, examinez failure et failureCode lorsqu’ils sont présents.

Autorisations

Authorization
string
header
requis

Your CometAPI API key.

Corps

application/json

Magnific video-upscaling request.

model
enum<string>
requis

Model ID for this request.

Options disponibles:
magnific_video_upscaler_creative
videoUri
requis

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.

Options 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.

Plage requise: 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.

Plage requise: 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.

Plage requise: 0 <= x <= 100
flavor
enum<string>

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

Options 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.

Réponse

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

id
string
requis

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.

Dernière modification le 18 septembre 2026