Mage API · Videogeneratie
De API voor AI-video's genereren, vanuit tekst of afbeeldingen
Tekst-naar-video, afbeelding-naar-video, eerste-en-laatste-frame en referentie-naar-video met 15 modellen, aangevoerd door Mages vlaggenschip Cherry 2 Pro, met audio bij veel clips.
POST https://api.mage.space/v1/{model}/generateIn één oogopslag
De Mage API voor videogeneratie is een REST API op https://api.mage.space/v1 met 15 tekst-naar-video- en afbeelding-naar-videomodellen, waaronder Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video en Wan. Stuur een prompt en eventueel frames of referenties in, vraag de status van het verzoek op en download een MP4. Elke clip betaal je in Gems, afhankelijk van model, resolutie en duur.
- 15videomodellen
- $0.02Goedkoopste standaard, per clip
- 20Gelijktijdige generaties
- $0Maandelijkse 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.
| Model | Het meest geschikt voor | model_id-waarden | Standaardprijs |
|---|---|---|---|
| Berry | Video die trouw blijft aan je referenties | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Leg het eerste en laatste frame vast | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Onze vlaggenschip-videofamilie | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, in beweging | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video voor elke dag, zonder setup | kiwi | 270 Gems ($0.27) |
| Lemon | Alle videofuncties, voor een vriendelijkere prijs | lemon | 245 Gems ($0.245) |
| LTX Video | Snelle open-weights video om mee te itereren | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Geef elke video een nieuwe cast, met behoud van de beweging | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Anime in beweging, met optionele audio | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Snelle open video met stereogeluid | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Geluid bij elke clip, tot 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Personages tot leven gebracht vanaf een eerste frame | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, met een strikt filter | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, met een strikt filter | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Open-weights video met een Lightning-variant | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
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.
cURL
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"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('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);Python
# 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.
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.
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.
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
Eén sleutel, elk model
37 modellen voor afbeeldingen, video en audio achter één REST API en één Gems-saldo. Wissel van model door het URL-pad aan te passen.
Betaal per generatie
Geen abonnement en geen minimumbesteding. Je koopt Gems en elke aanvraag kost de vermelde prijs. Een mislukte generatie wordt terugbetaald, tenzij het contentbeleid van Mage deze heeft geblokkeerd.
Veilig opnieuw proberen
Met idempotentiesleutels geeft een opnieuw verzonden aanvraag de oorspronkelijke aanvraag terug, zonder nogmaals kosten te rekenen.
Consistente personages
Sla een personage of referentie één keer op en schrijf daarna @handle in een prompt om het te gebruiken met elk model dat dit ondersteunt.
Grote invoer
Stuur afbeeldings-, video- en audio-invoer als URL's of data-URL's, of upload bestanden tot 100 MB via een ondertekende upload.
20 generaties tegelijk
Elk account kan 20 generaties tegelijk uitvoeren en de limiet kan voor jouw toepassing worden verhoogd. Geweigerde aanvragen worden nooit in rekening gebracht.
Toepassingen
Wat ontwikkelaars bouwen met de video-API
Korte video's en social video
Maak verticale clips voor TikTok, Reels en Shorts op basis van een prompt of een productafbeelding.
Stilstaande afbeeldingen animeren
Verander een eerste frame, of een eerste en laatste frame, in beweging met afbeelding-naar-videomodellen zoals Lemon en Kiwi.
Verhalen rond personages
Houd hetzelfde personage door alle shots heen met referentie-naar-videomodellen die @handle-personages accepteren.
Video met geluid
Plum en andere modellen genereren spraak, geluidseffecten en omgevingsgeluid samen met het beeld en accepteren audioreferenties voor stemmen.
Advertenties en productdemo's
Genereer veel varianten van een spot en kies de winnaar, met idempotente verzoeken die je nooit dubbel laten betalen.
Bestaande clips bewerken
Berry, Plum en Grok Video bewerken een bronvideo die je meestuurt; Lemon en MiniMax-H3 accepteren ook referentievideo's.
FAQ
Veelgestelde vragen
Wat is de beste API voor het genereren van video's met AI?
Ondersteunt de video-API afbeelding-naar-video?
Hoe lang mogen gegenereerde video's zijn?
Hoe lang duurt het genereren van een video?
Hoeveel kost de Mage API?
Heb ik een Mage-lidmaatschap nodig om de API te gebruiken?
Mag ik API-uitvoer commercieel gebruiken?
Wat zijn de rate limits?
Kan mijn AI-agent de Mage API gebruiken?
Is er een SDK voor de Mage API?
Ik gebruik al een andere generatie-API. Wat moet ik wijzigen?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.