Mage API · Videomodel
Cherry API
Onze vlaggenschip-videofamilie
POST https://api.mage.space/v1/cherry/generateIn één oogopslag
De Cherry API draait Cherry 2 Pro en 4 andere varianten via Mage op POST https://api.mage.space/v1/cherry/generate. Een verzoek met de standaardinstellingen kost 618 Gems (ongeveer $0,618), zonder abonnement. Cherry accepteert opgeslagen personages, referenties en audioreferenties via @handle in de prompt.
- VideoUitvoer
- 5Varianten
- 618Gems per clip (standaard)
- $0.618Ongeveer, in USD
Overzicht
Wat de Cherry API doet
Filmische video met audio, van Cherry Mini voor concepten tot Cherry 2 Pro, ons krachtigste model, met clips tot 30 seconden, veel referenties of Characters en bewerkingen van bronvideo's.
De vlaggenschip-videoserie van Mage, met filmische beweging en audio: Cherry Mini, Cherry, Cherry Pro, Cherry 2 en Cherry 2 Pro, de krachtigste. De Cherry 2-modellen maken clips tot 30 seconden.
Het accepteert image, additional_images en videos als invoer.
Snel starten
De Cherry API aanroepen
Stel MAGE_API_KEY in, verstuur naar /cherry/generate en poll status_url totdat het verzoek is voltooid.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "4",
"model_id": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])Modellen
Cherry model_id-waarden
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | Ja |
Opties
Cherry-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Invoer
Media-invoer die Cherry accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| image | De referentieafbeelding. |
| additional_images | Extra referentieafbeeldingen. |
| videos | De bronvideo's. |
Regels
Wat de Cherry API afdwingt
- Videobewerking accepteert precies één bronvideo, van 4 tot 30 seconden bij `cherry-2` en `cherry-2-pro` en van 2 tot 15 seconden bij de andere modellen.
- Bij `cherry-2` en `cherry-2-pro` behoudt een bewerking de lengte en de beeldverhouding van de bronvideo: `duration` en `aspect_ratio` worden genegeerd en de prijs volgt de lengte van de video.
Meer videomodellen
Andere API's voor videogeneratie op Mage
Grok Video API
Grok Imagine, in beweging
Kiwi API
Video voor elke dag, zonder setup
Lemon API
Alle videofuncties, tegen een vriendelijkere prijs
LTX Video API
Snelle open-weights video om mee te itereren
Magejutsu API
Geef elke video een nieuwe cast, met behoud van de beweging
Melon API
Anime in beweging, met optionele audio
FAQ
Veelgestelde vragen
Wat kost de Cherry API?
Wat is het endpoint van de Cherry API?
Welke Cherry-modellen kan ik aanroepen?
Ondersteunt Cherry referentie-afbeeldingen of personages?
Kan ik Cherry gebruiken vanuit Claude of ChatGPT?
Hoe lang blijven Cherry-resultaten bewaard?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.