Введение
Увеличение с Gigapixel
Gigapixel предлагает точное увеличение и генеративную реконструкцию. Если пресет не задан, используется standard_v2.
Настройка запроса
Передайте image_url и выберите resolution: 2k, 4k или 8k, по умолчанию 4k. Исходный формат результата — JPEG.
Условия выдачи
Для прозрачного материала объедините preset: transparent и output_format: png, затем проверьте края.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Вход | JPEG, PNG, WebP |
| Пресет по умолчанию |
|
| Исходный уровень | 4K |
| Выход | JPEG или PNG; прозрачность всегда в PNG |
| Расчёт | За изображение, по пресету и уровню |
Ключевые возможности и особенности
Одного увеличения числа пикселей недостаточно
Слева направо: исходник, Standard V2 и Wonder 4. Standard увеличивает и само размытие; Wonder в этом тесте воссоздаёт более чёткое лицо, сохраняя общее сходство.
Проверяйте не только резкость, но и черты лица
Redefine сделал мужчину моложе и изменил черты. Recover 3 и Standard MAX тоже воссоздали детали; Detail оставил это сильно размытое лицо более мягким. Эти наблюдения относятся к одному изображению.
Роза становится крупнее, а фон остаётся прозрачным
Вырезанная жёлто-оранжевая роза увеличена с 400×301 до 2360×1776 пикселей с сохранением альфа-канала. На розовых кончиках лепестков видны капли воды, рядом — короткий зелёный стебель и листья. Тёмный фон нужен только для сравнения; файл примера сохраняет прозрачность.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Фото или графика JPEG, PNG либо WebP, которую нужно увеличить через Gigapixel. Не менее 1 символов |
preset | Нет | Двенадцать вариантов: пять точных, шесть генеративных и |
resolution | Нет |
|
output_format | Нет | Обычно Gigapixel возвращает |
Стоимость
Gigapixel тарифицирует каждое обработанное изображение по preset и resolution. Изменение output_format не влияет на стоимость.
| Разрешение | Пресет стиля: cgi | Пресет стиля: detail | Пресет стиля: high_fidelity_v3 | Пресет стиля: low_resolution_v2 | Пресет стиля: standard_v2 | Пресет стиля: text_refine | Пресет стиля: transparent | Пресет стиля: wonder_3_5 | Пресет стиля: wonder_4 | Пресет стиля: recover_3 | Пресет стиля: redefine | Пресет стиля: standard_max |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.24 / изображение | $0.24 / изображение | $0.24 / изображение |
| $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.12 / изображение | $0.36 / изображение | $0.36 / изображение | $0.60 / изображение | $0.60 / изображение | $0.60 / изображение |
| $0.36 / изображение | $0.36 / изображение | $0.36 / изображение | $0.36 / изображение | $0.36 / изображение | $0.36 / изображение | $0.36 / изображение | $1.08 / изображение | $1.08 / изображение | $2.04 / изображение | $2.04 / изображение | $2.04 / изображение |
Сценарии использования
Подготовка изображения к печати
Выберите уровень результата и проверьте лица и мелкие узоры перед печатью.
Увеличение логотипа или вырезанного объекта
Попробуйте text_refine для текста и графики либо transparent, если у PNG должен остаться прозрачный фон.
Руководство по промптам и практические советы
Укажите исходник
Передайте фотографию или графику JPEG, PNG либо WebP в
image_url.Выберите способ реконструкции
Начните со
standard_v2, чтобы сохранить содержание, или выберитеwonder_4для воссоздания деталей.Задайте результат
Выберите
resolutionи формат; дляtransparentявно укажитеoutput_format: png.
Увеличение с Gigapixel
Один пресет Gigapixel увеличивает фото или графику до выбранного уровня площади в пикселях; прозрачные изображения возвращаются в PNG.
Настройка запроса
{
"image_url": "https://example.com/blurred-portrait.jpg",
"preset": "standard_v2",
"resolution": "2k",
"output_format": "jpeg"
}
Выбор пресета
preset | Подходящий материал |
|---|---|
standard_v2 | Обычные фото; точный вариант по умолчанию |
high_fidelity_v3 | Уже чёткий материал высокого разрешения |
low_resolution_v2 | Маленькие или сильно сжатые изображения |
cgi | Иллюстрации и рендеры |
text_refine | Текст, логотипы и графика |
wonder_4 | Новейшая универсальная генеративная модель |
wonder_3_5 | Генеративная реконструкция Wonder 3.5 |
recover_3 | Сильно повреждённые фотографии |
standard_max | Генеративное воссоздание деталей |
redefine | Добавление деталей с возможным изменением сходства |
detail | Более реалистичная кожа на лицах из ИИ |
transparent | Увеличение PNG с альфа-каналом |
Наблюдения по результатам
Слева направо: исходник, Standard V2 и Wonder 4. Standard увеличивает и само размытие; Wonder в этом тесте воссоздаёт более чёткое лицо, сохраняя общее сходство.
Redefine сделал мужчину моложе и изменил черты. Recover 3 и Standard MAX тоже воссоздали детали; Detail оставил это сильно размытое лицо более мягким. Эти наблюдения относятся к одному изображению.
Вырезанная жёлто-оранжевая роза увеличена с 400×301 до 2360×1776 пикселей с сохранением альфа-канала. На розовых кончиках лепестков видны капли воды, рядом — короткий зелёный стебель и листья. Тёмный фон нужен только для сравнения; файл примера сохраняет прозрачность.
Условия выдачи
Один запрос обрабатывает одно изображение одним пресетом. Генеративные модели могут менять лица и мелкие детали, поэтому не подходят для документов, удостоверяющих личность, и доказательной реконструкции. Файлы 8K могут быть большими. Сочетание transparent с JPEG отклоняется.
Быстрый старт 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": "topaz/gigapixel/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "standard_v2",
"resolution": "4k"
}
}'
# 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.
