Cherry API

In één oogopslag

De Cherry API draait Cherry 2 Pro en 3 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 gebruikt opgeslagen personages, referenties en audioreferenties via @handle in de prompt.

• Video

  Uitvoer

• 4

  Varianten

• 618

  Gems per clip (standaard)

• $0.618

  Ongeveer, 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-videolijn van Mage, met filmische beweging en audio: Cherry Mini, Cherry, Cherry Pro en Cherry 2 Pro, het krachtigste model, met 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.

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"

// 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);

# 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.

Opties

Cherry-parameters

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

Invoer

Media-invoer die Cherry accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

Regels

Wat de Cherry API afdwingt

• Videobewerking vereist precies één bronvideo, van 4 tot 30 seconden bij `cherry-2-pro` en van 2 tot 15 seconden bij de andere modellen.
• Bij `cherry-2-pro` behoudt een bewerking de lengte en de beeldverhouding van de bronvideo: `duration` en `aspect_ratio` worden genegeerd en de prijs hangt af van de lengte van de video.

Meer videomodellen

Andere API's voor videogeneratie op Mage

FAQ

Veelgestelde vragen

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

Gerelateerd

• API voor AI-video's genereren
• Cherry API-referentie
• Cherry playground
• Alle API-modellen
• Mage MCP-server