promptstringОбязательноОбязательное описание сцены длиной не более 5 000 символов; готового текста по умолчанию и доплаты за промпт нет.
- По умолчанию
- Не задано
- Ограничения
- minLength:1maxLength:5000
MiniMax H3-Image — версия модели изображений, которую предоставляет сама MiniMax: по подробному английскому промпту создаёт статичное изображение PNG, JPEG или WebP в 1k, 2k или 4k, поддерживает 15 соотношений сторон и короткие читаемые надписи.
Примеры используют публичные параметры выбранного эндпоинта. Замените API-ключ и примеры медиафайлов, затем отправьте запрос со своего сервера.
SDK и интеграцииhttps://api.spicyapi.ai/api/v1/jobs/createTaskХраните API-ключ в серверной переменной окружения SPICY_API_KEY. Используйте Bearer-аутентификацию и Content-Type: application/json для JSON-запросов.
Authorization: Bearer $SPICY_API_KEY
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-image/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Пример построен по входной схеме этой модели — той же, по которой API проверяет каждый запрос.
Поместите эти поля в объект input тела запроса. Имена и типы соответствуют API. Не предполагайте значение по умолчанию, если оно не задано.
Некоторые поля зависят от других входных данных. Полные правила для условно обязательных полей приведены в JSON Schema ниже.
promptstringОбязательноОбязательное описание сцены длиной не более 5 000 символов; готового текста по умолчанию и доплаты за промпт нет.
seedintegerНеобязательноНеобязательное целое от 0 до 2 147 483 647, на цену не влияет. MiniMax повторно использует исходную точку только при выключенном расширении промпта, поэтому для сравнительных тестов сочетайте фиксированный seed с enable_prompt_expansion = false. Одинаковые картинки не гарантируются.
output_formatstringНеобязательноВыберите png, jpeg или webp для готового файла; по умолчанию используется png. Формат на цену не влияет.
"jpeg""png""webp"enable_prompt_expansionbooleanНеобязательноПо умолчанию true: MiniMax сначала переписывает сцену в более длинное английское описание. При false промпт передаётся дословно — например, когда процитированная надпись должна остаться ровно такой, как вы её ввели. На цену не влияет.
resolutionstringНеобязательноВлияет на ценуУровень разрешения: по умолчанию 1k, около 1 МП; 2k — около 4 МП; 4k — около 16 МП. Цена 1k и 2k одинакова, а 4k стоит втрое дороже. Собственный размер оплачивается по этому уровню: до 4,5 МП — 1k или 2k, крупнее — 4k.
"1k""2k""4k"heightintegerОбязательно при условииТочная высота в пикселях, 468–7 745; при aspect_ratio = custom обязательна вместе с width. Действуют те же диапазоны площади и ограничение формы 3:1, а цену определяет выбранное resolution.
widthintegerОбязательно при условииТочная ширина в пикселях, 468–7 745; используется только при aspect_ratio = custom и всегда вместе с height. Ширина × высота должна составлять 655 360–4 500 000 пикселей на 1k или 2k либо больше 4,5 млн и до 20 млн на 4k; длинная сторона не более чем втрое больше короткой.
aspect_ratiostringНеобязательноПо умолчанию — 1:1; доступны 1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9, а также custom для точного размера через width и height. Выбор формы не меняет стоимость генерации.
"1:1""16:9""9:16""4:3""3:4""3:2""2:3""21:9""9:21""2:1""1:2""3:1""1:3""5:4""4:5""custom"{
"type": "object",
"allOf": [
{
"if": {
"required": [
"aspect_ratio"
],
"properties": {
"aspect_ratio": {
"const": "custom"
}
}
},
"then": {
"required": [
"width",
"height"
]
}
}
],
"required": [
"prompt"
],
"x-pricing": {
"billingMode": "formula",
"variantFields": [
"resolution"
]
},
"properties": {
"seed": {
"type": "integer",
"x-ui": {
"order": 10,
"widget": "number"
},
"maximum": 2147483647,
"minimum": 0,
"description": "Random seed for controlled comparisons; it only repeats a starting point while prompt expansion is off."
},
"width": {
"type": "integer",
"x-ui": {
"step": 1,
"order": 77,
"widget": "slider",
"visible_when": {
"field": "aspect_ratio",
"equals": "custom"
}
},
"maximum": 7745,
"minimum": 468,
"description": "Output width in pixels when aspect_ratio is custom, 468 to 7,745; set height too. Width × height must fit the chosen resolution: up to 4.5 megapixels at 1k or 2k, up to 20 at 4k, with the long side at most three times the short side."
},
"height": {
"type": "integer",
"x-ui": {
"step": 1,
"order": 76,
"widget": "slider",
"visible_when": {
"field": "aspect_ratio",
"equals": "custom"
}
},
"maximum": 7745,
"minimum": 468,
"description": "Output height in pixels when aspect_ratio is custom, 468 to 7,745; set width too. Width × height must fit the chosen resolution: up to 4.5 megapixels at 1k or 2k, up to 20 at 4k, with the long side at most three times the short side."
},
"prompt": {
"type": "string",
"x-ui": {
"order": 100,
"widget": "textarea"
},
"maxLength": 5000,
"minLength": 1,
"description": "Describe the subject, the place and the light in plain sentences."
},
"resolution": {
"enum": [
"1k",
"2k",
"4k"
],
"type": "string",
"x-ui": {
"order": 70,
"widget": "radio",
"affects_price": true
},
"default": "1k",
"description": "Output size tier: 1k is about 1 megapixel, 2k about 4, 4k about 16. 1k and 2k cost the same. With a custom size, pick 1k or 2k for up to 4.5 megapixels and 4k above that."
},
"aspect_ratio": {
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"21:9",
"9:21",
"2:1",
"1:2",
"3:1",
"1:3",
"5:4",
"4:5",
"custom"
],
"type": "string",
"x-ui": {
"order": 80,
"widget": "select",
"enum_labels": {
"custom": "Custom size"
}
},
"default": "1:1",
"description": "Output aspect ratio; custom lets you set width and height."
},
"output_format": {
"enum": [
"jpeg",
"png",
"webp"
],
"type": "string",
"x-ui": {
"order": 20,
"widget": "select"
},
"default": "png",
"description": "Container of the returned image."
},
"enable_prompt_expansion": {
"type": "boolean",
"x-ui": {
"order": 60,
"widget": "switch"
},
"default": true,
"description": "Let MiniMax rewrite the prompt into a fuller English description before drawing. On by default; turn it off to have the prompt followed as written."
}
},
"additionalProperties": false
}HTTP 202 означает принятие задачи, а не завершение генерации. Сохраните полученный taskId и проверяйте эту задачу. Не создавайте новую, пока ждёте результат.
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3
{
"code": 200,
"msg": "success",
"request_id": "req_example_create",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"state": "queued",
"estimatedCost": "0.750000"
}
}В ответе о приёме есть оценка стоимости — приложение сможет показать ту же сумму в истории задач и в расчётах.
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
--data-urlencode "taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"Начните с интервала около 2 секунд и постепенно увеличивайте его. Прекратите опрос при конечном состоянии. После сбоя соединения используйте исходный taskId. Повторно создавать задачу можно только с исходным ключом идемпотентности и исходным телом запроса.
import { verifyWebhook } from "@spicyapi/sdk";
// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
const { payload } = verifyWebhook({
rawBody: req.body,
timestamp: req.header("X-Webhook-Timestamp"),
signature: req.header("X-Webhook-Signature"),
payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
secret: process.env.SPICY_WEBHOOK_SECRET,
});
res.status(200).end();
void handleFinishedTask(payload);
});Передайте callBackUrl при создании задачи — готовая запись придёт к вам POST-запросом, и никакого опроса не понадобится. В каждой доставке есть X-Webhook-Timestamp, X-Webhook-Signature и X-Webhook-Payload-Version. Подпись — это HMAC-SHA256 в base64 от taskId.timestamp.sha256(body), поэтому проверять её нужно по исходным байтам: если разобрать JSON и сериализовать заново, байты изменятся и проверка не пройдёт. Неудачные доставки повторяются, так что один и тот же taskId может прийти дважды — сделайте обработчик идемпотентным. Сначала ответьте 2xx, работу выполняйте после: медленный обработчик считается неудачной доставкой.
Обрабатывайте output только при state, равном succeeded. При ошибке проверьте errorCode, errorMessage и request_id. Стоимость и состояния в примерах не являются фактическим счётом.
{
"code": 200,
"msg": "success",
"request_id": "req_example_record",
"data": {
"taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
"model": "minimax/h3-image/text-to-image",
"state": "succeeded",
"output": {
"assets": [
{
"key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.png",
"mime": "image/png",
"url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.png?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
"expiresAt": "2026-08-28T12:20:08.000Z"
}
]
},
"cost": "0.750000",
"settled": true,
"createdAt": "2026-08-28T12:00:00Z",
"completedAt": "2026-08-28T12:00:30Z"
}
}Доступные файлы можно открыть или скачать по assets[].url без заголовка API Authorization. Подписанная ссылка действует до expiresAt. Чтобы обновить её, повторно запросите задачу в течение срока хранения файла. У ожидающих или недоступных файлов URL отсутствует. Не передавайте подписанные ссылки посторонним.
Используйте SpicyAPI в приложении, терминале, ИИ-ассистенте или визуальном процессе. Выберите руководство по настройке.
Писать код выше вовсе не обязательно. Подключите сервер MCP один раз — и любой агент, который говорит на MCP (Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat), вызовет эту модель по имени. Либо запустите её из терминала одной командой.
Возьми minimax/h3-image/text-to-image и сгенерируй портрет танцовщицы в неоновом свете, сохрани в ./out/.
Агент найдёт модель в каталоге, сам загрузит локальный файл, покажет точную смету и предельную сумму списания — и дождётся вашего согласия. До этого ничего не списывается.
claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
-- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skillПервая строка даёт агенту инструменты, вторая — Skill, то есть правила обращения с ними: сначала смета, потом списание; локальные файлы загружать, а не вставлять байтами; URL готового результата читать, а не угадывать. Остальные клиенты подключают тот же сервер через собственный файл настроек — см. раздел для разработчиков.
npx @spicyapi/cli tasks create --model minimax/h3-image/text-to-image \
--input-json '{"prompt":"A ceramic teapot on a linen cloth, soft window light, muted palette","resolution":"1k","aspect_ratio":"1:1","output_format":"png"}' \
--waitВходные данные взяты из схемы этого эндпоинта — той же, что и в примерах выше. --wait дождётся завершения задачи и выведет её, а --yes пропустит подтверждение в CI. Сначала задайте SPICY_API_KEY: один ключ работает и для API, и для CLI, и для сервера MCP.
npx @spicyapi/cli tasks create --model minimax/h3-image/text-to-image \
--input-json '{…}' --retention 1h --wait
npx @spicyapi/cli tasks get $TASK_ID # read back the retention that appliedКлюч --retention только сокращает срок — 30m, 1h, 7d или 0, чтобы удалить сразу после перехода задачи в конечное состояние. Реально действует наименьшее из трёх: ваш запрос, настройки аккаунта и предел платформы, — поэтому считайте его из записи задачи, а не исходите из того, что запрошенное число применилось. Запросить срок больше разрешённого аккаунтом нельзя: это ничего не изменит.
Установите узлы SpicyAPI через ComfyUI Manager или командой ниже и найдите на холсте MiniMax H3-Image · Text to Image. У узла те же параметры, что и на этой странице, а цена показывается до запуска.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapiВстроенная панель читает ту же схему, что и эта страница, поэтому не может разойтись с API. Если содержимое должно индексироваться поиском по документации, возьмите JSON из /api/embed/models/ и отрисуйте его самостоятельно.
<iframe src="https://spicyapi.ai/embed/ru/models/minimax-h3-image/api?model=minimax%2Fh3-image%2Ftext-to-image" width="100%" height="560" loading="lazy" title="Пример запроса" style="border:1px solid rgba(0,0,0,.12)"></iframe>