Введение
P-H3-Image LoRA в режиме «Редактирование изображения» применяет файлы, обученные под H3, при преобразовании первой переданной картинки. Можно добавить ещё восемь референсов и указать, что брать из каждого.
Ключевые возможности и особенности
В тесте с мультфильмом Studio1939 style с силой 1 перерисовала певицу, сохранив позу, платье и микрофон. Поле LoRA поддерживает до трёх записей с отдельным scale от 0 до 4 для каждого файла.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Напишите обязательную инструкцию по преобразованию и триггерное слово из обучения; готовой инструкции по умолчанию нет. Назначьте роли исходникам через пронумерованные обозначения. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | Передайте 1–9 URL в нужном порядке; для редактирования этот список обязателен, картинки по умолчанию нет. Не менее 1 элементов · Не более 9 элементов |
aspect_ratio | Нет | Если поле не задано, форму определяет первый исходник. |
resolution | Нет | Для редактирования с LoRA размер по умолчанию — 1k (~1 МП). |
loras | Нет | Подключите до трёх файлов, обученных под MiniMax H3, через записи {path, scale} или не подключайте их для контрольного запуска; scale — от 0 до 4, по умолчанию 1. По умолчанию: |
output_format | Нет | По умолчанию результат сохраняется в jpeg, вместо него можно выбрать png или webp. Смена формата не меняет тариф за изображение. |
seed | Нет | Необязательный источник случайности; если поле не задано, фиксированный seed не требуется. |
Стоимость
Правка с LoRA оплачивается за изображение по разрешению с небольшой фиксированной доплатой независимо от числа файлов. Каждый референс после первого немного увеличивает стоимость. Соотношение сторон и формат на цену не влияют. Неудачные запросы не оплачиваются; неверная ссылка LoRA может быть пропущена, а созданное изображение при этом оплачивается.
| Спецификация | Стоимость |
|---|---|
| $0.048 / изображение |
| $0.066 / изображение |
| $0.084 / изображение |
| $0.156 / изображение |
| $0.228 / изображение |
Сценарии использования
Преобразуйте фотографию сцены в мультфильм той эпохи или задайте сцену в гостиной с джинсовой курткой и VHS-обработкой. Добавьте триггерное слово из обучения в инструкцию по редактированию и обращайтесь к исходнику как <Picture 1>.
Руководство по промптам и практические советы
Чтобы оценить влияние файла, сохраняйте входные изображения, prompt и seed между контрольным запуском без LoRA и запуском с ней. Такое сравнение использует общий источник случайности, но не гарантирует одинаковых пикселей. Убедитесь, что path содержит прямую ссылку на файл весов: при неверной ссылке стиль может не примениться, хотя правка завершится успешно и будет оплачена. Пустой loras также не отменяет доплату эндпоинта 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/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"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.
