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.
Video
Output
1
Variante
270
Gems per clip, predefinito
$0.27
Circa, in USD
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_id | Nome | Predefinito |
|---|---|---|
| kiwi | Kiwi | Sì |
Opzioni
Parametri di Kiwi
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 5, 10 |
Input
Contenuti multimediali accettati da Kiwi
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| first_image | L'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.