popnow
ВойтиСоздавать

prefect/pony-xl/text-to-imageОт 3 кредитов за изображение

Prefect Pony XL — аниме-чекпойнт сообщества из линейки Pony XL, опубликованный здесь как единственный endpoint text-to-image. Он принимает промпт до 5 000 символов, семь нативных размеров SDXL, необязательный seed и вывод в JPEG, PNG или WebP.

Вызывайте его по имени модели prefect/pony-xl/text-to-image через POST /jobs/createTask, от 3 кредита за изображение (0,03 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.

  • Создать картинку
от PrefectПолучить API-ключPrefect Pony XL: примеры и промпты →

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
seedНетОдно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647
sizeНетOutput image size in pixels, written as width*height. All values are native SDXL shapes. 1024*1024 · 896*1152 · 1152*896 · 832*1216 · 1216*832 · 768*1344 · 1344*768 · По умолчанию: 1024*1024
promptДаDescribe the image as comma-separated tags: quality tags first, then subject and wardrobe, then lighting and lens.
output_formatНетФормат файла результата. png · jpeg · webp · По умолчанию: png

Цены

Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.

ВариантКредиты за изображение≈ USD
Стандарт2,250,023 $

Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 3 кредита за изображение (0,03 $).

Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.

Быстрый старт API

Вызов API Prefect Pony XL в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model prefect/pony-xl/text-to-image и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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": "prefect/pony-xl/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "size": "1024*1024",
    "output_format": "png"
  }
}'

# 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 Prefect Pony XL

Сколько стоит API Prefect Pony XL?

Prefect Pony XL стоит 3 кредита (0,03 $) за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.

Какое имя модели у Prefect Pony XL в API?

Укажите prefect/pony-xl/text-to-image — Создать картинку в поле model запроса POST /jobs/createTask.

Как писать для него промпты?

Тегами через запятую, теги качества первыми. Его обучали так же, как обучают локальные чекпойнты SDXL, поэтому привычки из той экосистемы переносятся напрямую. Длинные описательные предложения работают, но ведут слабее, чем теги.

Можно ли получить одно и то же изображение дважды?

Да — передайте тот же seed с тем же промптом и тем же размером. Оставьте seed пустым, и каждый вызов вернёт другой кадр. Храните seed рядом с любым кадром, который может понадобиться собрать заново.

Можно ли отправить референсное изображение?

Нет. Этот endpoint работает только из текста: ни входного изображения, ни inpainting, ни обусловливания в духе ControlNet. Для правок на основе изображения возьмите один из endpoint image-to-image в каталоге.

Какие размеры доступны и почему именно эти?

Семь размеров, все в нативных пиксельных сетках SDXL: 1024*1024, 896*1152, 1152*896, 832*1216, 1216*832, 768*1344 и 1344*768. Запрос пропорции вне обучения на модели SDXL — типичная причина разваливающейся анатомии, поэтому endpoint открывает обученные форматы, а не произвольные ширину и высоту.

Какие ограничения у API Prefect Pony XL?

Длина промпта (символов): 5,000. Запросы за пределами этих ограничений отклоняются до любого списания.

Можно попробовать Prefect Pony XL без кода?

Да. Playground запускает Prefect Pony XL на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.

Все модели Prefect Pony XL

Ещё о Prefect Pony XL