Введение
В режиме «Редактирование изображения» P-H3-Image использует первую картинку как исходник и принимает до восьми дополнительных референсов. Текстовая инструкция задаёт, какие элементы сохранить, а какие заменить.
Ключевые возможности и особенности
Обращайтесь к исходнику как <Picture 1>, а к следующему изображению — как <Picture 2>. По умолчанию форма результата берётся из первой картинки; параметр aspect_ratio позволяет её переопределить. При редактировании доступны все пять уровней разрешения. В наших тестах одна правка в 4k дала 3360 x 5024 пикселя.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязательная инструкция по редактированию, без значения по умолчанию. Укажите, что изменить и что оставить; при объединении исходников ссылайтесь на номера изображений. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | Обязательный упорядоченный список из 1–9 URL изображений; исходника по умолчанию нет. Не менее 1 элементов · Не более 9 элементов |
aspect_ratio | Нет | Оставьте это необязательное поле пустым, чтобы взять соотношение сторон первого изображения. |
resolution | Нет | Для правки по умолчанию используется 1k — около 1 мегапикселя. |
output_format | Нет | Результат сохраняется в jpeg, если не запросить png или webp. Все три формата стоят одинаково. |
seed | Нет | При сравнении правок можно задать источник случайности; по умолчанию фиксированное значение не требуется. |
Стоимость
Отредактированное изображение оплачивается по уровню 1k, 1.5k, 2k, 3k или 4k. За каждое входное изображение после первого взимается небольшая доплата; за соотношение сторон и формат — нет. Неудачный запрос не оплачивается.
| Спецификация | Стоимость |
|---|---|
| $0.03 / изображение |
| $0.048 / изображение |
| $0.066 / изображение |
| $0.138 / изображение |
| $0.21 / изображение |
Сценарии использования
Используйте один портрет для нового наряда и обстановки у моря или объедините фотографию сцены с изображением другой исполнительницы. В тестах с одним и двумя исходниками запрошенная внешность сохранялась при смене сцены.
Руководство по промптам и практические советы
Поставьте сцену, которую хотите сохранить, первой, затем укажите, какие детали брать из каждого пронумерованного изображения. В наших тестах обратный порядок давал результат, более близкий к другой сцене. Каждый референс после первого немного увеличивает стоимость. По данным Pruna AI, при меньшем разрешении артефакты в деталях могут быть заметнее.
Быстрый старт 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/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.
