API do Mage · Modelo de vídeo

API do Kiwi

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

Obter uma chave de APIExperimente o Kiwi no playground
POST https://api.mage.space/v1/kiwi/generate

Resumo rápido

A API do Kiwi executa o Kiwi pelo Mage em POST https://api.mage.space/v1/kiwi/generate. Uma requisição com as configurações padrão custa 270 Gems (cerca de US$ 0,27), sem assinatura. O Kiwi não aceita menções com @handle.

Visão geral

O que a API do Kiwi faz

Vídeo simples e confiável a partir de texto ou de um frame inicial, sem mais nada para configurar. 5 ou 10 segundos em até 1080p.

Vídeo do dia a dia a partir de texto ou de um único frame inicial, sem mais nada para configurar.

Aceita first_image como entrada.

Início rápido

Chame a API do Kiwi

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/kiwi/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": "5",
  "model_id": "kiwi"
}' | 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('kiwi', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'kiwi',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("kiwi", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "kiwi",
})

print(request["result"]["url"])

Modelos

Valores de model_id do Kiwi

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

model_idNomePadrão
kiwiKiwiSim

Opções

Parâmetros do Kiwi

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, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration5, 10

Entradas

Entradas de mídia aceitas pelo Kiwi

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

CampoFunção
first_imageA imagem do primeiro frame.

Mais modelos de vídeo

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

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 147 Gems

API do Melon

Anime em movimento, com áudio opcional

Vídeo · a partir de 30 Gems

API do MiniMax-H3

Vídeo aberto e rápido com som estéreo

Vídeo · a partir de 338 Gems

API do Plum

Som em todos os clipes, até 2K

Vídeo · a partir de 360 Gems

API do Raspberry

Personagens ganham vida a partir de um primeiro frame

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Kiwi?

Uma requisição do Kiwi com as configurações padrão (Kiwi) custa 270 Gems, cerca de US$ 0,27. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Se uma geração falhar, o valor é devolvido; se for bloqueada pela política de conteúdo do Mage, não.

Qual é o endpoint da API do Kiwi?

POST https://api.mage.space/v1/kiwi/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para você consultar o resultado.

Quais modelos do Kiwi posso chamar?

kiwi. O padrão é o Kiwi.

O Kiwi aceita imagens de referência ou personagens?

O Kiwi aceita first_image. Não aceita menções com @handle.

Posso usar o Kiwi no Claude ou no ChatGPT?

Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Kiwi 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 Kiwi ficam guardados?

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.

Obter uma chave de APIExperimente o Kiwi no playground

Relacionados