Přeskočit na obsah

Mage API · Model pro video

Berry API

Video, které zůstává věrné tvým referencím

POST https://api.mage.space/v1/berry/generate

Stručně

Berry API spouští Berry 2 a 1 další variantu přes Mage na POST https://api.mage.space/v1/berry/generate. Požadavek s výchozím nastavením stojí 189 Gems (asi 0,189 $), bez předplatného. Berry přijímá uložené postavy a reference přes @handle v promptu.

  • VideoVýstup
  • 2Varianty
  • 189Gems za klip, výchozí
  • $0.189Přibližně v USD

Přehled

Co umí Berry API

Video, které zůstává věrné každé referenci, kterou mu dáš. Úvodní snímek, až 9 referencí nebo Characters, nebo zdrojové video k úpravě; 3 až 15 sekund až v 1080p.

Model pro video od Mage řízený referencemi, věrný obrázkům, které mu dáš; Berry 2 je aktuální verze. První snímek nebo referenční obrázky, nebo zdrojové video k úpravě.

Jako vstupy přijímá first_image, image, additional_images, video.

Rychlý start

Zavolej Berry API

Nastav MAGE_API_KEY, odešli požadavek na /berry/generate a zjišťuj status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro Berry

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
berryBerry
berry-2Berry 2Ano

Možnosti

Parametry Berry

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4
resolution720p, 1080p, 480p
duration3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Vstupy

Média, která Berry přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
first_imageObrázek prvního snímku.
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.
videoZdrojové video.

Pravidla

Jaká pravidla Berry API vynucuje

  • První snímek nelze kombinovat s referenčními obrázky.
  • Úprava videa funguje jen na `berry`, ne na `berry-2`: pošli `model_id: "berry"` se zdrojovým videem dlouhým 3 až 60 sekund.

Další video modely

Další API pro generování videa na Mage

  • Video · od 360 Gems

    Blueberry API

    Zafixuj první a poslední snímek

  • Video · od 618 Gems

    Cherry API

    Naše vlajková řada video modelů

  • Video · od 375 Gems

    Grok Video API

    Grok Imagine v pohybu

  • Video · od 270 Gems

    Kiwi API

    Každodenní video bez nastavování

  • Video · od 245 Gems

    Lemon API

    Všechny video funkce za příznivější cenu

  • Video · od 20 Gems

    LTX Video API

    Rychlé video s otevřenými váhami pro iterace

Časté dotazy

Často kladené otázky

Kolik stojí Berry API?
Požadavek na Berry s výchozím nastavením (Berry 2) stojí 189 Gems, tedy asi 0,189 USD. Jiná rozlišení, délky a varianty cenu mění; přesnou částku najdeš v odpovědi. Neúspěšné generování se vrací, generování zablokované zásadami obsahu Mage ne.
Jaký je endpoint Berry API?
POST https://api.mage.space/v1/berry/generate s hlavičkou Authorization: Bearer, která obsahuje tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém si výsledek vyzvedneš dotazováním.
Které modely Berry můžu volat?
berry (Berry), berry-2 (Berry 2). Výchozí je Berry 2.
Podporuje Berry referenční obrázky nebo postavy?
Berry přijímá first_image, image, additional_images, video. Uložené postavy a reference bere podle @handle v promptu.
Můžu používat Berry z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a požádej o Berry jménem. Tvůj asistent si přes get_model přečte jeho možnosti a před generováním uvede cenu.
Jak dlouho se výsledky Berry uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.