Guides

Rendu

POST /v1/renders transforme une image de travail (export d’un logiciel 3D, rendu brut) en image photoréaliste, au même cadrage.

curl https://api.renderthink.com/v1/renders \
  -H "Authorization: Bearer $RENDERTHINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://developers.renderthink.com/assets/scenes/sejour-charpente-export.webp", "quality": "2k"}'

Paramètres

Nom	Type	Description
`image`	chaîne	Obligatoire. URL `https://` ou fichier en `multipart/form-data` (voir Images).
`quality`	chaîne	Obligatoire. Résolution de sortie : `1k`, `2k`, `4k` ou `8k` (voir Résolutions).
`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é : renders.

Réponse

La génération terminée, de type render (200) ; avec background: true, la génération en cours (202). L’image produite est dans output[0].url.

Erreurs

Statut	Code	Cause
400	`parameter_invalid`	`quality` absente ou inconnue, ou `metadata` hors limites.
503	`mode_unavailable`	Rendu momentanément indisponible.

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