Flux 2 API
Text-to-image and remix-image with strong prompt adherence from Black Forest Labs.
curl -X POST https://runapi.ai/api/v1/flux_2/remix_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-flex-text-to-image",
"prompt": "Generate a photorealistic studio portrait of an astronaut holding a cat, dramatic rim lighting, fine detail."
}'
import { Flux2Client } from "@runapi.ai/flux-2";
const client = new Flux2Client();
const result = await client.remixImage.run({
model: "flux-2-flex-text-to-image",
prompt: "Generate a photorealistic studio portrait of an astronaut holding a cat, dramatic rim lighting, fine detail.",
});
<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Flux2\Flux2Client;
$client = new Flux2Client();
$result = $client->remixImage->run([
'model' => 'flux-2-flex-text-to-image',
'prompt' => 'Generate a photorealistic studio portrait of an astronaut holding a cat, dramatic rim lighting, fine detail.',
]);
require "runapi/flux_2"
client = RunApi::Flux2::Client.new
result = client.remix_image.run(
model: "flux-2-flex-text-to-image",
prompt: "Generate a photorealistic studio portrait of an astronaut holding a cat, dramatic rim lighting, fine detail."
)
npx skills add runapi-ai/flux-2 -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
Flux 2 is Black Forest Labs' text-to-image and image remix model known for strong prompt adherence and high visual fidelity. Its pro tier auto-enhances prompts, while the flex tier exposes manual control over inference steps and guidance.
- 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
Confronta tutte le varianti API
| Variant | Billing | From | |
|---|---|---|---|
| flux-2-flex-remix-image | call | $0.140 | Visualizza → |
| flux-2-flex-text-to-image | call | $0.140 | Visualizza → |
| flux-2-pro-remix-image | call | $0.050 | Visualizza → |
| flux-2-pro-text-to-image | call | $0.050 | Visualizza → |
Installa lo skill Flux 2 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-2 -g
Install the Flux 2 skill for this app: 1. Add runapi-ai/flux-2 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.
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.
Che cos'è l'API Flux 2?
Flux 2 is Black Forest Labs' generation model, delivering high prompt adherence across text-to-image and remix-image tasks. Through RunAPI, Pro and Flex variants share the same API shape.
Perché usare l'API Flux 2 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.
Domande frequenti
What is the difference between Pro and Flex?
Pro is the flagship tier with automatic prompt enhancement. Flex gives you control over inference steps and guidance, and supports up to 8 reference images.
How strong is prompt adherence?
Flux 2 is specifically known for strong prompt adherence — it follows detailed descriptions including spatial relationships, colors, and object counts more faithfully than most models.
Does Flux 2 support remix-image?
Yes — both Pro and Flex have dedicated remix-image variants that use source images as style or content seeds.
What is automatic prompt enhancement?
The Pro variant automatically refines your prompt for better visual results. This is a zero-config feature — no extra parameters needed.
How does Flux 2 compare to Flux Kontext?
Flux 2 is for generating new images from prompts or remixing source images. Flux Kontext is for editing existing images with contextual awareness.
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.