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

alibaba/z-image-turbo/text-to-imageОт 2 кредитов за изображение

Z-Image — компактное семейство изображений Tongyi на 6B, настроенное на фотореалистичный результат примерно за секунду и опубликованное одним эндпоинтом text-to-image. Пять соотношений сторон, PNG без потерь, prompt до 1000 символов.

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

  • Создать картинку
  • Соотношений сторон: 5
от AlibabaПолучить API-ключZ-Image: примеры и промпты →

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

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

ПараметрОбязательныйОписание
seedНетОдно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647
promptДаDescribe the image to generate: subject, composition, style, and lighting.
aspect_ratioНетФорма кадра: широкая, квадратная или вертикальная. 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · По умолчанию: 1:1
output_formatНетФормат файла результата. png · По умолчанию: png
enable_prompt_expansionНетМодель дописывает детали к короткому промпту. По умолчанию: false

Цены

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

ВариантКредиты за изображение≈ USD
Стандарт1,50,015 $
enable_prompt_expansion true2,40,024 $

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

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

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

Вызов API Z-Image в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model alibaba/z-image-turbo/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": "alibaba/z-image-turbo/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "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 Z-Image

Сколько стоит API Z-Image?

Z-Image стоит 2 кредита (0,02 $) за изображение. Цены по вариантам: Стандарт 1,5 кредита за изображение, true 2,4 кредита за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.

Какое имя модели у Z-Image в API?

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

Насколько Z-Image быстр на самом деле?

Примерно секунда на кадр text-to-image. В этом и смысл семейства: цикл достаточно короткий, чтобы относиться к формулировке как к эксперименту, а не как к обязательству.

Чем на самом деле управляет aspect_ratio?

Размерами результата в пикселях. Каждое соотношение привязано к фиксированному размеру около нативного мегапикселя модели, поэтому качество между соотношениями остаётся ровным и не разваливается на крайних.

Можно ли воспроизвести прежнюю картинку?

Очень близко, если вы сохранили seed: с тем же промптом, соотношением сторон и seed результат ложится рядом с прежним кадром, хотя попиксельного совпадения seed не гарантирует. Без seed одинаковые запросы возвращают разные кадры, поэтому храните prompt и seed рядом с любым файлом, который хотите сохранить.

Почему лимит prompt всего 1000 символов?

Это максимум, который принимает эндпоинт: более длинный prompt отклоняется до отправки, а не обрезается молча. Это совпадает и с тем, что компактная модель на 6B действительно использует: плотное описание героя, света и фактуры здесь работает лучше длинного списка планов.

Какие ограничения у API Z-Image?

Соотношения сторон: 1:1 · 4:3 · 3:4 · 16:9 · 9:16; Длина промпта (символов): 1,000. Запросы за пределами этих ограничений отклоняются до любого списания.

Можно попробовать Z-Image без кода?

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

Все модели Z-Image

Z-Image Turbo LoRA запускает то же семейство с твоими LoRA и добавляет изображение в изображение.

Ещё о Z-Image