API Berry

W skrócie

API Berry uruchamia Berry 2 i 1 inny wariant przez Mage pod adresem POST https://api.mage.space/v1/berry/generate. Zapytanie z ustawieniami domyślnymi kosztuje 189 Gems (około $0.189), bez subskrypcji. Berry przyjmuje zapisane postacie i referencje przez @handle w prompcie.

• Wideo

  Wynik

• 2

  Warianty

• 189

  Gems za klip, domyślnie

• $0.189

  Około, w USD

Przegląd

Co potrafi API Berry

Wideo, które pozostaje wierne każdej podanej referencji. Klatka początkowa, do 9 referencji lub Characters albo wideo źródłowe do edycji; od 3 do 15 sekund w rozdzielczości do 1080p.

Model wideo Mage oparty na referencjach, wierny podanym obrazom; Berry 2 to aktualna wersja. Pierwsza klatka lub obrazy referencyjne albo wideo źródłowe do edycji.

Jako dane wejściowe przyjmuje first_image, image, additional_images, video.

Szybki start

Wywołaj API Berry

Ustaw MAGE_API_KEY, wyślij zapytanie do /berry/generate i odpytuj status_url, aż zapytanie się zakończy.

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

Modele

Wartości model_id dla Berry

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

Opcje

Parametry Berry

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

Dane wejściowe

Pliki wejściowe obsługiwane przez Berry

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

Zasady

Co wymusza Berry API

• Pierwszej klatki nie można łączyć z obrazami referencyjnymi.
• Edycja wideo działa tylko w `berry`, nie w `berry-2`: wyślij `model_id: "berry"` z wideo źródłowym o długości od 3 do 60 sekund.

Więcej modeli wideo

Inne API do generowania wideo w Mage

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 wideo AI
• Dokumentacja Berry API
• Plac zabaw Berry
• Wszystkie modele API
• Serwer MCP Mage