Введение
P-H3-Image LoRA в режиме «Текст в изображение» принимает веса MiniMax H3 LoRA для создания статичного кадра по описанию. В основе лежит та же модель P-H3-Image, что и у эндпоинта без подключённых файлов.
Ключевые возможности и особенности
Подключите не более трёх файлов и задайте каждому scale от 0 до 4. В наших тестах vh5tape с силой 1 меняла изображение при том же seed, а реалистичный файл при 0,8 давал едва заметную разницу. Доступны все пять уровней разрешения вплоть до 4k.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательное поле без готового текста. Добавьте триггерное слово LoRA из обучения, затем кратко опишите нужную сцену. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Для генерации с LoRA выберите одно из 15 соотношений сторон; по умолчанию используется 1:1. |
resolution | Нет | Начальный размер — 1k (~1 МП); можно выбрать 1.5k (~2,4 МП), 2k (~4 МП), 3k (~9,4 МП) или 4k (~16,8 МП). У каждого уровня разрешения своя цена за изображение. |
loras | Нет | Необязательный список до 3 записей {path, scale} для файлов, обученных под MiniMax H3; для контрольного запуска не подключайте файлы. Сила scale задаётся от 0 до 4, по умолчанию 1. По умолчанию: |
output_format | Нет | Для создаваемого файла выберите jpeg, png или webp; если поле не задано, используется jpeg. Выбор формата не увеличивает стоимость. |
seed | Нет | Повторно используйте seed как общий источник случайности при проверке одного изменения LoRA; это необязательное поле без требуемого значения по умолчанию. |
Стоимость
Цена складывается из выбранного уровня разрешения и небольшой фиксированной доплаты LoRA; от нуля до трёх файлов стоят одинаково. За соотношение сторон и формат доплаты нет; при редактировании каждый исходник после первого немного увеличивает цену. Неудачные запросы не оплачиваются, но при пропуске неверных ссылок LoRA без уведомления созданные изображения всё равно тарифицируются.
| Спецификация | Стоимость |
|---|---|
| $0.042 / изображение |
| $0.054 / изображение |
| $0.066 / изображение |
| $0.114 / изображение |
| $0.162 / изображение |
Сценарии использования
Попробуйте сцену у мотеля с VHS-файлом или клубное трио со Studio1939 style. Для преобразования исходной фотографии откройте Редактирование изображения с LoRA.
Руководство по промптам и практические советы
Начните с контрольного изображения в 1k без LoRA, затем повторите prompt и seed с подключённым файлом. Укажите настоящий URL скачивания .safetensors и триггерное слово файла. В наших тестах ссылки на страницы репозиториев и отсутствующие файлы приводили к пропуску LoRA без уведомления; генерация всё равно завершалась и оплачивалась. Фиксированная доплата за изображение взимается независимо от числа подключённых файлов.
Быстрый старт API
# 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": "pruna-ai/p-h3-image-lora/text-to-image",
"input": {
"aspect_ratio": "1:1",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
