Image · Black Forest Labs

Flux API

API Flux per generare immagini con Dev, Pro e 2 Klein e modificare una singola immagine con Dev e Pro.

Operativo · 3 variants · da $0.030

runapi.ai

curl -X POST https://runapi.ai/api/v1/flux/text_to_image \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-dev",
  "prompt": "Genera un’immagine hero di prodotto in 4K di una borraccia nero opaco su una superficie in pietra beige, luce laterale morbida."
}'

import { FluxClient } from "@runapi.ai/flux";

const client = new FluxClient();
const result = await client.textToImage.run({
    model: "flux-dev",
    prompt: "Genera un’immagine hero di prodotto in 4K di una borraccia nero opaco su una superficie in pietra beige, luce laterale morbida.",
});

require "runapi/flux"

client = RunApi::Flux::Client.new
result = client.text_to_image.run(
    model: "flux-dev",
    prompt: "Genera un’immagine hero di prodotto in 4K di una borraccia nero opaco su una superficie in pietra beige, luce laterale morbida."
)

npx skills add runapi-ai/flux -g

# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor

@runapi.ai/flux v1

OVERVIEW

Flux copre produzione di alta qualità, iterazione efficiente e generazione a bassa latenza con tre modelli; la modifica di una singola immagine è disponibile con Dev e Pro.

Più varianti per diversi livelli di velocità / qualità
Il model skill include documentazione, schema e note di setup
Funziona con workflow di sviluppo app
Le generazioni fallite non vengono addebitate

VARIANTS

Confronta tutte le varianti API

Variant	Billing	From
flux-2-klein	call	$0.030	Visualizza →
flux-dev	call	$0.070	Visualizza →
flux-pro	call	$0.100	Visualizza →

SKILLS

Installa lo skill Flux per lo sviluppo di app

Carica documentazione del modello, schema, note prezzi e passaggi di setup nel tuo workspace di codice.

# Install the model skill for app development workflows
npx skills add runapi-ai/flux -g

Installs docs, schemas, pricing context, and setup notes into your developer workspace.

Or use this setup request in your coding tool:

Install the Flux skill for this app:

1. Add runapi-ai/flux with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps when adding model features.
4. Confirm the install path when done.

COME FUNZIONA

Dal model skill al primo risultato in quattro passaggi

Scegli il modello

Seleziona modello e variante adatti al tipo di output, al livello qualità e alla latenza target.

Configura

Imposta la tua chiave RunAPI e installa il model skill nel workspace di codice.

Implementa

Usa le istruzioni dello skill per aggiungere la feature modello dentro la tua applicazione.

Ricevi

Interroga per task ID, usa streaming dove supportato o gestisci il callback webhook.

CONTEXT

Che cos'è l'API Flux?

L'API Flux espone un modello image della famiglia Black Forest Labs. Usata tramite RunAPI, offre API unificata, billing condiviso e un model skill che porta contesto di implementazione nel workspace della tua app.

Provider

Black Forest Labs

Modality

Image

PERCHÉ RUNAPI

Perché usare l'API Flux tramite RunAPI

Un’unica autenticazione, tutti i provider

Una sola chiave RunAPI sblocca l’intero catalogo. Niente account separati, niente rotazione delle chiavi per integrazione.

Prezzi e billing unificati

Prezzi per chiamata in USD, fatturati mensilmente. Le generazioni fallite non vengono addebitate.

Skill con schema

Schema tipizzati e note di setup sono inclusi nel model skill, così l'implementazione parte dal contratto corretto.

FAQ

Domande frequenti

Quale modello Flux dovrei usare?

Usa Flux Dev per iterazioni efficienti, Flux Pro per la massima aderenza al prompt e dettaglio visivo, e Flux 2 Klein per workflow rapidi a bassa latenza.

Flux può modificare un'immagine esistente?

Sì. Con Flux Dev o Flux Pro, l'endpoint remix modifica esattamente un'immagine sorgente accessibile pubblicamente tramite istruzioni testuali e restituisce la stessa struttura di task del testo-immagine.

Da quale variante dovrei iniziare?

Scegli la variante più economica che soddisfa il tuo livello di qualità. La maggior parte dei team inizia con la variante veloce e passa alla pro per la produzione.

C’è un piano gratuito?

I nuovi account ricevono le prime chiamate gratuite su ogni modello. Dopo, paghi per chiamata.

Trasmettete i risultati in streaming?

Dove lo streaming è disponibile, RunAPI trasmette end-to-end.

Come vengono addebitati i fallimenti?

Le generazioni non riuscite non vengono addebitate.

Gli output vengono memorizzati nella cache?

Gli output generati vengono salvati e recuperabili tramite ID del task. Gli input non vengono memorizzati nella cache.

Posso usarlo a fini commerciali?

Sì — l’uso commerciale è incluso per ogni variante, salvo che una licenza del modello lo limiti esplicitamente; in tal caso è indicato nella pagina della variante.

E i limiti di rate limit?

I rate limit per chiave scalano in base al tier di utilizzo. Vedi la pagina prezzi per i limiti aggiornati.

Dove posso segnalare problemi?

Apri un issue nel repo GitHub pubblico oppure scrivi al supporto.