Генерирует изображения по текстовому описанию или редактирует картинку по вашему запросу, если вы загрузили фото. Цена - 4 рубля за изображение.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Grok Image генерирует изображения по текстовому описанию и редактирует загруженные картинки по инструкции.
Два режима работы:
Режим определяется автоматически: если передать изображение в image_urls, нейросеть работает как редактор. Без изображения - генерирует с нуля.
Каждый вызов создаёт асинхронную операцию. После запуска нужно отдельно проверять статус по id.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус операции.{
"tool": "grok-image",
"input": {
"...": "..."
}
}
tool - slug нейросети, всегда "grok-image".input - параметры запуска. Все поля передаются напрямую внутри этого объекта.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
prompt | string | Да | Текстовое описание: что нужно сгенерировать или как изменить изображение. От 3 до 5000 символов. |
image_urls | string[] (url) | Нет | Массив с URL изображения для редактирования. Если передать изображение, нейросеть перейдёт в режим редактирования, а aspect_ratio будет проигнорирован. Максимум файлов: 1. Допустимые расширения: .jpg, .jpeg, .png, .webp. |
aspect_ratio | enum | Нет | Соотношение сторон результата. Работает только в режиме генерации из текста (без изображения). Варианты: 2:3, 3:2, 1:1, 9:16, 16:9. |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "grok-image",
"input": {
"prompt": "Уютная кофейня на углу европейской улочки, утренний свет, акварельный стиль",
"aspect_ratio": "3:2"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'grok-image',
input: {
prompt: 'Уютная кофейня на углу европейской улочки, утренний свет, акварельный стиль',
aspect_ratio: '3:2',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'grok-image',
'input': {
'prompt': 'Уютная кофейня на углу европейской улочки, утренний свет, акварельный стиль',
'aspect_ratio': '3:2',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "grok-image",
"input": {
"prompt": "Замени фон на вечернюю набережную с тёплым освещением, лицо и одежду не трогай",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg"
]
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'grok-image',
input: {
prompt: 'Замени фон на вечернюю набережную с тёплым освещением, лицо и одежду не трогай',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
],
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'grok-image',
'input': {
'prompt': 'Замени фон на вечернюю набережную с тёплым освещением, лицо и одежду не трогай',
'image_urls': [
'https://cdn.example.com/source-image-1.jpg',
],
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "grok-image",
"cost": 4,
"balance_after": 495,
"created_at": "2026-03-13T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "grok-image",
"cost": 4,
"created_at": "2026-03-13T12:00:00Z",
"completed_at": "2026-03-13T12:00:18Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/grok-image/image-1.jpg",
"https://storage.bratuha.ru/results/grok-image/image-2.jpg"
]
},
"error_message": null
}
После создания операции сохраните id из ответа и проверяйте статус отдельным запросом:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
const status = await fetch(
'https://bratuha.ru/api/v1/operations/op_uuid-123',
{
headers: { Authorization: 'Bearer brth_ваш_ключ' },
},
)
const result = await status.json()
После завершения Grok Image возвращает:
{
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/grok-image/image-1.jpg",
"https://storage.bratuha.ru/results/grok-image/image-2.jpg"
]
}
type - всегда "image".urls - массив ссылок на готовые изображения. Обычно возвращается два изображения.Если операция завершилась с ошибкой, result будет null, а текст ошибки вернётся в error_message.
aspect_ratio не используется - соотношение сторон определяется загруженным изображением.image_urls разрешены только внешние http/https URL с расширениями .jpg, .jpeg, .png, .webp.HEIC/HEIF, которые поддерживаются при загрузке файлов в UI, в Public API по URL не принимаются.POST /api/v1/operations не идемпотентен: повторный запрос создаёт новую операцию.queued, затем проверяете статус по id.