Modelli

Runbase offre accesso ai migliori modelli di generazione di immagini e video di più provider tramite una singola API.

Sfogliare i modelli

Visita la pagina Models per vedere tutti i modelli disponibili con prezzi, capacità ed esempi di output. Ogni modello ha una pagina di dettaglio dedicata con:

• Playground — prova il modello nel tuo browser prima di scrivere qualsiasi codice
• Pricing — costo per esecuzione o per secondo
• Examples — output di esempio con prompt
• API reference — parametri di input specifici del modello ed esempi di codice

Playground

Ogni pagina del modello include in alto un Playground interattivo. Accedi, inserisci un prompt e fai clic su Run model per vedere il risultato in pochi secondi. È il modo più rapido per valutare qualità e velocità di un modello prima di integrarlo nella tua applicazione.

Formato dell'ID del modello

Ogni modello ha un ID nel formato provider/model-name, ad esempio:

• openai/gpt-image-2 — generazione di immagini
• bytedance/seedance-2 — generazione di video
• google/veo-3 — generazione di video

L'elenco completo dei modelli disponibili e dei loro ID è sulla pagina Models. I modelli vengono aggiunti regolarmente — controlla lì per gli aggiornamenti più recenti.

Parametri di input

Ogni modello definisce il proprio schema di input. I parametri comuni includono:

• prompt (string) — descrizione testuale di cosa generare
• aspect_ratio (string) — dimensioni dell'output, ad es. "1:1", "16:9"
• quality (string) — livello di qualità della generazione
• image_urls (string[]) — URL delle immagini di riferimento (dove supportato)

Consulta la pagina di dettaglio di ciascun modello per lo schema completo di input e le opzioni disponibili.

Usare un modello

Passa l'ID del modello e l'oggetto di input all'endpoint create run:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

Se passi un ID di modello non valido, riceverai un errore 400 model_not_found. Se l'input non corrisponde allo schema del modello, riceverai 400 invalid_input con una descrizione del problema.

Modelli di immagini vs. video

• Image models restituiscono uno o più URL di immagini in output.urls. Il tempo di generazione varia in base al modello, al carico del provider e alla complessità dell'input.
• Video models restituiscono un URL del video in output.urls. Il tempo di generazione varia in base al modello, alla durata, alla risoluzione e al carico del provider.

La struttura dell'API è identica per entrambi — l'unica differenza è a cosa puntano gli URL di output.