APIMaster.ai

API generowania wideo MiniMax-H3

Twórz asynchroniczne zadania wideo MiniMax-H3 w APIMaster, sprawdzaj status i pobieraj pliki MP4.

Generowanie wideo MiniMax-H3

Używaj MiniMax-H3 przez zgodne z OpenAI API wideo APIMaster. Generowanie jest asynchroniczne.

Base URL: https://apimaster.ai/v1 to https://apimaster.ai/v1. Zadanie utworzysz przez POST https://apimaster.ai/v1/video/generations.

Zgodność i walidacja

Obsługiwane są POST https://apimaster.ai/v1/video/generations i POST https://apimaster.ai/v1/videos/generations. Dla tego samego modelu parametry i rozliczenia są identyczne; każda ścieżka zachowuje dotychczasowy format odpowiedzi tworzenia zadania. Obecni klienci mogą zachować swoją ścieżkę.

Przykład MiniMax-H3 zachowuje liczbę pojedynczą; size i resolution oraz ratio i aspect_ratio to aliasy. Nieobsługiwane wartości lub sprzeczne aliasy zwracają HTTP 400, bez cichego przełączenia na wyższą rozdzielczość. Podaj rozdzielczość, proporcje i czas jawnie.

Tworzenie zadania

Pole Typ Wymagane Opis
model string tak MiniMax-H3
prompt string warunkowo Opis wideo
duration integer nie 4–15 sekund, domyślnie 4
size string nie 768P lub 2K, domyślnie 768P
ratio string nie Proporcje obrazu, domyślnie 16:9
curl -s "https://apimaster.ai/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-H3","prompt":"A calm ocean at sunrise, cinematic wide shot","duration":4,"size":"768P","ratio":"16:9"}'

Odpowiedź natychmiast zwraca id i task_id ze statusem queued.

Sprawdzanie statusu

GET https://apimaster.ai/v1/videos/{task_id} zwraca queued, in_progress, completed albo failed.

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"

Po wysłaniu odczekaj 10–20 sekund, a następnie sprawdzaj co 3–5 sekund.

Pobieranie wideo

curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o output.mp4

Pobierz MP4 po uzyskaniu statusu completed. duration obsługuje 4–15 sekund, a size wartości 768P i 2K.

Wideo z materiałów referencyjnych (r2v)

Wyślij oficjalną tablicę V2 content do powyższego endpointu APIMaster. Wymagany jest niepusty element text; przy content pole prompt najwyższego poziomu nie jest wymagane. reference_image określa wzorzec obiektu lub stylu, nie pierwszą klatkę. Starsze pole images przypisuje pierwsze dwa obrazy do klatki początkowej i końcowej. Nie łącz tych ról z rolami referencyjnymi.

{
  "model": "MiniMax-H3",
  "content": [
    {"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
    {"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
  ],
  "resolution": "768P",
  "duration": 4,
  "ratio": "16:9"
}