Введение
Image Expander расширяет фотографию наружу, придавая ей новую форму. Выберите целевое соотношение сторон, и инструмент сохранит ваш снимок, поместит его в более широкую или высокую рамку и дорисует в пустом пространстве новое окружение, так что результат читается как одно цельное изображение. Это противоположность кадрированию: от оригинала ничего не отрезается и ничего не растягивается, чтобы заполнить рамку.
Ключевые возможности и особенности
Семь целевых форм
Итоговое изображение может быть квадратным, горизонтальным или вертикальным: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 или 2:3. Этого хватает на посты в ленту, обложки видео, сторис, баннеры и макеты в духе печати из одного исходного снимка, без планирования каждого кадрирования еще на съемке.
Продолжение вместо заполнения
Новая область дорисовывается так, чтобы продолжать то, что уже есть. Пол, небо, стены, листва и направление света тянутся за прежний край, а не заполняются размытием, зеркальными краями или сплошным цветом.
Никаких промптов
Расширение выводится из самого изображения. Одна картинка и одна пропорция — это весь запрос, поэтому папку вертикальных снимков легко превратить в горизонтальные баннеры одним пакетом.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Фотография для расширения в формате JPEG, PNG или WebP. Она помещается в большую рамку, а окружение дорисовывается вокруг. Не менее 1 символов |
aspect_ratio | Нет | Форма итогового изображения. Длинная сторона всегда 1536 пикселей: 16:9 дает 1536 × 864, 9:16 дает 864 × 1536, а 1:1 дает 1536 × 1536. |
output_format | Нет | По умолчанию PNG; JPEG или WebP — для файлов меньшего размера. |
Стоимость
$0.024 / изображение
Оплата за каждое готовое изображение; выбранное соотношение сторон на цену не влияет.
Сценарии использования
Одна съемка — все форматы
Сделайте из вертикального снимка товара или портрета шапку сайта 16:9 и плитку 1:1 для маркетплейса без пересъемки и без неуклюжих полос по краям кадра.
Место для текста и верстки
Добавьте вокруг объекта небо или фон, чтобы освободить чистое место для заголовка, логотипа или призыва к действию на баннере, превью или слайде презентации.
Исправление тесных кадров
Верните воздух фотографиям, скадрированным слишком плотно: обрезанный локоть, стул, срезанный краем, горизонт, прижатый к рамке.
Руководство по промптам и практические советы
Выбирайте пропорцию под место публикации
До расширения решите, где будет использоваться изображение: 16:9 для обложек видео и шапок, 9:16 для сторис и рилсов, 1:1 для лент и маркетплейсов, 3:2 или 2:3 для макетов в духе печати. Чем дальше новая форма от исходной, тем больше окружения приходится придумывать, поэтому умеренные изменения вписываются лучше всего.
Учитывайте размер результата
У расширенного изображения длинная сторона 1536 пикселей. Большой оригинал поэтому возвращается меньше, чем был; если месту публикации нужно больше пикселей, увеличьте результат после, а не начинайте с исходника худшего качества.
Начинайте с чистых краев
Инструмент продолжает все, что касается края фотографии. Простые фоны вроде неба, студийного фона, оштукатуренных стен или песка расширяются убедительнее всего. Когда лицо, рука или надпись обрезаны краем, недостающую часть инструменту приходится выдумывать, и именно там результат наименее предсказуем, поэтому выбирайте исходник с запасом пространства вокруг таких деталей.
Быстрый старт 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": "spicyapi/image-expander-v1/edit",
"input": {
"aspect_ratio": "1:1",
"image_url": "https://example.com/reference.png",
"output_format": "png"
}
}'
# 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.
