Mage API · Video modeli
Berry API
Referanslarına sadık kalan video
POST https://api.mage.space/v1/berry/generateBir 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ı
- 2Varyantlar
- 189Klip başına Gems, varsayılan
- $0.189Yaklaşı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.
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"])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.
| model_id | Ad | Varsayılan |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Evet |
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.
| Alan | Değerler |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
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.
| Alan | Rol |
|---|---|
| first_image | İlk kare görseli. |
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
| video | Kaynak video. |
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
Blueberry API
İlk ve son kareyi sabitle
Cherry API
Amiral gemisi video model ailemiz
Grok Video API
Grok Imagine, hareket halinde
Kiwi API
Günlük videolar, sıfır kurulum
Lemon API
Tüm video özellikleri, daha uygun fiyata
LTX Video API
Hızlı denemeler için açık ağırlıklı video modeli
SSS
Sık sorulan sorular
Berry API ne kadar tutuyor?
Berry API uç noktası nedir?
Hangi Berry modellerini çağırabilirim?
Berry referans görselleri veya karakterleri destekliyor mu?
Berry'yi Claude veya ChatGPT üzerinden kullanabilir miyim?
Berry sonuçları ne kadar süre saklanır?
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.