API développeur | YouThumbAI Documentation

Bienvenue dans l’API développeur de YouThumbAI. Cette API REST te permet d’intégrer la génération de miniatures par IA directement dans tes applications, d’automatiser tes workflows et de créer des intégrations sur mesure.

URL de base

Toutes les requêtes API sont envoyées à :

https://youthumb.ai/api

Obtenir ta clé API

Pour utiliser l’API, il te faut une clé API. Voici comment l’obtenir :

Ouvre Clés API

Va dans Compte → Clés API

Crée une nouvelle clé

Clique sur le bouton Créer une clé API et donne à ta clé un nom explicite.

Copie ta clé

Copie ta clé API tout de suite. Pour des raisons de sécurité, elle n’est affichée qu’une seule fois.

Attention sécurité : n’expose jamais ta clé API dans du code côté client, un dépôt public ou du JavaScript exécuté dans le navigateur. Utilise toujours des variables d’environnement et des requêtes côté serveur.

Démarrage rapide

Voici un exemple minimal pour créer et générer une miniature :

bash

# 1. Créer un projet de miniature
curl -X POST https://youthumb.ai/api/thumbnails \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Excited creator with bright yellow background"}'

# Réponse : { "success": true, "data": { "projectId": "abc-123", ... } }

# 2. Lancer la génération
curl -X POST https://youthumb.ai/api/thumbnails/abc-123/start \
  -H "x-api-key: your_api_key"

# 3. Interroger le statut jusqu'à la fin
curl https://youthumb.ai/api/thumbnails/abc-123/status \
  -H "x-api-key: your_api_key"

Format des réponses

Toutes les réponses de l’API suivent le même format : Réponse en cas de succès :

json

{
  "success": true,
  "data": { ... }
}

Réponse en cas d’erreur :

json

{
  "success": false,
  "error": "Error message",
  "details": { ... }  // Optionnel : erreurs de validation
}

API disponibles

API	Description
Thumbnails	Créer et générer des miniatures par IA
Persons	Gérer les profils de visage pour la personnalisation
Templates	Parcourir les templates de référence de style
Presets	Accéder aux presets de style prédéfinis
Assets	Importer et gérer des images (visages, templates, fichiers temporaires)

Limites de débit

Les requêtes API sont limitées selon ton abonnement. Si tu dépasses la limite, tu reçois une réponse 429 Too Many Requests.

Et ensuite ?

Authentification

Découvre les méthodes d’authentification et les bonnes pratiques.

API Thumbnails

Explore l’API Thumbnails pour commencer à générer des miniatures.

Besoin d’aide ? Contacte notre support ou consulte la référence des codes d’erreur pour le dépannage.