Bien démarrer

Démarrage rapide

Ce guide lance un premier rendu avec une clé de test : l’appel est gratuit et renvoie une image d’exemple en quelques secondes.
  1. Créez un compte et confirmez votre adresse e-mail. Dans la console, créez une organisation, puis une clé de test avec les droits Rendus et Lecture des générations. La clé (rt_test_…) ne s’affiche qu’une fois.
  2. Enregistrez-la dans une variable d’environnement, hors du code source : export RENDERTHINK_API_KEY="rt_test_...".
  3. Envoyez une requête POST /v1/renders avec l’URL publique d’une image de travail (JPEG, PNG ou WebP, 10 Mo au plus) et la résolution de sortie quality.
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"}'
L’API répond à la fin de la génération. En mode réel, comptez en général 1 à 3 minutes : réglez le délai d’attente de votre client HTTP à 5 minutes. En mode test, la génération aboutit en 3 secondes environ et l’API répond 200 (extrait) :
json
{
  "object": "generation",
  "id": "gen_3Wd8KpQ2xLm7Vb9NcT4hRz",
  "type": "render",
  "status": "succeeded",
  "livemode": false,
  "output": [
    {
      "url": "https://…",
      "url_expires_at": 1791454515,
      "content_type": "image/webp",
      "width": 1024,
      "height": 576
    }
  ],
  "cost": { "amount": 23, "currency": "eur", "unit": "cents" }
}
output[0].url est l’URL de l’image produite, valable 15 minutes ; en mode test, c’est une image d’exemple filigranée. cost indique le prix qu’une clé réelle aurait débité. Pour envoyer une image locale, envoyez le fichier dans une requête multipart/form-data (voir Images d’entrée).
Pour passer en mode réel, rechargez le solde et remplacez la clé par une clé rt_live_… (voir Mode test).

Étapes suivantes

  • Générations : réponse synchrone ou en arrière-plan, lecture et annulation.
  • Images d’entrée : envoi par URL ou en fichier, enchaînement de générations.
  • Erreurs : format des erreurs et liste des codes.
  • Idempotence : renvoyer une requête de création sans risque de double débit.