Главное
Kiwi API запускает Kiwi через Mage по адресу POST https://api.mage.space/v1/kiwi/generate. Запрос с настройками по умолчанию стоит 270 Gems (около $0,27), подписка не нужна. Kiwi не поддерживает упоминания через @handle.
Видео
Результат
1
Вариант
270
Gems за клип, по умолчанию
$0.27
Примерно, в USD
Обзор
Что умеет Kiwi API
Простое и надёжное видео по тексту или начальному кадру, без дополнительных настроек. 5 или 10 секунд в разрешении до 1080p.
Видео на каждый день по тексту или одному начальному кадру, без лишней настройки.
На вход принимает first_image.
Быстрый старт
Вызов Kiwi API
Задайте MAGE_API_KEY, отправьте запрос на /kiwi/generate и опрашивайте status_url, пока запрос не завершится.
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"])Модели
Значения model_id для Kiwi
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| kiwi | Kiwi | Да |
Параметры
Параметры Kiwi
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 5, 10 |
Входные данные
Какие медиафайлы принимает Kiwi
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| first_image | Изображение первого кадра. |
Другие видеомодели
Другие API для генерации видео в Mage
Видео · от 245 Gems
Lemon API
Все возможности видео по более доступной цене
Видео · от 20 Gems
LTX Video API
Быстрое видео с открытыми весами для итераций
Видео · от 147 Gems
Melon API
Аниме в движении, со звуком по желанию
Видео · от 30 Gems
MiniMax-H3 API
Быстрое открытое видео со стереозвуком
Видео · от 338 Gems
Plum API
Звук в каждом клипе, до 2K
Видео · от 360 Gems
Raspberry API
Персонажи оживают с первого кадра
FAQ
Частые вопросы
Сколько стоит Kiwi API?
Запрос к Kiwi с настройками по умолчанию (Kiwi) стоит 270 Gems, около $0,27. Другие разрешения, длительности и варианты меняют цену; точная сумма списания указана в ответе. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage, возврата нет.
Какой у Kiwi API эндпоинт?
POST https://api.mage.space/v1/kiwi/generate с заголовком Authorization: Bearer, в котором передаётся ваш API-ключ Mage. В ответе приходит status_url, по которому нужно опрашивать результат.
Какие модели Kiwi можно вызывать?
kiwi. По умолчанию используется Kiwi.
Поддерживает ли Kiwi референсные изображения и персонажей?
Kiwi принимает first_image. Упоминания через @handle Kiwi не поддерживает.
Можно ли использовать Kiwi из Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и попросите Kiwi по названию. Ассистент узнает доступные параметры через get_model и назовёт цену до генерации.
Как долго хранятся результаты Kiwi?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.