API do Cherry

Resumo rápido

A API do Cherry executa o Cherry 2 Pro e outras 3 variantes pelo Mage em POST https://api.mage.space/v1/cherry/generate. Uma solicitação com as configurações padrão custa 618 Gems (cerca de $0,618), sem assinatura. O Cherry usa personagens, referências e referências de áudio salvos por @handle no prompt.

• Vídeo

  Saída

• 4

  Variantes

• 618

  Gems por clipe, padrão

• $0.618

  Aproximadamente, em USD

Visão geral

O que a API do Cherry faz

Vídeo cinematográfico com áudio, do Cherry Mini para rascunhos ao Cherry 2 Pro, nosso modelo mais poderoso, com clipes de até 30 segundos, várias referências ou Characters e edições de vídeo de origem.

A linha de vídeo principal do Mage, com movimento cinematográfico e áudio: Cherry Mini, Cherry, Cherry Pro e Cherry 2 Pro, o mais poderoso, com clipes de até 30 segundos.

Aceita image, additional_images e videos como entradas.

Início rápido

Chame a API do Cherry

Defina MAGE_API_KEY, envie para /cherry/generate e consulte o status_url até a solicitação ser concluída.

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

Modelos

Valores de model_id do Cherry

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

Opções

Parâmetros do Cherry

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

Entradas

Entradas de mídia aceitas pelo Cherry

Envie cada uma como URL https, data URL ou upload de até 100 MB.

Regras

O que a API do Cherry exige

• A edição de vídeo exige exatamente um vídeo de origem, de 4 a 30 segundos no `cherry-2-pro` e de 2 a 15 segundos nos demais modelos.
• No `cherry-2-pro`, uma edição mantém a duração e a proporção do vídeo de origem: `duration` e `aspect_ratio` são ignorados, e o preço acompanha a duração do vídeo.

Mais modelos de vídeo

Outras APIs de geração de vídeo no Mage

Perguntas frequentes

Perguntas frequentes

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

Relacionados

• API de geração de vídeos com IA
• Referência da API do Cherry
• Playground do Cherry
• Todos os modelos da API
• Servidor MCP do Mage