Grok Генерация изображений
Генерация изображений с помощью моделей Grok: текст-в-изображение и генерация по референсным изображениям
Для пользователей из материкового Китая: используйте 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_KEYBody
modelstringтелообязательноНазвание модели генерации изображений
Поддерживаемые модели:
grok-image- Стандартная модель генерации изображений Grokgrok-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"
}
}