Démarrage rapide

Pas encore prêt à écrire du code ? Essayez le Playground — testez n’importe quel modèle directement dans votre navigateur, sans clé API nécessaire.

1. Créez un compte

Inscrivez-vous sur runbase.net avec Google ou une adresse e-mail. Aucune carte de crédit requise — les nouveaux comptes reçoivent un solde gratuit pour démarrer.

2. Obtenez une clé API

Allez dans Paramètres → Clés API et créez une nouvelle clé. Copiez-la dans un endroit sûr — elle commence par sk- et ne sera plus affichée.

export RUNBASE_API_KEY="sk-your-key-here"

3. Créez une exécution

Envoyez un POST à /api/v1/runs avec un ID de modèle et des paramètres d’entrée :

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cozy bookshop interior with warm lighting, watercolor style",
      "aspect_ratio": "1:1"
    }
  }'

Réponse :

{
  "id": "run_2abc...",
  "model": "google/nano-banana-2",
  "status": "pending",
  "costUsd": 40000
}

Le costUsd est en micro-USD (1 USD = 1,000,000). Un coût de 40,000 signifie 0,04 $.

4. Interrogez pour obtenir le résultat

Utilisez l’ID d’exécution pour vérifier le statut :

curl -s https://runbase.net/api/v1/runs/run_2abc... \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Lorsque status est "succeeded", le champ output contient le résultat :

{
  "id": "run_2abc...",
  "status": "succeeded",
  "model": "google/nano-banana-2",
  "costUsd": 40000,
  "output": {
    "urls": [
      "https://runbase.net/files/generated/abc123.png"
    ]
  },
  "createdAt": "2026-06-01T12:00:00.000Z",
  "completedAt": "2026-06-01T12:00:04.200Z"
}

Si une exécution échoue, status sera "failed" et le coût sera automatiquement remboursé sur votre solde.

5. Téléchargez l’image

Les URLs dans la sortie sont des liens directs vers les images ou vidéos générées. Elles sont servies depuis un CDN mondial et disponibles immédiatement.

Et ensuite

• Concepts de base — comprendre le cycle de vie d’une exécution, le modèle asynchrone et les mécanismes de coût
• Authentification — configurer la liste blanche d’IP et les limites de dépenses pour la production
• Modèles — explorer tous les modèles disponibles et les essayer dans le playground
• Facturation — recharger et gérer votre solde