Grok Генерация видео
Генерация высококачественных видео с помощью модели Grok Video
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
- Модель генерации видео Grok Video
- Выбор модели
grok-video-1.0через параметр model - Поддержка генерации видео из текста и из изображений
- Асинхронное управление задачами, запрос результатов по ID задачи
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 в reference_images. Пожалуйста, сначала загрузите изображения через API загрузки изображений, а затем вызовите данный API с полученным URL.
Авторизация
AuthorizationstringзаголовокобязательноВсе API-запросы требуют аутентификации с помощью Bearer Token
Получение API Key: Перейдите на страницу управления API Key для получения вашего API Key
Добавьте в заголовки запроса:
Authorization: Bearer YOUR_API_KEYТело запроса
modelstringтелообязательнопо умолчанию: grok-video-1.0Название модели генерации видео
Поддерживаемые модели:
grok-video-1.0- Модель генерации видео Grok
Пример: "grok-video-1.0"
promptstringтелообязательноТекстовое описание для генерации видео
durationintegerтелопо умолчанию: 8Продолжительность видео (в секундах)
Поддерживаемые значения:
"6""10"(по умолчанию)"15"
resolutionstringтелопо умолчанию: 720pРазрешение видео
Поддерживаемые значения:
480p720p
aspect_ratiostringтелоСоотношение сторон видео
Поддерживаемые форматы:
16:9(горизонтальное)9:16(вертикальное)
imagestringтелоНеобязательный URL основного изображения. Поддерживаются публичные адреса http:// и https://.
reference_imagesstring[]телоМассив URL-адресов изображений для генерации видео из изображений
⚠️ Поддерживается только формат URL (base64 больше не поддерживается)
- Общедоступные URL-адреса изображений (http:// или https://)
- Используйте API загрузки изображений для загрузки локальных изображений
Ответ
idstringУникальный идентификатор задачи для запроса статуса
objectstringТип объекта, всегда generation.task
modelstringНазвание используемой модели
statusstringСтатус задачи
queued- В очереди на обработкуin_progress- Обрабатываетсяcompleted- Успешно завершеноfailed- Ошибка
progressintegerПрогресс задачи в процентах (0-100)
created_atintegerВременная метка создания задачи (Unix timestamp)
metadataobjectМетаданные задачи
Пример запроса
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-video-1.0",
"prompt": "Золотистый ретривер бежит по зеленому полю в солнечную погоду",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-video-1.0",
"prompt": "Оживите эту собаку, пусть она бежит по полю",
"reference_images": ["https://example.com/dog.jpg"],
"duration": 10,
"resolution": "480p",
"aspect_ratio": "16:9"
}'import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "grok-video-1.0",
"prompt": "Золотистый ретривер бежит по зеленому полю в солнечную погоду",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")const response = await fetch('https://toapis.com/v1/videos/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'grok-video-1.0',
prompt: 'Золотистый ретривер бежит по зеленому полю в солнечную погоду',
duration: 10,
resolution: '720p',
aspect_ratio: '16:9'
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);Пример ответа
{
"id": "video_abc123def456",
"object": "generation.task",
"model": "grok-video-1.0",
"status": "queued",
"progress": 0,
"created_at": 1768380224,
"metadata": {}
}