Přeskočit na obsah

Mage API · Model pro obrázky

Flux 2 API

Dlouhé prompty a úpravy s více referencemi

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

Stručně

Flux 2 API spouští Flux 2 přes Mage na POST https://api.mage.space/v1/flux2/generate. Požadavek s výchozím nastavením stojí 40 Gems (asi 0,04 $), bez předplatného. Flux 2 nepodporuje zmínky @handle.

  • ObrázekVýstup
  • 1Varianta
  • 40Gems za obrázek, výchozí
  • $0.04Přibližně v USD

Přehled

Co umí Flux 2 API

Flux 2 Dev, model s otevřenými váhami, kterému sedí dlouhé a podrobné prompty. Generuje nebo upravuje až ze 3 referenčních obrázků, až do 2K.

Flux 2 Dev, model s otevřenými váhami pro dlouhé a podrobné prompty, generování a úpravy až ze tří referenčních obrázků.

Jako vstupy přijímá image, additional_images.

Rychlý start

Volání Flux 2 API

Nastav MAGE_API_KEY, odešli požadavek na /flux2/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro Flux 2

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
flux2-devFlux 2Ano

Možnosti

Parametry Flux 2

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Vstupy

Mediální vstupy, které Flux 2 přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.

Další modely pro obrázky

Další API pro generování obrázků na Mage

  • Obrázek · od 9 Gems

    GPT Image 2 API

    Přesné prompty a čitelný text

  • Obrázky · od 75 Gems

    Grok Image API

    Grok Imagine ve třech úrovních kvality

  • Obrázek · od 37 Gems

    Guava API

    Fotorealismus, který projde jako fotografie

  • Obrázky · od 20 Gems

    HiDream API

    Rychlý a univerzální, s negativními prompty

  • Obrázky · od 20 Gems

    Krea 2 API

    Nádherná estetika během pár sekund

  • Obrázek · od 135 Gems

    Mango API

    Naše vlajková řada obrázkových modelů

Časté dotazy

Často kladené otázky

Kolik stojí Flux 2 API?
Požadavek na Flux 2 s výchozím nastavením (Flux 2) stojí 40 Gems, asi 0,04 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku najdeš v odpovědi. Neúspěšné generování se vrací; generování zablokované pravidly obsahu Mage ne.
Jaký je endpoint Flux 2 API?
POST https://api.mage.space/v1/flux2/generate s hlavičkou Authorization: Bearer s tvým API klíčem Mage. Odpověď obsahuje status_url, na které se můžeš dotazovat, dokud nebude výsledek hotový.
Které modely Flux 2 můžu volat?
flux2-dev. Výchozí je Flux 2.
Podporuje Flux 2 referenční obrázky nebo postavy?
Flux 2 přijímá image, additional_images. Flux 2 nepodporuje zmínky @handle.
Můžu Flux 2 používat z Claude nebo ChatGPT?
Ano. Připoj Mage MCP server ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Flux 2 jeho názvem. Asistent si přečte jeho možnosti přes get_model a před generováním uvede cenu.
Jak dlouho se výsledky z Flux 2 uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.