De API voor AI-afbeeldingen genereren, met elk model

In één oogopslag

De Mage API voor het genereren van afbeeldingen is een REST API op https://api.mage.space/v1 waarmee je 15 modellen voor tekst-naar-afbeelding en afbeeldingen bewerken gebruikt, waaronder Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 en Krea 2. Je stuurt een POST met een prompt naar /{model}/generate, pollt de aanvraag en downloadt de afbeelding. Elke afbeelding betaal je in Gems, zonder abonnement.

• 15

  afbeeldingsmodellen

• $0.009

  Goedkoopste standaardprijs per afbeelding

• 20

  Gelijktijdige generaties

• $0

  Maandelijkse kosten

Modellen

Alle afbeeldingsmodellen in de Mage API

Prijzen gelden per generatie, in Gems. 1.000 Gems kosten $1 in het standaardpakket, en grotere pakketten bevatten extra Gems. De prijs hangt af van model, resolutie en duur; getoond wordt de prijs bij standaardinstellingen, en elke respons geeft de exacte kosten weer in billing.gems_charged. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.

Snel starten

Genereer een afbeelding met Anima v1

Stel MAGE_API_KEY in, verstuur de aanvraag en poll tot die klaar is. Vervang anima in de URL door een van de modellen hierboven.

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

Zo werkt het

Van API-sleutel tot kant-en-klare media in drie aanroepen

Elk model gebruikt hetzelfde authenticatieschema, dezelfde asynchrone aanvraagcyclus en dezelfde veldnamen.

1. 01

   Maak een API-sleutel aan

   Log in bij Mage, open API → API Keys en maak een sleutel aan. Die begint met mage_sk_ en wordt maar één keer getoond. Een account kan 10 actieve sleutels hebben.

2. 02

   Dien een generatie in

   Stuur een POST met een JSON-body naar https://api.mage.space/v1/{model}/generate met een Authorization: Bearer-header. Het antwoord komt direct terug met een request_id, een status en een status_url. Stuur een Idempotency-Key-header mee, zodat een nieuwe poging nooit dubbel kost.

3. 03

   Poll en download

   Poll status_url tot de status completed, failed of cancelled is. Een voltooid verzoek bevat result.url met het afbeeldings-, video- of audiobestand, dat 30 dagen bewaard blijft.

Gebouwd voor productie

Dit krijgt elke Mage API-aanvraag

Toepassingen

Wat ontwikkelaars bouwen met de afbeeldings-API

FAQ

Veelgestelde vragen

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

Gerelateerd

• API voor AI-video's genereren
• API voor AI-audio genereren
• Mage MCP-server
• Mage SDK's
• Mage voor ComfyUI
• Alle API-modellen
• API-playground
• API-documentatie