API di Mage · Modello video

API di Kiwi

Video di ogni giorno, zero configurazione

Ottieni una chiave APIProva Kiwi nel playground
POST https://api.mage.space/v1/kiwi/generate

In breve

La API di Kiwi esegue Kiwi tramite Mage con POST https://api.mage.space/v1/kiwi/generate. Una richiesta con le impostazioni predefinite costa 270 Gems (circa 0,27 $), senza abbonamento. Kiwi non supporta le menzioni @handle.

Panoramica

Cosa fa la API di Kiwi

Video semplici e affidabili da testo o da un fotogramma iniziale, senza nient'altro da configurare. 5 o 10 secondi fino a 1080p.

Video di ogni giorno da testo o da un solo fotogramma iniziale, senza nient'altro da configurare.

Accetta first_image come input.

Guida rapida

Chiama la API di Kiwi

Imposta MAGE_API_KEY, invia la richiesta a /kiwi/generate e interroga status_url finché la richiesta non è completata.

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

Modelli

Valori di model_id di Kiwi

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

model_idNomePredefinito
kiwiKiwiSì

Opzioni

Parametri di Kiwi

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

CampoValori
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration5, 10

Input

Contenuti multimediali accettati da Kiwi

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

CampoRuolo
first_imageL'immagine del primo frame.

Altri modelli video

Altre API per generare video su Mage

Video · da 245 Gems

API Lemon

Tutte le funzioni video, a un prezzo più accessibile

Video · da 20 Gems

API di LTX Video

Video veloce open-weights per iterare

Video · da 147 Gems

API di Melon

Anime in movimento, con audio opzionale

Video · da 30 Gems

API MiniMax-H3

Video open veloce con audio stereo

Video · da 338 Gems

API Plum

Audio su ogni clip, fino a 2K

Video · da 360 Gems

API di Raspberry

Personaggi che prendono vita a partire da un primo fotogramma

FAQ

Domande frequenti

Quanto costa la API di Kiwi?

Una richiesta a Kiwi con le impostazioni predefinite (Kiwi) costa 270 Gems, circa 0,27 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'importo esatto addebitato. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.

Qual è l'endpoint della API di Kiwi?

Invia una POST a https://api.mage.space/v1/kiwi/generate con un header Authorization: Bearer contenente la tua chiave API di Mage. La risposta include uno status_url da interrogare per ottenere il risultato.

Quali modelli Kiwi posso richiamare?

kiwi. Quello predefinito è Kiwi.

Kiwi supporta immagini di riferimento o personaggi?

Kiwi accetta first_image. Kiwi non supporta le menzioni @handle.

Posso usare Kiwi da Claude o ChatGPT?

Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Kiwi per nome. Il tuo assistente legge le opzioni con get_model e indica il prezzo prima di generare.

Per quanto tempo vengono conservati i risultati di Kiwi?

Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Ottieni una chiave APIProva Kiwi nel playground

Correlati