Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Cherry

Nossa família de vídeo principal

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

Resumo rápido

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

  • VídeoSaída
  • 5Variantes
  • 618Gems por clipe, padrão
  • $0.618Aproximadamente, 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, Cherry 2 e Cherry 2 Pro, o mais poderoso. Os modelos Cherry 2 criam 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.

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

Modelos

Valores de model_id do Cherry

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

model_idNomePadrão
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2Cherry 2
cherry-2-proCherry 2 ProSim

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.

CampoValores
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

Entradas

Entradas de mídia aceitas pelo Cherry

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

CampoFunção
imageA imagem de referência.
additional_imagesImagens de referência adicionais.
videosOs vídeos de origem.

Regras

O que a API do Cherry exige

  • A edição de vídeo aceita exatamente um vídeo de origem, de 4 a 30 segundos no `cherry-2` e no `cherry-2-pro`, e de 2 a 15 segundos nos outros modelos.
  • No `cherry-2` e no `cherry-2-pro`, a 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

  • Vídeo · a partir de 375 Gems

    API do Grok Video

    Grok Imagine em movimento

  • Vídeo · a partir de 270 Gems

    API do Kiwi

    Vídeo do dia a dia, sem configuração

  • Vídeo · a partir de 245 Gems

    API do Lemon

    Todos os recursos de vídeo, por um preço mais amigável

  • Vídeo · a partir de 20 Gems

    API do LTX Video

    Vídeo open-weights rápido para iterar

  • Vídeo · a partir de 1.856 Gems

    API Magejutsu

    Refaça qualquer vídeo mantendo o movimento

  • Vídeo · a partir de 147 Gems

    API do Melon

    Anime em movimento, com áudio opcional

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Cherry?
Uma solicitação do Cherry com as configurações padrão (Cherry 2 Pro) custa 618 Gems, cerca de $0,618. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Cherry?
POST https://api.mage.space/v1/cherry/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do Cherry posso chamar?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2 (Cherry 2), cherry-2-pro (Cherry 2 Pro). O padrão é o Cherry 2 Pro.
O Cherry aceita imagens de referência ou personagens?
O Cherry aceita image, additional_images e videos. O Cherry usa personagens, referências e referências de áudio salvos por @handle no prompt.
Posso usar o Cherry no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Cherry pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Cherry ficam salvos?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

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

CharactersComunidade