GrokImagine API
Документация API

GrokImagine API Reference

Полная документация API для интеграции GrokImagine AI в ваши приложения. Генерируйте высококачественные видео из текстовых подсказок и изображений в различных творческих режимах.

REST API
JSON Ответы
Генерация видео

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

GrokImagine API использует Bearer Token аутентификацию. Укажите свой API токен в заголовке Authorization:

Authorization: Bearer your-api-token-here

Примечание по безопасности: Никогда не публикуйте API токены в клиентском коде или публичных репозиториях.

Базовый URL

Все запросы API должны выполняться по адресу:

https://grokimagineapi.com

API Эндпоинты

POST

Генерация видео

/v1/generate

Создавайте высококачественные видео на основе текста и изображений с помощью AI моделей.

Тело запроса

{
  "mode": "fun",
  "prompt": "a beautiful landscape with mountains",
  "images": ["https://example.com/image.png"],
  "ratio": "1:1"
}

Параметры

ПараметрТипОписание
modestringРежим генерации, поддерживает: fun, normal, spicy
promptstringТекстовая подсказка для генерации видео
imagesstring?Необязательный параметр, массив URL изображений, используется для генерации видео по изображениям. Например: ['https://example.com/image.png']
ratiostringСоотношение сторон, поддерживает: 2:3, 3:2, 1:1
💰 Pricing

Each generation consumes 40 credits, approximately 0.4 USD

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}
cURL Example
curl -X POST https://grokimagineapi.com/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "fun",
    "prompt": "a beautiful landscape with mountains",
    "ratio": "1:1"
  }'
GET

Get Task Status

/v1/status?task_id=xxxx

Check the status of an ongoing or completed video generation task.

Query Parameters

Use GET request with query parameter task_id=xxxx

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "consumed_credits": 40,
    "created_at": "2024-01-01T00:00:00Z",
    "status": "completed",
    "task_id": "task_123456789",
    "request": {
      "mode": "fun",
      "prompt": "a beautiful landscape with mountains",
      "ratio": "1:1"
    },
    "response": [
      "https://cdn.example.com/generated/video1.mp4",
      "https://cdn.example.com/generated/video2.mp4"
    ]
  }
}
📋 Response Fields
  • consumed_credits: Number of credits consumed
  • created_at: Task creation timestamp
  • status: Task status
  • task_id: Task ID
  • request: Original request data
  • response: Video URL string array
cURL Example
curl -X GET "https://grokimagineapi.com/v1/status?task_id=task_123456789" \
  -H "Authorization: Bearer your-api-token"

Обработка ошибок

GrokImagine API возвращает стандартные HTTP коды и сообщения об ошибках:

Коды HTTP

200OK
400Bad Request
401Unauthorized
429Rate Limited
500Server Error

Формат ошибки

{
  "code": 400,
  "message": "Invalid request: The prompt parameter is required",
  "error": "INVALID_REQUEST"
}

Лучшие практики: Всегда корректно обрабатывайте ошибки и проверяйте статус ответа перед обработкой тела.

Лимиты

100
запросов/мин
Бесплатный план
1000
requests/minute
Pro план
5000
requests/minute
Корпоративный

Rate Limit Headers: Each response includes X-RateLimit-Remaining and X-RateLimit-Reset headers to track your current usage.

Готовы начать?

Получите свой API ключ и начните создавать потрясающие видео с Seedance

НачатьНа главную