Μετάβαση στο περιεχόμενο
PlaygroundΤεκμηρίωσηΑπόκτησε κλειδί API

Mage API · Μοντέλο βίντεο

Berry API

Βίντεο που μένει πιστό στις αναφορές σου

Απόκτησε κλειδί APIΔοκίμασε το Berry στο playground
POST https://api.mage.space/v1/berry/generate

Με μια ματιά

Το Berry API εκτελεί το Berry 2 και μία ακόμη παραλλαγή μέσω του Mage στο POST https://api.mage.space/v1/berry/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 189 Gems (περίπου $0,189), χωρίς συνδρομή. Το Berry δέχεται αποθηκευμένα Characters και αναφορές μέσω @handle στο prompt.

  • ΒίντεοΈξοδος
  • 2Παραλλαγές
  • 189Gems ανά κλιπ, προεπιλογή
  • $0.189Περίπου, σε USD

Επισκόπηση

Τι κάνει το Berry API

Βίντεο που μένει πιστό σε κάθε αναφορά που του δίνεις. Ένα αρχικό καρέ, έως 9 αναφορές ή Characters, ή ένα βίντεο-πηγή για επεξεργασία· από 3 έως 15 δευτερόλεπτα, έως 1080p.

Το μοντέλο βίντεο του Mage που βασίζεται σε αναφορές και μένει πιστό στις εικόνες που του δίνεις· το Berry 2 είναι η τρέχουσα έκδοση. Ένα πρώτο καρέ ή εικόνες αναφοράς, ή ένα βίντεο-πηγή για επεξεργασία.

Δέχεται ως εισόδους: first_image, image, additional_images, video.

Γρήγορη εκκίνηση

Κάλεσε το Berry API

Όρισε το MAGE_API_KEY, στείλε το αίτημα στο /berry/generate και έλεγχε το status_url μέχρι να ολοκληρωθεί.

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

Μοντέλα

Τιμές model_id του Berry

Στείλε το model_id για να διαλέξεις παραλλαγή. Ένα αίτημα χωρίς αυτό εκτελεί την προεπιλεγμένη.

model_idΌνομαΠροεπιλογή
berryBerry
berry-2Berry 2Ναι

Επιλογές

Παράμετροι του Berry

Οι τιμές που επιτρέπονται σε όλες τις παραλλαγές· μια παραλλαγή μπορεί να προσφέρει λιγότερες. Τα docs αναφέρουν τις επιλογές ανά παραλλαγή.

ΠεδίοΤιμές
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

Είσοδοι

Είσοδοι πολυμέσων που δέχεται το Berry

Στείλε κάθε αρχείο ως https URL, ως data URL ή ως ανέβασμα έως 100 MB.

ΠεδίοΡόλος
first_imageΗ εικόνα του πρώτου καρέ.
imageΗ εικόνα αναφοράς.
additional_imagesΠρόσθετες εικόνες αναφοράς.
videoΤο βίντεο πηγής.

Κανόνες

Τι επιβάλλει το Berry API

  • Το πρώτο καρέ δεν μπορεί να συνδυαστεί με εικόνες αναφοράς.
  • Η επεξεργασία βίντεο λειτουργεί μόνο με το `berry`, όχι με το `berry-2`: στείλε `model_id: "berry"` με βίντεο πηγής διάρκειας 3 έως 60 δευτερολέπτων.

Περισσότερα μοντέλα βίντεο

Άλλα API δημιουργίας βίντεο στο Mage

  • Βίντεο · από 360 Gems

    Blueberry API

    Καθόρισε το πρώτο και το τελευταίο καρέ

  • Βίντεο · από 618 Gems

    Cherry API

    Η κορυφαία οικογένεια μοντέλων βίντεο μας

  • Βίντεο · από 375 Gems

    Grok Video API

    Το Grok Imagine σε κίνηση

  • Βίντεο · από 270 Gems

    Kiwi API

    Καθημερινό βίντεο, χωρίς ρυθμίσεις

  • Βίντεο · από 245 Gems

    Lemon API

    Όλες οι δυνατότητες βίντεο, σε πιο προσιτή τιμή

  • Βίντεο · από 20 Gems

    LTX Video API

    Γρήγορο βίντεο με ανοιχτά βάρη για δοκιμές

Συχνές ερωτήσεις

Συχνές ερωτήσεις

Πόσο κοστίζει το Berry API;
Ένα αίτημα Berry με τις προεπιλεγμένες ρυθμίσεις (Berry 2) κοστίζει 189 Gems, περίπου $0.189. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απάντηση αναφέρει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, γίνεται επιστροφή· αν όμως τη μπλοκάρει η πολιτική περιεχομένου του Mage, δεν γίνεται.
Ποιο είναι το endpoint του Berry API;
POST https://api.mage.space/v1/berry/generate με header Authorization: Bearer που περιέχει το κλειδί API του Mage. Η απάντηση περιλαμβάνει ένα status_url για να ελέγχεις το αποτέλεσμα.
Ποια μοντέλα Berry μπορώ να καλέσω;
berry (Berry), berry-2 (Berry 2). Η προεπιλογή είναι το Berry 2.
Το Berry υποστηρίζει εικόνες αναφοράς ή χαρακτήρες;
Το Berry δέχεται first_image, image, additional_images, video. Το Berry δέχεται αποθηκευμένους χαρακτήρες και αναφορές μέσω @handle στο prompt.
Μπορώ να χρησιμοποιήσω το Berry από το Claude ή το ChatGPT;
Ναι. Σύνδεσε τον διακομιστή Mage MCP με το Claude, το ChatGPT, το Claude Code, το Grok ή το Cursor και ζήτα το Berry με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με το get_model και αναφέρει την τιμή πριν δημιουργήσει.
Για πόσο διατηρούνται τα αποτελέσματα του Berry;
Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

Ξεκίνα να δημιουργείς με το Mage

Ένας λογαριασμός, ένα υπόλοιπο Gems, όλα τα μοντέλα. Πληρώνεις μόνο για ό,τι δημιουργείς.

Απόκτησε κλειδί APIΔοκίμασε το Berry στο playground