API di Mage · Modello per immagini
API di Flux 2
Prompt lunghi e modifiche con più riferimenti
POST https://api.mage.space/v1/flux2/generateIn breve
L'API di Flux 2 esegue Flux 2 tramite Mage su POST https://api.mage.space/v1/flux2/generate. Una richiesta con le impostazioni predefinite costa 40 Gems (circa $0,04), senza abbonamento. Flux 2 non accetta menzioni @handle.
- ImmagineOutput
- 1Variante
- 40Gems per immagine, predefinito
- $0.04Circa, in USD
Panoramica
Cosa fa l'API di Flux 2
Flux 2 Dev, il modello open-weights che dà il meglio con prompt lunghi e dettagliati. Genera o modifica a partire da un massimo di 3 immagini di riferimento, fino a 2K.
Flux 2 Dev, un modello open-weights per prompt lunghi e dettagliati, generazione e modifiche a partire da un massimo di tre immagini di riferimento.
Accetta come input image, additional_images.
Guida rapida
Chiama l'API di Flux 2
Imposta MAGE_API_KEY, invia a /flux2/generate e interroga status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/flux2/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "flux2-dev"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('flux2', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'flux2-dev',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("flux2", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "flux2-dev",
})
print(request["result"]["url"])Modelli
Valori model_id di Flux 2
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| flux2-dev | Flux 2 | Sì |
Opzioni
Parametri di Flux 2
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
Input
Input multimediali accettati da Flux 2
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
Altri modelli di immagini
Altre API di generazione di immagini su Mage
API GPT Image 2
Prompt precisi e testo leggibile
API Grok Image
Grok Imagine, in due livelli
API Guava
Un fotorealismo che sembra una vera fotografia
API HiDream
Veloce e versatile, con prompt negativi
API di Krea 2
Estetica stupenda in pochi secondi
API Mango
La nostra famiglia di modelli immagine di punta
FAQ
Domande frequenti
Quanto costa l'API di Flux 2?
Qual è l'endpoint dell'API di Flux 2?
Quali modelli Flux 2 posso chiamare?
Flux 2 supporta immagini di riferimento o personaggi?
Posso usare Flux 2 da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di Flux 2?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.