API do generowania obrazów AI dla każdego modelu

W skrócie

API Mage do generowania obrazów to REST API pod adresem https://api.mage.space/v1, które uruchamia 15 modeli tekst-na-obraz i edycji obrazów, m.in. Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 i Krea 2. Wysyłasz prompt metodą POST na /{model}/generate, odpytujesz o stan zlecenia i pobierasz obraz. Za każdy obraz płacisz w Gems, bez subskrypcji.

• 15

  modeli obrazów

• $0.009

  Najtańsza cena domyślna za obraz

• 20

  Równoczesne generowania

• $0

  Opłata miesięczna

Modele

Wszystkie modele obrazów w API Mage

Ceny są za jedno generowanie, w Gems. 1000 Gems kosztuje 1 USD w standardowym pakiecie, a większe pakiety dodają bonusowe Gems. Cena zależy od modelu, rozdzielczości i czasu trwania; pokazujemy cenę dla ustawień domyślnych, a dokładną opłatę podaje każda odpowiedź w billing.gems_charged. Nieudane generowanie jest zwracane; zablokowane przez zasady treści Mage — nie.

Szybki start

Wygeneruj obraz z Anima v1

Ustaw MAGE_API_KEY, wyślij żądanie i odpytuj, aż generowanie się zakończy. Zamień anima w adresie URL na dowolny model z powyższych.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('anima', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'anima-v1',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("anima", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "anima-v1",
})

print(request["result"]["url"])

Jak to działa

Od klucza API do gotowego pliku w trzech wywołaniach

Każdy model korzysta z jednego schematu uwierzytelniania, jednego asynchronicznego cyklu żądania i tych samych nazw pól.

1. 01

   Utwórz klucz API

   Zaloguj się do Mage, otwórz API → API Keys i utwórz klucz. Zaczyna się od mage_sk_ i jest wyświetlany tylko raz. Konto może mieć 10 aktywnych kluczy.

2. 02

   Wyślij generację

   Wyślij POST z ciałem JSON na https://api.mage.space/v1/{model}/generate z nagłówkiem Authorization: Bearer. Odpowiedź przychodzi od razu i zawiera request_id, status oraz status_url. Dodaj nagłówek Idempotency-Key, aby ponowienie nigdy nie kosztowało podwójnie.

3. 03

   Sprawdzaj status i pobierz plik

   Odpytuj status_url, aż status zmieni się na completed, failed lub cancelled. Zakończone żądanie zawiera result.url z plikiem obrazu, wideo lub audio, który jest przechowywany przez 30 dni.

Stworzone do produkcji

Co dostaje każde zapytanie do Mage API

Zastosowania

Co deweloperzy budują z API obrazów

FAQ

Najczęściej zadawane pytania

Zacznij tworzyć z Mage

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

Powiązane

• API do generowania wideo AI
• API do generowania audio AI
• Serwer MCP Mage
• SDK Mage
• Mage dla ComfyUI
• Wszystkie modele API
• Playground API
• Dokumentacja API