Grok Imagine Image Quality
model-grok-imagine-image-qualityPOST/v1/generationsОриентирот 8,43 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#promptstringобязательныйЧто нужно создать? — Опишите сюжет, композицию, стиль и важные детали.
- По умолчанию
- нет
- Ограничения
- до 8000 символов
image_urlsfile[] · inputAssetsнеобязательныйИзображения для редактирования — Необязательно: добавьте исходные изображения, чтобы внести изменения.
- По умолчанию
- нет
- Ограничения
- до 3 файлов · форматы: image/* · сценарии: scenario-0
image_sizestring (размер)необязательныйРазмер изображения — Выберите размер и соотношение сторон готового изображения.
- По умолчанию
"1024x1024"
Допустимые значения
1024x10241024 × 1024 (1:1) · квадрат1024x7681024 × 768 (4:3) · альбом1536x10241536 × 1024 (3:2) · альбом1920x10801920 × 1080 (16:9) · Full HD2560x14402560 × 1440 (16:9) · 2K768x1024768 × 1024 (3:4) · портрет1024x15361024 × 1536 (2:3) · портрет1080x19201080 × 1920 (9:16) · Full HD1440x25601440 × 2560 (9:16) · 2K2048x20481:1 · 2K2048x15364:3 · 2K1536x20483:4 · 2K1024x57616:9 · 1K2048x115216:9 · 2K576x10249:16 · 1K1152x20489:16 · 2K680x10242:3 · 1K1368x20482:3 · 2K1024x6803:2 · 1K2048x13683:2 · 2K1024x5122:1 · 1K2048x10242:1 · 2K1024x46420:9 · 1K2048x92020:9 · 2K1024x47219.5:9 · 1K2048x94419.5:9 · 2K472x10249:19.5 · 1K944x20489:19.5 · 2K464x10249:20 · 1K920x20489:20 · 2K512x10241:2 · 1K1024x20481:2 · 2K
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0передан файл image_urls
Активные поля: prompt, image_urls, image_size
{
"model": "model-grok-imagine-image-quality",
"values": {
"prompt": "Describe the desired result",
"image_size": "1024x1024"
},
"inputAssets": [
{
"fieldName": "image_urls",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}scenario-1по умолчанию
Активные поля: prompt, image_size
{
"model": "model-grok-imagine-image-quality",
"values": {
"prompt": "Describe the desired result",
"image_size": "1024x1024"
},
"inputAssets": []
}Цена и результат
#Ориентир при стандартных настройках — 8,43 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.
Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.
Машиночитаемая схема: GET /v1/generation-models/model-grok-imagine-image-quality. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.