Μετάβαση στο περιεχόμενο

Mage API · Μοντέλο εικόνας

Flux 2 API

Μεγάλα prompts και επεξεργασίες με πολλαπλές αναφορές

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

Με μια ματιά

Το Flux 2 API εκτελεί το Flux 2 μέσω του Mage στο POST https://api.mage.space/v1/flux2/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 40 Gems (περίπου $0.04), χωρίς συνδρομή. Το Flux 2 δεν δέχεται αναφορές @handle.

  • ΕικόναΈξοδος
  • 1Παραλλαγή
  • 40Gems ανά εικόνα, προεπιλογή
  • $0.04Περίπου, σε USD

Επισκόπηση

Τι κάνει το Flux 2 API

Flux 2 Dev, το μοντέλο ανοιχτών βαρών που ξεχωρίζει με μεγάλα, αναλυτικά prompts. Δημιουργεί ή επεξεργάζεται από έως 3 εικόνες αναφοράς, έως 2K.

Flux 2 Dev, ένα μοντέλο ανοιχτών βαρών για μεγάλα, αναλυτικά prompts, δημιουργία και επεξεργασία από έως τρεις εικόνες αναφοράς.

Δέχεται ως εισόδους τα image, additional_images.

Γρήγορη εκκίνηση

Κάλεσε το Flux 2 API

Όρισε το MAGE_API_KEY, στείλε το αίτημα στο /flux2/generate και έλεγχε το status_url μέχρι να ολοκληρωθεί το αίτημα.

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

Μοντέλα

Τιμές model_id του Flux 2

Στείλε το model_id για να διαλέξεις παραλλαγή. Ένα αίτημα χωρίς αυτό εκτελεί την προεπιλεγμένη.

model_idΌνομαΠροεπιλογή
flux2-devFlux 2Ναι

Επιλογές

Παράμετροι του Flux 2

Οι τιμές που επιτρέπονται σε όλες τις παραλλαγές· μια παραλλαγή μπορεί να προσφέρει λιγότερες. Τα docs αναφέρουν τις επιλογές ανά παραλλαγή.

ΠεδίοΤιμές
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

Είσοδοι

Είσοδοι πολυμέσων που δέχεται το Flux 2

Στείλε κάθε αρχείο ως https URL, ως data URL ή ως ανέβασμα έως 100 MB.

ΠεδίοΡόλος
imageΗ εικόνα αναφοράς.
additional_imagesΠρόσθετες εικόνες αναφοράς.

Περισσότερα μοντέλα εικόνας

Άλλα API δημιουργίας εικόνων στο Mage

  • Εικόνα · από 9 Gems

    GPT Image 2 API

    Ακριβή prompt και ευανάγνωστο κείμενο

  • Εικόνα · από 75 Gems

    Grok Image API

    Grok Imagine, σε τρία επίπεδα ποιότητας

  • Εικόνα · από 37 Gems

    Guava API

    Φωτορεαλισμός που περνά για φωτογραφία

  • Εικόνα · από 20 Gems

    HiDream API

    Γρήγορο και ευέλικτο, με αρνητικά prompt

  • Εικόνα · από 20 Gems

    Krea 2 API

    Εντυπωσιακή αισθητική σε δευτερόλεπτα

  • Εικόνα · από 135 Gems

    Mango API

    Η κορυφαία οικογένεια μοντέλων εικόνας μας

Συχνές ερωτήσεις

Συχνές ερωτήσεις

Πόσο κοστίζει το Flux 2 API;
Ένα αίτημα Flux 2 με τις προεπιλεγμένες ρυθμίσεις (Flux 2) κοστίζει 40 Gems, περίπου $0.04. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απόκριση δείχνει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, η χρέωση επιστρέφεται· αν την μπλοκάρει η πολιτική περιεχομένου του Mage, δεν επιστρέφεται.
Ποιο είναι το endpoint του Flux 2 API;
POST https://api.mage.space/v1/flux2/generate με κεφαλίδα Authorization: Bearer που περιέχει το κλειδί API του Mage. Η απόκριση περιλαμβάνει ένα status_url, το οποίο ελέγχεις επαναλαμβανόμενα μέχρι να βγει το αποτέλεσμα.
Ποια μοντέλα Flux 2 μπορώ να καλέσω;
flux2-dev. Το προεπιλεγμένο είναι το Flux 2.
Υποστηρίζει το Flux 2 εικόνες αναφοράς ή χαρακτήρες;
Το Flux 2 δέχεται image, additional_images. Το Flux 2 δεν δέχεται αναφορές @handle.
Μπορώ να χρησιμοποιήσω το Flux 2 από το Claude ή το ChatGPT;
Ναι. Σύνδεσε τον διακομιστή Mage MCP με το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor και ζήτα το Flux 2 με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με το get_model και αναφέρει την τιμή πριν δημιουργήσει.
Για πόσο καιρό διατηρούνται τα αποτελέσματα του Flux 2;
Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

Ξεκίνα να δημιουργείς με το Mage

Ένας λογαριασμός, ένα υπόλοιπο Gems, όλα τα μοντέλα. Πληρώνεις μόνο για ό,τι δημιουργείς.