К содержимому
Блог

Как пользоваться Grok: текстовый запрос и генерация видео

Как пользоваться Grok: текстовый запрос и генерация видео

Как пользоваться Grok через API: для текста отправьте сообщение в /v1/chat/completions, для видео создайте задачу в /v1/videos. В Relay это разные модели: grok-4.5, grok-4.6, grok-4.7 отвечают текстом, а grok-imagine-video создаёт ролик. Один ключ позволяет обращаться к разрешённым ему моделям. Ниже оба сценария; подписку и возможности сайта Grok они не заменяют.

Как пользоваться Grok для текста и видео

Сначала определите результат. Сценарий рекламного ролика, описание сцены и подписи к кадрам относятся к текстовой задаче. Движущийся кадр в видеофайле требует видеомодели. Чат-модель может написать сценарий, но запрос «сгенерируй ролик» в обычном текстовом сообщении не создаст видеозадачу.

Проверьте тип и ID в каталоге xAI. Цифра в имени модели не доказывает, что она лучше решит вашу задачу. Возьмите один характерный запрос и заранее определите, что считается приемлемым ответом: например, все обязательные факты сохранены, новых обещаний нет, текст помещается в заданный объём.

Для доступа создайте аккаунт Relay, затем ключ в кабинете. Полный секрет показывается один раз. Проверьте баланс, список разрешённых моделей и лимиты ключа; способы и условия пополнения смотрите на странице цен и в кабинете. Ключ Relay нужен для API Relay, а не для входа на сайт Grok.

Как отправить сообщение из Node.js

Пример использует установленный пакет openai и CommonJS. Сохраните код в grok.cjs, задайте RELAY_API_KEY, затем запустите node grok.cjs. Ключ в команде вымышленный: замените его собственным, не публикуя в репозитории.

bash
export RELAY_API_KEY="sk-demo-not-a-real-key"
js
const OpenAI = require('openai')

async function main() {
  if (!process.env.RELAY_API_KEY) throw new Error('Задайте RELAY_API_KEY')
  const client = new OpenAI({
    apiKey: process.env.RELAY_API_KEY,
    baseURL: 'https://relay-llm.ru/v1',
  })
  const response = await client.chat.completions.create({
    model: 'grok-4.7',
    messages: [
      { role: 'system', content: 'Используй только факты из сообщения пользователя.' },
      { role: 'user', content: 'Сократи до одной фразы: магазин работает с 10:00 до 18:00, выдача заказов у стойки.' },
    ],
  })
  console.log(response.choices[0].message.content)
}

main().catch((error) => {
  console.error(error.message)
  process.exitCode = 1
})

Текст лежит в choices[0].message.content, сведения о токенах в usage. Выполненный запрос появится в журнале кабинета с токенами и стоимостью. Для разбирательства сохраните x-request-id из заголовка ответа, время и модель. Не отправляйте ключ или закрытый текст обращения.

Если нужна история диалога, приложение должно передавать предыдущие сообщения. Новый вызов с одним сообщением не получает историю сайта Grok или другого API-запроса автоматически. Поля сообщений описаны в Chat Completions.

Как создать ролик Grok Imagine и скачать MP4

Подготовьте одну сцену: объект, действие, фон, движение камеры. Например, чашка на деревянном столе, камера плавно отъезжает, мягкий дневной свет, без надписей. Просьба «сделай красиво» не задаёт ни композицию, ни движение, которые потом можно проверить.

Отправьте запрос из терминала с тем же ключом. Параметры длительности и размера берите из карточки Grok Imagine; в минимальном примере они опущены.

bash
curl -sS https://relay-llm.ru/v1/videos \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video","prompt":"Чашка на деревянном столе, камера плавно отъезжает, мягкий дневной свет, без надписей"}'

Сохраните поле id из ответа. Затем присвойте его переменной терминала VIDEO_ID, скопировав значение без изменений. Следующая команда читает статус, а не запускает новый ролик:

bash
: "${VIDEO_ID:?Задайте VIDEO_ID из ответа на создание}"
curl -sS "https://relay-llm.ru/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $RELAY_API_KEY"

queued означает ожидание, in_progress выполнение, completed готовность, failed неудачу. Опрашивайте с паузой в несколько секунд и ограничьте ожидание в приложении. После completed скачайте файл:

bash
curl --fail --show-error \
  "https://relay-llm.ru/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $RELAY_API_KEY" -o grok.mp4

Делайте это сразу: доступ к задаче ограничен по времени от создания и не предназначен для хранения роликов. После скачивания откройте файл и проверьте движение, детали предмета и отсутствие случайных надписей. Отклонённый редактором ролик всё равно был сгенерирован; учитывайте его при оценке расходов.

Что проверить, если ответ не пришёл

При 401 проверьте передачу ключа. При ошибке модели сравните ID с каталогом и её доступность. При 400 прочитайте тело ошибки и проверьте поля запроса: параметры чата нельзя механически переносить в видео. При 429 остановите частые повторы и соблюдайте указанный сервером интервал.

Если POST на видео завершился таймаутом, не запускайте его сразу заново. Найдите сохранённый ID; если ответа с ID нет, сохраните идентификатор запроса для поддержки. Новый POST может создать второй платный ролик. Порядок работы с видео описан в документации.

Не обещайте через API поиск в X, историю веб-аккаунта или функции подписки Grok. Статья показывает текстовый и видео-маршруты Relay. Возможности другого продукта нужно проверять отдельно.

Как пользоваться Grok в России через Relay?

Создайте аккаунт и ключ Relay, проверьте доступную модель и баланс, затем выполните пример API. Способы пополнения указаны в кабинете. Это доступ к API, а не подписка сайта Grok.

Один ключ подходит для чата и Grok Imagine?

Да, если обе модели разрешены ключу и доступны. Запросы идут на разные методы и возвращают разные типы результата.

Почему POST на видео не вернул файл?

Он создаёт задачу. Сохраните id, дождитесь completed через метод статуса и скачайте содержимое через /content.

Создать аккаунт для Grok API

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.