О модели Pose Changer
Новая поза по короткому описанию или фото-образцу.
Вызывайте его по имени модели popnow/pose-changer-v1/edit через POST /jobs/createTask, от 30 кредитов за изображение (0,03 $).
Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | Да | Картинка, с которой всё начинается. |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
prompt | Нет | Optional extra direction added after the built-in pose instruction, e.g. to keep your own background or outfit. |
reference_image_url | Да | A photo of the pose to copy; only the pose is used. JPEG, PNG or WebP, up to 10 MB. |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,001). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 30 | 0,03 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Pose Changer в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/pose-changer-v1/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/pose-changer-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"reference_image_url": "https://media.popnow.ai/influencer/examples/ava.webp",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Pose Changer
Сколько стоит API Pose Changer?
Pose Changer стоит 30 кредитов (0,03 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,001 $), а за неудачные задачи кредиты возвращаются.
Какое имя модели у Pose Changer в API?
Укажите popnow/pose-changer-v1/edit — Смена позы в поле model запроса POST /jobs/createTask.
Какое фото за что отвечает?
image_url — человек, которого нужно переставить. reference_image_url — фото, позу с которого нужно скопировать; человек на нём не сохраняется.
Нужно ли писать промпт?
Нет. Встроенная инструкция по переносу позы от автора LoRA уже учтена. Используйте prompt только для дополнительных указаний, например чтобы сохранить фон или назвать наряд.
Чем это отличается от обычного редактора изображений?
При тех же двух фото, инструкции и seed базовая модель без LoRA AnyPose поставила танцовщицу с фото позы в первую сцену вместо того, чтобы переставить женщину. С LoRA женщина приняла позу танцовщицы.
Почему изменился фон?
LoRA обучены переносить человека в позу с фото позы. Добавьте в промпт «Remove the background of image 2, and replace it with the background of image 1.»
Можно ли взять рисунок или 3D-манекен в качестве позы?
Лучше всего в наших тестах работали фото реальных людей. Автор отмечает, что плоские 2D-стили слабо работают.
Какие ограничения у API Pose Changer?
Соотношения сторон: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Длина промпта (символов): 1,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Pose Changer без кода?
Да. Playground запускает Pose Changer на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.