Mage API · Модель відео
Grok Video API
Grok Imagine у русі
POST https://api.mage.space/v1/grok_video/generateКоротко
Grok Video API запускає Grok Video через Mage за адресою POST https://api.mage.space/v1/grok_video/generate. Запит із типовими налаштуваннями коштує 375 Gems (приблизно $0.375), без підписки. Grok Video бере збережені персонажі й референси за @handle у промпті.
- ВідеоРезультат
- 1Варіант
- 375Gems за кліп, типово
- $0.375Приблизно, у USD
Огляд
Що вміє Grok Video API
Grok Imagine від xAI для відео: за текстом, до 5 референсів або короткого вихідного кліпу. Від 1 до 15 секунд до 720p. Діє фільтр безпеки xAI.
Grok Imagine від xAI для відео: за текстом, референсними зображеннями або вихідним відео для редагування. Діє фільтр безпеки xAI.
Як вхідні дані приймає image, additional_images, video.
Швидкий старт
Виклик Grok Video API
Задай MAGE_API_KEY, надішли запит на /grok_video/generate і опитуй status_url, доки запит не завершиться.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_video/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": "grok-imagine-video"
}' | 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('grok_video', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'grok-imagine-video',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_video", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "grok-imagine-video",
})
print(request["result"]["url"])Моделі
Значення model_id для Grok Video
Передайте model_id, щоб вибрати варіант. Запит без нього використовує варіант за замовчуванням.
| model_id | Назва | За замовчуванням |
|---|---|---|
| grok-imagine-video | Grok Video | Так |
Параметри
Параметри Grok Video
Допустимі значення для всіх варіантів; окремий варіант може пропонувати менше. Параметри кожного варіанта наведено в документації.
| Поле | Значення |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 |
| resolution | 480p, 720p |
| duration | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Вхідні дані
Медіавходи, які приймає Grok Video
Надсилайте кожен файл як https-посилання, data URL або завантаження до 100 МБ.
| Поле | Роль |
|---|---|
| image | Референсне зображення. |
| additional_images | Додаткові референсні зображення. |
| video | Вихідне відео. |
Правила
Які обмеження застосовує Grok Video API
- Вихідне відео має тривати не довше 8,7 секунди й не може поєднуватися з референсними зображеннями.
- До 5 референсних зображень, через що кліп обмежується 10 секундами.
Більше відеомоделей
Інші API для генерації відео на Mage
Kiwi API
Повсякденне відео без налаштувань
Lemon API
Усі відеофункції за привабливішою ціною
LTX Video API
Швидке відео з відкритими вагами для ітерацій
Melon API
Аніме в русі, за бажанням зі звуком
MiniMax-H3 API
Швидке відкрите відео зі стереозвуком
Plum API
Звук у кожному кліпі, до 2K
Поширені запитання
Поширені запитання
Скільки коштує Grok Video API?
Який endpoint у Grok Video API?
Які моделі Grok Video я можу викликати?
Чи підтримує Grok Video референсні зображення або персонажів?
Чи можна користуватися Grok Video із Claude або ChatGPT?
Як довго зберігаються результати Grok Video?
Створюй з Mage
Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.