Mage API · Model obrazu

Flux 2 API

Długie prompty i edycje z wielu referencji

Zdobądź klucz APIWypróbuj Flux 2 w playground
POST https://api.mage.space/v1/flux2/generate

W skrócie

Flux 2 API uruchamia Flux 2 przez Mage pod adresem POST https://api.mage.space/v1/flux2/generate. Żądanie z ustawieniami domyślnymi kosztuje 40 Gems (około 0,04 USD), bez subskrypcji. Flux 2 nie obsługuje wzmianek @handle.

Przegląd

Co robi Flux 2 API

Flux 2 Dev, model open-weights, który świetnie radzi sobie z długimi, szczegółowymi promptami. Generuje lub edytuje na podstawie maksymalnie 3 obrazów referencyjnych, do 2K.

Flux 2 Dev, model open-weights do długich, szczegółowych promptów, generowania i edycji na podstawie maksymalnie trzech obrazów referencyjnych.

Przyjmuje dane wejściowe: image, additional_images.

Szybki start

Wywołaj Flux 2 API

Ustaw MAGE_API_KEY, wyślij żądanie do /flux2/generate i odpytuj status_url, aż żądanie się zakończy.

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

Wartości model_id dla Flux 2

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
flux2-devFlux 2Tak

Opcje

Parametry Flux 2

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Dane wejściowe

Pliki multimedialne akceptowane przez Flux 2

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.

Więcej modeli obrazów

Inne API do generowania obrazów w Mage

Obraz · od 9 Gems

GPT Image 2 API

Precyzyjne prompty i czytelny tekst

Obraz · od 75 Gems

Grok Image API

Grok Imagine w trzech poziomach jakości

Obraz · od 37 Gems

Guava API

Fotorealizm, który uchodzi za prawdziwe zdjęcie

Obraz · od 20 Gems

HiDream API

Szybki i wszechstronny, z negatywnymi promptami

Obraz · od 20 Gems

Krea 2 API

Zachwycająca estetyka w kilka sekund

Obraz · od 135 Gems

Mango API

Nasza flagowa rodzina modeli obrazu

FAQ

Najczęściej zadawane pytania

Ile kosztuje Flux 2 API?

Żądanie do Flux 2 z ustawieniami domyślnymi (Flux 2) kosztuje 40 Gems, czyli około 0,04 USD. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną kwotę podaje odpowiedź. Za nieudane generowanie dostajesz zwrot, a za zablokowane przez zasady dotyczące treści Mage — nie.

Jaki jest endpoint Flux 2 API?

POST https://api.mage.space/v1/flux2/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.

Jakich modeli Flux 2 mogę używać?

flux2-dev. Domyślny to Flux 2.

Czy Flux 2 obsługuje obrazy referencyjne lub postacie?

Flux 2 przyjmuje image, additional_images. Flux 2 nie obsługuje wzmianek @handle.

Czy mogę używać Flux 2 w Claude lub ChatGPT?

Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Flux 2 po nazwie. Twój asystent odczyta opcje przez get_model i poda cenę przed generowaniem.

Jak długo przechowywane są wyniki Flux 2?

Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Zdobądź klucz APIWypróbuj Flux 2 w playground

Powiązane