API do generowania wideo AI z tekstu lub obrazów

W skrócie

API do generowania wideo Mage to API REST pod adresem https://api.mage.space/v1, które obsługuje 12 modeli tekstu na wideo i obrazu na wideo, m.in. Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video i Wan. Wyślij prompt oraz opcjonalnie klatki lub referencje, sprawdzaj status zgłoszenia i pobierz plik MP4. Każdy klip kosztuje określoną liczbę Gems zależnie od modelu, rozdzielczości i długości.

• 12

  modeli wideo

• $0.02

  Najtańsza opcja domyślna, za klip

• 20

  Równoczesne generowania

• $0

  Opłata miesięczna

Modele

Wszystkie modele wideo 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 wideo w Berry 2

Ustaw MAGE_API_KEY, wyślij zgłoszenie i sprawdzaj status, aż się zakończy. Zamień berry w adresie URL na dowolny model z listy powyżej.

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

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 programiści tworzą dzięki API wideo

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 obrazów AI
• API do generowania audio AI
• Serwer MCP Mage
• SDK Mage
• Mage dla ComfyUI
• Wszystkie modele API
• Playground API
• Dokumentacja API