ToAPIsToAPIs
Grok Image

Grok Генерация изображений

Генерация изображений с помощью моделей Grok: текст-в-изображение и генерация по референсным изображениям

POST
/v1/images/generations

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

  • Единый API генерации изображений
  • Параметр model выбирает модель grok-image или grok-image-2.0
  • Поддерживает генерацию из текста и по референсным изображениям (до 5 изображений)
  • Асинхронное управление задачами, результаты запрашиваются по ID задачи

Важное изменение: для повышения производительности и контроля затрат передача base64-данных изображений напрямую в image_urls больше не поддерживается. Сначала загрузите изображения через API загрузки изображений, получите URL и только затем вызывайте этот эндпоинт.

Authorizations

Authorizationstringзаголовокобязательно

Все эндпоинты требуют аутентификации Bearer Token

Получите API Key на странице управления API-ключами

Добавьте в заголовок запроса:

Authorization: Bearer YOUR_API_KEY

Body

modelstringтелообязательно

Название модели генерации изображений

Поддерживаемые модели:

  • grok-image - Стандартная модель генерации изображений Grok
  • grok-image-2.0 - Модель генерации изображений Grok 2.0, поддерживает параметр quality

Пример: "grok-image"

promptstringтелообязательно

Текстовое описание для генерации изображения

Максимум 1000 символов. При передаче image_urls промт должен явно описывать, как использовать референсные изображения (например, «сгенерируйте изображение на основе референса»), иначе референсы могут быть проигнорированы.

aspect_ratiostringтелопо умолчанию: 1:1

Соотношение сторон изображения

Поддерживаемые форматы:

  • 1:1 - Квадрат (по умолчанию)
  • 2:3 - Портрет
  • 3:4 - Портрет
  • 3:2 - Альбом
  • 4:3 - Альбом
  • 16:9 - Широкоформатный альбом
  • 9:16 - Широкоформатный портрет
resolutionstringтелопо умолчанию: 1k

Уровень разрешения вывода

В настоящее время поддерживается только 1k (вывод примерно в 1 мегапиксель).

qualitystringтелопо умолчанию: low

Уровень качества вывода. Поддерживается только grok-image-2.0

Поддерживаемые значения:

  • low - Низкое качество (по умолчанию)
  • medium - Среднее качество

Для двух уровней действуют разные тарифы, см. страницу цен.

nintegerтелопо умолчанию: 1

Количество генерируемых изображений

Поддерживается только значение 1

По умолчанию: 1

⚠️ Примечание: указывайте простое число (например, 1), без кавычек, иначе возникнет ошибка

response_formatstringтелопо умолчанию: url

Формат возврата результата. Поддерживается только url — результаты возвращаются в виде URL изображений.

image_urlsstring[]тело

Список URL референсных изображений для генерации по референсу

⚠️ Только формат URL (base64 больше не поддерживается)

  • Публично доступный URL изображения (http:// или https://)
  • Вы можете использовать API загрузки изображений для загрузки локальных изображений и получения URL

Ограничения:

  • Максимум 5 изображений
  • Одно изображение до 10 МБ
  • Поддерживаемые форматы: jpeg, jpg, png, webp

Каждое референсное изображение тарифицируется как входное изображение в дополнение к цене за запрос.

Response

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/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-image-2.0",
    "prompt": "A cyberpunk futuristic city at night",
    "aspect_ratio": "16:9",
    "quality": "medium",
    "n": 1
  }'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-image",
    "prompt": "Generate an image based on the reference image, transforming it into watercolor painting style",
    "aspect_ratio": "1:1",
    "n": 1,
    "image_urls": [
      "https://example.com/photo.jpg"
    ]
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/images/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "grok-image",
        "prompt": "A cyberpunk futuristic city at night",
        "aspect_ratio": "16:9",
        "n": 1
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")
const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'grok-image',
    prompt: 'A cyberpunk futuristic city at night',
    aspect_ratio: '16:9',
    n: 1
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

Пример ответа

{
  "id": "tsk_img_abc123def456",
  "object": "generation.task",
  "model": "grok-image",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
{
  "error": {
    "code": "invalid_request",
    "message": "The 'prompt' field is required.",
    "param": "prompt",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}