Berry API

Bir bakışta

Berry API, Berry 2 ve 1 başka varyantı Mage üzerinden POST https://api.mage.space/v1/berry/generate adresinde çalıştırır. Varsayılan ayarlardaki bir istek 189 Gems (yaklaşık 0,189 $) tutarındadır ve abonelik gerekmez. Berry, istemde @handle ile belirtilen kayıtlı karakterleri ve referansları kabul eder.

• Video

  Çıktı

• 2

  Varyantlar

• 189

  Klip başına Gems, varsayılan

• $0.189

  Yaklaşık, USD

Genel bakış

Berry API ne yapar?

Verdiğin her referansa sadık kalan video. Bir başlangıç karesi, 9'a kadar referans veya Characters ya da düzenlenecek bir kaynak video; 1080p'ye kadar 3 ila 15 saniye.

Mage'in referans odaklı video modeli, verdiğin görsellere sadık kalır; Berry 2 güncel sürümdür. Bir ilk kare veya referans görselleri ya da düzenlenecek bir kaynak video.

Girdi olarak first_image, image, additional_images, video kabul eder.

Hızlı başlangıç

Berry API'yi çağır

MAGE_API_KEY'i ayarla, isteği /berry/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.

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

Modeller

Berry model_id değerleri

Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.

Seçenekler

Berry parametreleri

Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.

Girdiler

Berry'nin kabul ettiği medya girdileri

Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.

Kurallar

Berry API'nin zorunlu kıldığı kurallar

• İlk kare, referans görsellerle birlikte kullanılamaz.
• Video düzenleme yalnızca `berry` ile çalışır, `berry-2` ile çalışmaz: 3 ila 60 saniyelik bir kaynak videoyla birlikte `model_id: "berry"` gönder.

Diğer video modelleri

Mage'deki diğer yapay zeka video oluşturma API'leri

SSS

Sık sorulan sorular

Mage ile geliştirmeye başla

Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.

İlgili

• Yapay zeka video oluşturma API'si
• Berry API referansı
• Berry playground
• Tüm API modelleri
• Mage MCP sunucusu