API do Mage · Modelo de vídeo
API do Cherry
Nossa família de vídeo principal
POST https://api.mage.space/v1/cherry/generateResumo 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_id | Nome | Padrão |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | Sim |
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.
| Campo | Valores |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 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.
| Campo | Função |
|---|---|
| image | A imagem de referência. |
| additional_images | Imagens de referência adicionais. |
| videos | Os 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
API do Grok Video
Grok Imagine em movimento
API do Kiwi
Vídeo do dia a dia, sem configuração
API do Lemon
Todos os recursos de vídeo, por um preço mais amigável
API do LTX Video
Vídeo open-weights rápido para iterar
API Magejutsu
Refaça qualquer vídeo mantendo o movimento
API do Melon
Anime em movimento, com áudio opcional
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do Cherry?
Qual é o endpoint da API do Cherry?
Quais modelos do Cherry posso chamar?
O Cherry aceita imagens de referência ou personagens?
Posso usar o Cherry no Claude ou no ChatGPT?
Por quanto tempo os resultados do Cherry ficam salvos?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.