Aller au contenu
DER.run
Ouvrir le studio

API

API de génération d’images et de vidéos par IA

Les modèles et outils du studio sont accessibles en HTTPS avec une clé API : lisez le catalogue des modèles, soumettez des générations, interrogez leur statut et téléchargez les résultats. Ou branchez DER à votre agent IA via MCP.

Obtenir une clé APIConnecter un agent IA
  • AuthentificationClé API de type Bearer
  • Modèles et outils55 au catalogue
  • InterrogationToutes les 5–30 s
  • Tarifs1 crédit = 0,01 $US

Deux façons de l’utiliser

REST pour le code, MCP pour les agents

API REST

https://api.der.run/v1

Pour votre propre code. Soumettez une génération, interrogez son statut, téléchargez le résultat.

  • GET/v1/capabilitiesChaque modèle avec ses paramètres, ses emplacements d’import, son mode de tarification et son intervalle d’interrogation
  • POST/v1/quotesConnaître le prix d’une génération avant de la soumettre
  • POST/v1/uploadsDémarrer une importation, puis envoyer le fichier par PUT à l’adresse renvoyée
  • POST/v1/uploads/{id}/completeTerminer l’importation et obtenir l’identifiant de ressource à utiliser dans les entrées
  • POST/v1/jobsSoumettre une génération · Idempotency-Key obligatoire
  • GET/v1/jobsVos générations, les plus récentes d’abord, jusqu’à 100 par page
  • GET/v1/jobs/{id}Statut d’une génération
  • GET/v1/jobs/{id}/assets/{index}Télécharger un résultat via un lien privé valable environ une heure

Serveur MCP et skill DER

https://api.der.run/mcp

Pour les agents IA comme Claude Code, Cursor et Codex. Ajoutez l’adresse, connectez-vous avec votre compte DER, puis demandez en langage courant.

  • der_list_modelsModèles, prix et limites
  • der_quoteConnaître le prix d’une tâche avant de la lancer (gratuit)
  • der_create_jobLancer une tâche vidéo, image, AIdol, échange de visage ou musique
  • der_get_jobStatut et liens des résultats
  • der_get_resultsLiens de téléchargement
  • + 13 autres outils dans le serveur MCP
Configurer votre agent IA

Authentification

Une clé, tout votre compte

Envoyez votre clé API comme jeton Bearer. Une clé agit en tant que votre compte : mêmes crédits, même niveau. Les clés sont valables jusqu’à 366 jours ; créez-les et révoquez-les dans « Clés API ». Jusqu’à 10 clés à la fois.

En-tête HTTP
# à chaque requête
Authorization: Bearer der_user_…

Démarrage rapide

Votre première génération en trois étapes

  1. Créer une clé API

    Dans le studio, sous « Clés API ». La clé ne s’affiche qu’une fois : conservez-la en lieu sûr.

    Ouvrir les clés API

  2. Lire le catalogue

    GET /v1/capabilities liste chaque modèle avec ses paramètres, ses emplacements d’import, son mode de tarification et son intervalle d’interrogation.

    Terminal
    curl "https://api.der.run/v1/capabilities" \
  -H "Authorization: Bearer $DER_API_KEY"

  3. Soumettre et interroger

    Importez d’abord votre photo, puis envoyez POST /v1/jobs avec une Idempotency-Key et interrogez GET /v1/jobs/{id} jusqu’à la fin de la génération. Renvoyer la même clé renvoie la même génération.

    Terminal
    curl -X POST "https://api.der.run/v1/jobs" \
  -H "Authorization: Bearer $DER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "der-v2",
    "params": {
      "prompt": "…"
    },
    "inputs": {
      "image": "<asset id>"
    }
  }'

curl "https://api.der.run/v1/jobs/{id}" \
  -H "Authorization: Bearer $DER_API_KEY"

Bon à savoir

Avant de passer en production

  • Les résultats sont privés

    En REST, les résultats se téléchargent avec votre clé : GET /v1/jobs/{id}/assets/{index} vous redirige vers un lien privé valable environ une heure. Il n’y a pas de liens publics, et les outils MCP fournissent le même type de lien. Les résultats et les fichiers importés sont conservés 7 jours, puis supprimés automatiquement.

  • Les listes sont paginées

    GET /v1/jobs renvoie jusqu’à 100 générations, les plus récentes d’abord. Passez next_before dans before pour obtenir les plus anciennes, et filtrez par modèle, type de sortie ou état.

  • Prix

    Certains modèles ont un prix fixe dans le catalogue ; les autres sont tarifés à la soumission. POST /v1/quotes vous indique le prix au préalable.

  • Niveaux

    Certains modèles nécessitent un compte Pro ou Max. Une requête pour l’un d’eux depuis un niveau inférieur reçoit une erreur 403.

  • Mêmes crédits

    L’API dépense les mêmes crédits que le studio. Les crédits des générations échouées sont rendus automatiquement.

  • Interrogez au rythme du modèle

    Chaque modèle a son propre poll_seconds dans le catalogue. Au-delà, les requêtes reçoivent une erreur 429 avec un en-tête Retry-After.

Pour les agents IA

Utiliser DER depuis Claude Code, Cursor ou Codex

Une seule commande pour se connecter. Mêmes modèles, mêmes crédits, et les résultats apparaissent aussi dans le studio.

Ouvrir le guide des agents IA