De API voor AI-video's genereren, vanuit tekst of afbeeldingen

In één oogopslag

De videogeneratie-API van Mage is een REST API op https://api.mage.space/v1 die 12 tekst-naar-video- en afbeelding-naar-videomodellen draait, waaronder Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video en Wan. Stuur een prompt en optioneel frames of referenties, vraag de status van het verzoek op en download een MP4. Elke clip betaal je in Gems, afhankelijk van model, resolutie en duur.

• 12

  videomodellen

• $0.02

  Goedkoopste standaard, per clip

• 20

  Gelijktijdige generaties

• $0

  Maandelijkse kosten

Modellen

Alle videomodellen 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 video met Berry 2

Stel MAGE_API_KEY in, verstuur het verzoek en blijf de status opvragen tot het klaar is. Vervang berry in de URL door een van de modellen hierboven.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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 video-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-afbeeldingen genereren
• API voor AI-audio genereren
• Mage MCP-server
• Mage SDK's
• Mage voor ComfyUI
• Alle API-modellen
• API-playground
• API-documentatie