L'API di intelligenza artificiale per generare immagini con ogni modello

In breve

L'API di generazione di immagini di Mage è un'API REST all'indirizzo https://api.mage.space/v1 che esegue 15 modelli di text-to-image e modifica di immagini, tra cui Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 e Krea 2. Invii un prompt con POST a /{model}/generate, controlli lo stato della richiesta e scarichi l'immagine. Ogni immagine si paga in Gems, senza abbonamento.

• 15

  modelli di immagini

• $0.009

  Prezzo predefinito più basso, per immagine

• 20

  Generazioni simultanee

• $0

  Costo mensile

Modelli

Tutti i modelli di immagini nell'API di Mage

I prezzi sono per generazione, in Gems. 1.000 Gems costano 1 $ con il pacchetto standard, e i pacchetti più grandi aggiungono Gems bonus. Il prezzo dipende da modello, risoluzione e durata; qui è mostrato il prezzo con le impostazioni predefinite, e ogni risposta indica l'addebito esatto in billing.gems_charged. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.

Guida rapida

Genera un'immagine con Anima v1

Imposta MAGE_API_KEY, invia la richiesta e controlla lo stato finché non è completata. Sostituisci anima nell'URL con uno qualsiasi dei modelli qui sopra.

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

Come funziona

Dalla chiave API al media finito in tre chiamate

Tutti i modelli condividono un unico schema di autenticazione, un unico ciclo di vita asincrono delle richieste e gli stessi nomi dei campi.

1. 01

   Crea una chiave API

   Accedi a Mage, apri API → API Keys e crea una chiave. Inizia con mage_sk_ e viene mostrata una sola volta. Un account può avere 10 chiavi attive.

2. 02

   Invia una generazione

   Invia con POST un corpo JSON a https://api.mage.space/v1/{model}/generate con un header Authorization: Bearer. La risposta arriva subito con un request_id, uno status e uno status_url. Aggiungi un header Idempotency-Key così un nuovo tentativo non ti farà mai pagare due volte.

3. 03

   Controlla lo stato e scarica

   Interroga status_url finché lo stato non è completed, failed o cancelled. Una richiesta completata contiene result.url con il file di immagine, video o audio, conservato per 30 giorni.

Pensata per la produzione

Cosa ottiene ogni richiesta all'API di Mage

Casi d'uso

Cosa creano gli sviluppatori con l'API di immagini

FAQ

Domande frequenti

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Correlati

• API per la generazione di video con AI
• API per la generazione di audio con AI
• Server MCP di Mage
• SDK di Mage
• Mage per ComfyUI
• Tutti i modelli API
• Playground API
• Documentazione API