Ресурсы для разработчиков

Документация API Grok 5 Imagine

Интегрируйте модель xAI Grok 5 Imagine в свои приложения. Поддержка генерации текст-в-изображение, текст-в-видео и изображение-в-видео через простой REST API.

Аутентификация

API Grok 5 Imagine использует аутентификацию Bearer Token. Передавайте свой API-ключ в заголовке запроса.

Аутентификация

Authorization: Bearer sk-your-api-key-here

Храните свой API-ключ в безопасности. Не используйте его в клиентском коде.

Цены

Тип	Стоимость	Описание
Текст в изображение `(text2img)`	5 кредитов	Генерация изображений на основе текстовых описаний с помощью Grok 5 AI.
Текст в видео `(text2video)`	24 кредита	Генерация видео на основе текстовых описаний с помощью Grok 5 AI.
Изображение в видео `(img2video)`	24 кредита	Генерация видео из изображений с помощью Grok 5 AI.

Создать задачу

POSThttps://grok5ai.com/api/generate

Асинхронная генерация

Цены

Стоимость зависит от модели: text2img — 5 кредитов, text2video и img2video — по 24 кредита.

Запуск задачи генерации. API немедленно возвращает task_id, который используется для получения результата.

Параметры тела запроса

Параметр	Тип	Обязательно	Описание
model	string	Обязательно	Используемая модель: text2img, text2video или img2video.
prompt	string	Условно	Текстовое описание для генерации. Максимум 5000 символов. Обязательно для text2img и text2video.
image_urls	array	Условно	Массив URL-адресов изображений для режима img2video. Обязательно, если не указан task_id.
task_id	string	Условно	ID задачи предыдущей генерации для использования в качестве входного изображения. Обязательно, если не указан image_urls.
callback_url	string	Опционально	URL-адрес Webhook для уведомления о завершении задачи.

Примеры запросов

Пример текст-в-изображение (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2img",
    "prompt": "A serene mountain landscape at sunset"
  }'

Пример текст-в-видео (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2video",
    "prompt": "A timelapse of clouds moving over mountains"
  }'

Пример изображение-в-видео (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img2video",
    "image_urls": ["https://example.com/image.jpg"]
  }'

Успешный ответ

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS"
  }
}

Ответ с ошибкой

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Проверить статус

GEThttps://grok5ai.com/api/status

Опрашивайте эту конечную точку, чтобы проверить прогресс выполнения задачи. Мы рекомендуем делать запрос каждые 5-10 секунд.

Параметры запроса

Параметр	Тип	Описание
task_id	string	ID задачи, полученный от эндпоинта генерации. Обязательно

Значения статуса

PENDINGЗадача в очереди

IN_PROGRESSОбработка

SUCCESSЗавершено

FAILEDПроизошла ошибка

cURL

curl -X GET "https://grok5ai.com/api/status?task_id=grok5abc123def456img" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ответ (В процессе)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Ответ (Завершено)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Ответ (Ошибка)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Коды ошибок

Код	Описание
200	Успешно
400	Неверный запрос — недопустимые параметры (отсутствует описание, неверная модель и т. д.)
401	Не авторизован — отсутствует или недействителен API-ключ
404	Не найдено — ID задачи не существует
500	Внутренняя ошибка сервера — пожалуйста, повторите попытку или обратитесь в службу поддержки

Нужна помощь?

Загляните в наш канал поддержки или напишите нам на электронную почту.

Связаться с поддержкой