Vérifier les détails de l'organisation

Prérequis : RUNWAYML_API_SECRET doit être disponible pour le processus côté serveur. Ne jamais imprimer ou coller sa valeur.

Interroger l'API Runway pour récupérer les détails de l'organisation de l'utilisateur — solde de crédits, niveau d'utilisation, limites de débit, compteurs de génération quotidiens actuels et utilisation historique des crédits.

Étape 1 : Vérifier que la clé API est disponible

Avant de faire toute demande, confirmer que la clé API est accessible :

1. Vérifier si le projet charge RUNWAYML_API_SECRET depuis son environnement côté serveur.
2. Ou vérifier le shell actuel sans imprimer la valeur : test -n "$RUNWAYML_API_SECRET".

Si la clé n'est pas trouvée, demander à l'utilisateur d'en créer une dans les paramètres du Runway Developer Portal et de l'ajouter à l'environnement côté serveur, puis s'arrêter.

Étape 2 : Interroger les informations de l'organisation

Appeler GET /v1/organization pour récupérer le niveau, le solde de crédits et l'utilisation actuelle de l'organisation.

Node.js

import RunwayML from '@runwayml/sdk';

const client = new RunwayML();
const details = await client.organization.retrieve();
console.log(JSON.stringify(details, null, 2));

Python

from runwayml import RunwayML

client = RunwayML()
details = client.organization.retrieve()
print(details)

cURL / fetch (pas de SDK)

curl -s https://api.dev.runwayml.com/v1/organization \
  -H "Authorization: Bearer $RUNWAYML_API_SECRET" \
  -H "X-Runway-Version: 2024-11-06" | python3 -m json.tool

Forme de la réponse

{
  "tier": {
    "maxMonthlyCreditSpend": 10000,
    "models": {
      "gen4.5": {
        "maxConcurrentGenerations": 2,
        "maxDailyGenerations": 200
      }
    }
  },
  "creditBalance": 5000,
  "usage": {
    "models": {
      "gen4.5": {
        "dailyGenerations": 12
      }
    }
  }
}

Étape 3 : Présenter les résultats

Formater la sortie comme un résumé clair pour l'utilisateur :

## Aperçu de l'organisation

**Solde de crédits :** X crédits (X,XX € à 0,01 €/crédit)
**Plafond de dépense mensuelle :** X crédits

### Limites de débit (par modèle)

| Modèle | Concurrence | Limite quotidienne | Utilisé aujourd'hui | Restant |
|--------|-------------|-------------------|---------------------|---------|
| gen4.5 | 2 | 200 | 12 | 188 |
| veo3.1 | 2 | 100 | 5 | 95 |
| ... | ... | ... | ... | ... |

Points clés à mettre en évidence :

• Solde de crédits — convertir en valeur en euros (crédits × 0,01 €)
• Limites quotidiennes par modèle — montrer combien de générations restent aujourd'hui (fenêtre glissante de 24 heures)
• Concurrence — combien de tâches peuvent s'exécuter simultanément par modèle
• Plafond mensuel — la dépense maximale en crédits par mois pour leur niveau

Étape 4 (Optionnel) : Interroger l'historique d'utilisation des crédits

Si l'utilisateur souhaite voir l'utilisation historique, appeler POST /v1/organization/usage.

Node.js

const usage = await client.organization.retrieveUsage({
  startDate: '2026-02-15',   // ISO-8601, jusqu'à 90 jours en arrière
  beforeDate: '2026-03-17'   // date de fin exclusive
});
console.log(JSON.stringify(usage, null, 2));

Python

usage = client.organization.retrieve_usage(
    start_date="2026-02-15",
    before_date="2026-03-17"
)
print(usage)

cURL / fetch (pas de SDK)

curl -s -X POST https://api.dev.runwayml.com/v1/organization/usage \
  -H "Authorization: Bearer $RUNWAYML_API_SECRET" \
  -H "X-Runway-Version: 2024-11-06" \
  -H "Content-Type: application/json" \
  -d '{"startDate": "2026-02-15", "beforeDate": "2026-03-17"}' \
  | python3 -m json.tool

Forme de la réponse

{
  "results": [
    {
      "date": "2026-03-16",
      "usedCredits": [
        { "model": "gen4.5", "amount": 120 },
        { "model": "veo3.1", "amount": 400 }
      ]
    }
  ],
  "models": ["gen4.5", "veo3.1"]
}

Présenter cela comme une ventilation de l'utilisation :

### Utilisation des crédits (15 fév – 17 mar)

| Date | Modèle | Crédits utilisés |
|------|--------|-----------------|
| 2026-03-16 | gen4.5 | 120 |
| 2026-03-16 | veo3.1 | 400 |
| ... | ... | ... |

**Total :** X crédits

Référence des niveaux

Si l'utilisateur demande à passer à un niveau supérieur, partager la ventilation des niveaux :

Les niveaux montent automatiquement une fois que les conditions de dépense et de temps sont remplies.

Dépannage