Treci la conținut

Mage API · Model de imagine

API Flux 2

Prompturi lungi și editări cu mai multe referințe

POST https://api.mage.space/v1/flux2/generate

Pe scurt

API-ul Flux 2 rulează Flux 2 prin Mage la POST https://api.mage.space/v1/flux2/generate. O cerere cu setările implicite costă 40 de Gems (aproximativ 0,04 $), fără abonament. Flux 2 nu acceptă mențiuni @handle.

  • ImagineRezultat
  • 1Variantă
  • 40Gems per imagine, implicit
  • $0.04Aproximativ, în USD

Prezentare generală

Ce face API-ul Flux 2

Flux 2 Dev, modelul open-weights care excelează cu prompturi lungi și detaliate. Generează sau editează pornind de la cel mult 3 imagini de referință, până la 2K.

Flux 2 Dev, un model open-weights pentru prompturi lungi și detaliate, generare și editări pornind de la cel mult trei imagini de referință.

Acceptă ca intrări image, additional_images.

Pornire rapidă

Apelează API-ul Flux 2

Setează MAGE_API_KEY, trimite cererea la /flux2/generate și interoghează status_url până când cererea se finalizează.

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"])

Modele

Valori model_id pentru Flux 2

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
flux2-devFlux 2Da

Opțiuni

Parametri Flux 2

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Intrări

Fișierele media acceptate de Flux 2

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

  • Imagine · de la 9 Gems

    API GPT Image 2

    Prompturi precise și text lizibil

  • Imagine · de la 75 Gems

    API Grok Image

    Grok Imagine, în trei niveluri de calitate

  • Imagine · de la 37 de Gems

    API Guava

    Fotorealism care trece drept fotografie

  • Imagine · de la 20 Gems

    API HiDream

    Rapid și versatil, cu prompturi negative

  • Imagine · de la 20 Gems

    API Krea 2

    Estetică spectaculoasă în câteva secunde

  • Imagine · de la 135 de Gems

    API Mango

    Familia noastră principală de modele de imagine

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Flux 2?
O cerere Flux 2 cu setările implicite (Flux 2) costă 40 de Gems, adică aproximativ 0,04 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică suma exactă taxată. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Flux 2?
POST https://api.mage.space/v1/flux2/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi periodic pentru a afla rezultatul.
Ce modele Flux 2 pot apela?
flux2-dev. Modelul implicit este Flux 2.
Flux 2 acceptă imagini de referință sau personaje?
Flux 2 acceptă image, additional_images. Flux 2 nu acceptă mențiuni @handle.
Pot folosi Flux 2 din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Flux 2 pe nume. Asistentul tău își citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Flux 2?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.