Guides

Upscaling

POST /v1/upscales fait l’upscaling d’une image sans la transformer, quelle que soit son origine : photo, rendu d’un autre logiciel, ou image produite par une génération (rendu, édition, décoration, upscaling).

curl https://api.renderthink.com/v1/upscales \
  -H "Authorization: Bearer $RENDERTHINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://developers.renderthink.com/assets/scenes/sejour-charpente-rendu.webp", "scale": "x2"}'

Paramètres

Nom	Type	Description
`image`	chaîne	Obligatoire. URL `https://`, dont l’`output[0].url` d’une génération, ou fichier en `multipart/form-data` (voir Images).
`scale`	chaîne	Obligatoire. Facteur : `x2` ou `x4`.
`metadata`	objet	Paires clé-valeur libres, rattachées à la génération et renvoyées avec elle (voir Métadonnées).
`background`	booléen	`true` : réponse immédiate, résultat par webhook ou par lecture (voir Générations).

Droit de la clé : upscales.

Réponse

La génération terminée, de type upscale (200) ; avec background: true, la génération en cours (202). L’image produite est dans output[0].url. input.scale reprend le facteur et input.quality vaut null.

La sortie est en principe en WebP (content_type).

Taille de l’image

La taille de sortie dépend du facteur et des proportions de l’image, pas de sa taille. Les proportions sont conservées.

Format de l’image	Sortie avec `x2`	Sortie avec `x4`
16:9 ou plus allongé	3 840 px de grand côté	7 680 px de grand côté
Plus carré (4:3, 1:1…)	8,4 millions de pixels	33,5 millions de pixels
Exemple 4:3	3 344 × 2 508	6 688 × 5 016

Au moins 256 pixels sur chaque côté.
Au plus, les limites des images (8 192 pixels de côté, 36 millions de pixels), et la sortie doit être plus grande que l’image : une image qui mesure déjà la taille de sortie (3 840 pixels de grand côté en 16:9 avec x2) est refusée, sans débit. Prenez alors x4.
Enchaîner : un rendu 4K en 16:9 ne s’agrandit plus qu’avec x4, et l’image produite par un x2 peut repasser en x4. Un rendu 8K, ou l’image produite par un x4, mesure déjà la sortie maximale : elle ne peut plus être agrandie.
En mode test, l’image produite mesure toujours 1 024 pixels de grand côté : un enchaînement accepté en test peut être refusé en mode réel.
Le prix ne dépend que du facteur, jamais de la taille de l’image reçue.

Erreurs

Statut	Code	Cause
400	`parameter_invalid`	`scale` absent ou inconnu, ou `metadata` hors limites.
400	`image_dimensions_invalid`	Image de moins de 256 pixels de côté, ou déjà aussi grande que la sortie du facteur choisi.
503	`mode_unavailable`	Upscaling momentanément indisponible.

Les erreurs communes à toutes les routes (clé, solde, images, limites) sont dans Erreurs.