Guida rapida

Non sei ancora pronto per scrivere codice? Prova il Playground — testa qualsiasi modello direttamente nel browser, senza bisogno di una API key.

1. Crea un account

Registrati su runbase.net con Google o email. Nessuna carta di credito richiesta — i nuovi account ricevono balance gratuito per iniziare.

2. Ottieni una API key

Vai su Impostazioni → API Keys e crea una nuova key. Copiala in un posto sicuro — inizia con sk- e non verrà mostrata di nuovo.

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

3. Crea un run

Invia un POST a /api/v1/runs con un model ID e i parametri di input:

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"
    }
  }'

Risposta:

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

Il costUsd è in micro-USD (1 USD = 1,000,000). Un costo di 40,000 significa $0.04.

4. Controlla il risultato

Usa il run ID per verificare lo stato:

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

Quando status è "succeeded", il campo output contiene il risultato:

{
  "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"
}

Se un run fallisce, status sarà "failed" e il costo viene automaticamente rimborsato sul tuo balance.

5. Scarica l'immagine

Gli URL nell'output sono link diretti alle immagini o ai video generati. Sono serviti da una CDN globale e disponibili immediatamente.

E adesso?

• Concetti fondamentali — comprendere il ciclo di vita del run, il modello asincrono e la meccanica dei costi
• Autenticazione — configura il whitelist degli IP e i limiti di spesa per la produzione
• Modelli — esplora tutti i modelli disponibili e provali nel playground
• Billing — ricarica e gestisci il tuo balance