Создаёт изображения по текстовому описанию и редактирует их по загруженным образцам — до 16 изображений за раз. Цена за изображение: 1K и 2K — 3 ₽, 4K — 6 ₽, каждое загруженное изображение — плюс 0,5 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
MiniMax H3 Image рисует изображения по текстовому описанию и правит готовые картинки по заданию: меняет сцену, стиль и детали, собирает одну картинку из нескольких снимков. За один запрос можно передать до 16 изображений-образцов - например, человека, одежду, предметы и фон по отдельности. Модель берут для рекламных кадров, карточек товаров, иллюстраций, коллажей и постеров. Размер результата - до 4K, около 16 мегапикселей.
Режим выбирается сам по запросу:
image_urls не передан или пустой. Модель рисует новое изображение по prompt.image_urls есть хотя бы одна ссылка (до 16). Модель меняет изображения по prompt или собирает из них одну картинку.Каждый запрос создаёт асинхронную операцию: сразу приходит id и статус queued, а готовое изображение нужно забрать отдельным запросом по этому id.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус операции.Режимы:
image_urls;image_urls;image_urls.{
"tool": "minimax-h3-image",
"input": {
"...": "..."
}
}
tool - slug нейросети, всегда "minimax-h3-image".input - параметры запуска, все поля передаются прямо внутри этого объекта.prompt: остальные поля можно не передавать, тогда работают значения по умолчанию из описания параметров.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
prompt | string | Да | Что нарисовать или что изменить. От 3 до 5000 символов. В правке на изображения можно ссылаться по номеру: @image1, @image2 - номер совпадает с порядком ссылок в image_urls. |
image_urls | string[] | Нет | Внешние http/https ссылки на изображения .jpg, .jpeg, .png, .webp, до 16 штук. Без ссылок - создание, со ссылками - правка. Каждая ссылка - плюс 0,5 ₽ к цене. |
resolution | enum | Нет | Размер результата и цена: 1k (около 1 Мп), 2k (около 4 Мп), 4k (около 16 Мп). Если не передать - 2k. |
aspect_ratio | enum | Нет | Пропорции результата: auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 5:4, 4:5, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3. auto со ссылками - модель подбирает пропорции по изображениям и заданию, без изображений получится 1:1. Если не передать - auto. |
output_format | enum | Нет | Формат файла: png или jpeg. Если не передать - png. |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "minimax-h3-image",
"input": {
"prompt": "Постер джазового фестиваля: саксофонист в силуэте на фоне огромной оранжевой луны, крупная надпись \"JAZZ NIGHTS\" сверху, ретро-печать, зернистая текстура",
"resolution": "2k",
"aspect_ratio": "3:4",
"output_format": "jpeg"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'minimax-h3-image',
input: {
prompt: 'Постер джазового фестиваля: саксофонист в силуэте на фоне огромной оранжевой луны, крупная надпись "JAZZ NIGHTS" сверху, ретро-печать, зернистая текстура',
resolution: '2k',
aspect_ratio: '3:4',
output_format: 'jpeg',
},
}),
})
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': 'minimax-h3-image',
'input': {
'prompt': 'Постер джазового фестиваля: саксофонист в силуэте на фоне огромной оранжевой луны, крупная надпись "JAZZ NIGHTS" сверху, ретро-печать, зернистая текстура',
'resolution': '2k',
'aspect_ratio': '3:4',
'output_format': 'jpeg',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
aspect_ratio не передан, поэтому модель подбирает пропорции по исходному снимку.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "minimax-h3-image",
"input": {
"prompt": "Перенеси сцену на снимке в зимний вечер: снег на крышах и тротуаре, тёплый свет в окнах. Людей и композицию не меняй",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg"
],
"resolution": "2k",
"output_format": "jpeg"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'minimax-h3-image',
input: {
prompt: 'Перенеси сцену на снимке в зимний вечер: снег на крышах и тротуаре, тёплый свет в окнах. Людей и композицию не меняй',
image_urls: ['https://cdn.example.com/source-image-1.jpg'],
resolution: '2k',
output_format: 'jpeg',
},
}),
})
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': 'minimax-h3-image',
'input': {
'prompt': 'Перенеси сцену на снимке в зимний вечер: снег на крышах и тротуаре, тёплый свет в окнах. Людей и композицию не меняй',
'image_urls': ['https://cdn.example.com/source-image-1.jpg'],
'resolution': '2k',
'output_format': 'jpeg',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Номер в @image1, @image2 - это порядок ссылки в image_urls.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "minimax-h3-image",
"input": {
"prompt": "Надень на человека с @image1 куртку с @image2, дай ему в руки сумку с @image3 и поставь на фоне набережной с @image4. Лицо и позу сохрани",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/reference-image-2.png",
"https://cdn.example.com/reference-image-3.jpg",
"https://cdn.example.com/reference-image-4.jpg"
],
"resolution": "4k",
"aspect_ratio": "3:4",
"output_format": "jpeg"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'minimax-h3-image',
input: {
prompt: 'Надень на человека с @image1 куртку с @image2, дай ему в руки сумку с @image3 и поставь на фоне набережной с @image4. Лицо и позу сохрани',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/reference-image-2.png',
'https://cdn.example.com/reference-image-3.jpg',
'https://cdn.example.com/reference-image-4.jpg',
],
resolution: '4k',
aspect_ratio: '3:4',
output_format: 'jpeg',
},
}),
})
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': 'minimax-h3-image',
'input': {
'prompt': 'Надень на человека с @image1 куртку с @image2, дай ему в руки сумку с @image3 и поставь на фоне набережной с @image4. Лицо и позу сохрани',
'image_urls': [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/reference-image-2.png',
'https://cdn.example.com/reference-image-3.jpg',
'https://cdn.example.com/reference-image-4.jpg',
],
'resolution': '4k',
'aspect_ratio': '3:4',
'output_format': 'jpeg',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "minimax-h3-image",
"cost": 3,
"balance_after": 494,
"created_at": "2026-11-11T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "minimax-h3-image",
"cost": 3,
"created_at": "2026-11-11T12:00:00Z",
"completed_at": "2026-11-11T12:00:30Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/minimax-h3-image/image-1.jpeg"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "minimax-h3-image",
"cost": 3,
"created_at": "2026-11-11T12:00:00Z",
"completed_at": "2026-11-11T12:00:09Z",
"result": null,
"error_message": "Не удалось сгенерировать изображение по этому запросу"
}
Сохраните 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()
В обоих режимах приходит одно изображение:
{
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/minimax-h3-image/image-1.png"
]
}
type - всегда "image".urls - массив с одной ссылкой на готовое изображение в формате из output_format.Если операция завершилась с ошибкой, result будет null, а причина придёт в error_message.
Цена считается за одно изображение: по resolution плюс 0,5 ₽ за каждую ссылку в image_urls.
resolution | Без изображений | За каждую ссылку в image_urls |
|---|---|---|
1k | 3 ₽ | + 0,5 ₽ |
2k | 3 ₽ | + 0,5 ₽ |
4k | 6 ₽ | + 0,5 ₽ |
resolution не передан, считается 2k: 3 ₽.2k с одной ссылкой - 3,5 ₽; 4k с четырьмя ссылками - 6 + 2 = 8 ₽; 16 ссылок в 2k - 3 + 8 = 11 ₽.1k стоит столько же, сколько 2k, поэтому 1k имеет смысл только ради меньшего файла.Idempotency-Key: повтор того же запроса в течение 24 часов вернёт исходную операцию без повторного списания. Без заголовка повтор создаёт новую операцию и списывает деньги ещё раз.max_price в теле запроса, чтобы сервер отклонил запуск дороже согласованной суммы до списания.queued, затем проверяйте статус по id раз в 2-3 секунды.http/https ссылками на .jpg, .jpeg, .png или .webp, не больше 16 ссылок в image_urls.prompt, что взять с каждого: @image1, @image2 и так далее.4k даёт тяжёлые файлы, особенно в png. Если картинка нужна для сайта или соцсетей, выбирайте jpeg.validation_error.