Введение
Что делает этот эндпоинт
Qwen Image 2.1 Pro Text to Image превращает письменное задание в от одного до шести изображений за запрос на размещённом уровне Pro модели Alibaba Qwen Image 2.1. Наши запросы занимали от 14 до 43 секунд от начала до конца.
Входные данные
prompt содержит всё задание, до 5 000 символов. num_outputs задаёт от одного до шести изображений. aspect_ratio выбирает одну из пятнадцати форм, а resolution — уровень 1k, 1.5k или 2k; цена за изображение везде одна. enable_prompt_expansion (по умолчанию выключено) позволяет Alibaba сначала переписать промпт, а prompt_optimization_mode и enable_thinking определяют, как именно. seed стабилизирует серию.
Контент
Фильтра на стороне платформы нет. При выключенном расширении все наши контентные тесты прошли как написано.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Статус на SpicyAPI | Работает: text-to-image и редактирование изображений |
| Основа | Qwen Image 2.1, в виде размещённого уровня Pro от Alibaba |
| Изображений за запрос | От 1 до 6, оплата за каждое возвращённое изображение |
| Цена | Одна цена за изображение на уровнях 1k, 1.5k и 2k; актуальное значение — на этой странице |
| Соотношения сторон | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Размеры в 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Редактирование | От 1 до 10 референсов; без соотношения сторон результат следует исходнику примерно в 2K |
| Промпт | До 5 000 символов; негативного промпта нет, исключения пишите в сам промпт |
| Расширение промпта | По умолчанию выключено; при включении — переписывание direct или agent, с необязательным проходом thinking |
| Измеренное ожидание | От 14 до 43 секунд для text-to-image, от 39 до 48 секунд для правок, по нашим прогонам |
| Политика контента | Без цензуры: фильтра на стороне платформы нет, флага зрелости нет |
| Веса | Не опубликованы; Alibaba предлагает Pro как размещённый API |
Ключевые возможности и особенности
Заголовок, написанный верно с первого раза
Берите слова в кавычки и указывайте, где они стоят. «AFTER DARK» вверху и небольшая строка обложки под ним вернулись буква в букву на обоих изображениях запроса.
Два портрета, один стол при свечах
Мужчина и женщина, снятые по отдельности и названные Image 1 и Image 2, оказываются за одним столом на террасе виноградника: оба лица по-прежнему узнаваемы, а её платье изменено, как просили.
Pro или Turbo — без переписывания ни строки
На SpicyAPI Pro и Turbo читают одни и те же поля, поэтому промпт, работающий в одной модели, можно без изменений отправить в другую. Набрасывайте быстро в Turbo и оставляйте важные кадры для Pro — или наоборот.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Всё задание, до 5 000 символов. Пишите объект, одежду, позу, свет и объектив простыми предложениями. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Пятнадцать форм — от полос 3:1 и 21:9 до колонн 1:3 и 9:21. Кадр компонуется сразу в этой форме, а не вырезается из квадрата. |
resolution | Нет | 1k, 1.5k или 2k. Все уровни стоят одинаково за изображение, поэтому по умолчанию 2k. |
num_outputs | Нет | От одного до шести изображений по одному промпту в одном запросе. Каждое возвращённое изображение тарифицируется, так что шесть изображений стоят в шесть раз больше одного. |
enable_prompt_expansion | Нет | По умолчанию выключено, поэтому ваша формулировка рисуется как написано. По умолчанию: |
enable_thinking | Нет | Тратит дополнительные рассуждения на переписывание ради лучшего изображения ценой более долгого ожидания. Работает только при включённом расширении промпта. По умолчанию: |
prompt_optimization_mode | Нет | Как расширение переписывает задание, когда оно включено: direct — один проход, подходит большинству промптов, agent — многошаговое переписывание с более тонкой детализацией. |
seed | Нет | Стабилизирует бросок, чтобы вы могли менять одно за раз и сравнивать честно. Не гарантирует пиксельно идентичное изображение. |
Стоимость
$0.036 / изображение
Сценарии использования
Работа с изображениями без цензуры
SpicyAPI не ставит перед Pro фильтр контента. При выключенном расширении промпта наши тесты вернулись как написано на каждом уровне интенсивности, который мы проверяли, — от Мягкого до Максимального, с женскими и мужскими персонажами.
Обложки и плакаты с точным текстом
Alibaba называет у Pro улучшенную типографику. Возьмите в кавычки заголовок и строку обложки, скажите, где каждая стоит, и опишите фотографию: наша обложка журнала вернулась с обеими строками, написанными точно, на обоих изображениях запроса.
Один персонаж на всю серию
Сгенерируйте персонажа, затем отправьте кадр обратно как референс и меняйте наряд, комнату или свет отдельными проходами. Каждая правка начинается с утверждённого вами кадра, а не с нового броска, поэтому лицо сохраняется на протяжении серии.
Пары из двух портретов
Отправьте два портрета как Image 1 и Image 2 и опишите общую для них сцену. В нашем тесте мужчина и женщина, снятые по отдельности, оказались за одним столом при свечах на террасе виноградника, оба по-прежнему узнаваемы.
Атмосферные портреты и свет
Alibaba указывает на портретный свет и мелкую детализацию как на сильные стороны Pro. Назовите один источник света и куда он падает — штормовая лампа, высокое окно, бра — и кадр строится вокруг него.
Много черновиков ради одного удачного
До шести изображений за вызов по одной цене — недорогой набор вариантов. Исследуйте одежду, позу и свет в одном запросе, оставьте сработавший кадр и тратьте правки на него.
Руководство по промптам и практические советы
Когда важна формулировка, держите расширение промпта выключенным
Расширение передаёт ваш промпт переписчику Alibaba до того, как рисуется изображение, и эта переработка может смягчить смелый запрос. Здесь оно выключено по умолчанию, и все контентные тесты, которые мы проводили с выключенным расширением, вернулись как написано. В нашем единственном прогоне Pro с включённым расширением запрос, который официальное приложение заблокировало бы, всё же прошёл, но держите его выключенным, когда важна точная формулировка.
Для коротких бытовых промптов включайте его
Задание из шести слов получает более развёрнутую сцену, когда расширение включено. direct переписывает за один проход и подходит большинству промптов; agent переписывает в несколько шагов ради более тонкого результата. Режим thinking тратит дополнительные рассуждения на это переписывание и добавляет время; при выключенном расширении он ничего не делает.
Берите 2K — он стоит столько же
Все уровни стоят одинаково за изображение, поэтому 2K — значение по умолчанию и разумный выбор. Переходите на 1k, только когда нужен файл поменьше или чуть более быстрый ответ.
Просите сразу несколько изображений
Задайте
num_outputsот 1 до 6, чтобы получить за один вызов варианты одного промпта. Каждое возвращённое изображение тарифицируется, так что шесть изображений стоят в шесть раз больше одного. Это самый дешёвый способ найти понравившуюся позу или композицию до начала правок.В правках сначала пишите изменение, затем список неизменного
Сначала напишите единственное, что меняется, потом всё, что должно остаться: «Замени её бархатное платье на вечернее платье цвета слоновой кости; сохрани лицо, волосы и выражение». Ссылайтесь на референсы по номеру. В нашем тесте с двумя портретами «мужчина с изображения 1 и женщина с изображения 2» за столом при свечах оба лица в одном кадре узнавались.
Берите в кавычки слова, которые должны появиться
Точные слова помещайте в кавычки и указывайте, где они стоят. Наша обложка журнала — «AFTER DARK» вверху и «THE SILK ISSUE · NO. 07» мелкими буквами ниже — вернулась буква в букву. Делайте каждую строку короткой и проверяйте её в полном размере перед публикацией.
Пишите промпт в фиксированном порядке
Объект, одежда, поза, свет, объектив и палитра — простыми предложениями. Называйте источник света и его направление (одна масляная лампа слева, вращающийся луч за её спиной), а не слово о настроении. При выключенном расширении Pro рисует то, что вы написали, и не заполняет пробелы за вас.
Введение
Qwen Image 2.1 Pro Text to Image превращает письменное задание в изображения. Pro — размещённый уровень Qwen Image 2.1 от Alibaba; Alibaba объявила о его официальном запуске вместе с API Turbo 9 октября 2026 года и описывает его как баланс качества генерации, эффективности инференса и стоимости, с улучшенной типографикой, портретным светом и мелкой детализацией. Alibaba предлагает его как API и не публиковала для него весов.
На SpicyAPI он уже работает. Один запрос возвращает от одного до шести изображений, уровни 1k, 1.5k и 2k стоят одинаково за изображение, а перед моделью нет фильтра контента. Все изображения на этой странице созданы на Pro с показанными промптами.
Выберите режим по тому, что у вас есть
| Исходный материал | Режим |
|---|---|
| Письменное задание и больше ничего | Qwen Image 2.1 Pro Text to Image |
| Одно или несколько изображений для изменения | Qwen Image 2.1 Pro Image Editing |
Что мы измерили
Скорость
От 14 до 31 секунды на одно изображение и от 39 до 43 секунд на два изображения 2K за один вызов, от начала до конца в наших прогонах. Расширение промпта и режим thinking добавляют время, пока включены.
Контент
При выключенном расширении промпта, которое включено по умолчанию, все контентные тесты вернулись как написано — от Мягкого до Максимального уровня, с женским и мужским персонажем. Ни один запрос не был отклонён. В нашем единственном прогоне с включённым расширением промпт без фильтра тоже вернулся, как и просили.
Текст на изображении
Наша обложка журнала просила «AFTER DARK» в заголовке и «THE SILK ISSUE · NO. 07» под ним и получила обе строки буква в букву на обоих изображениях запроса.
Размеры в 2K
| Соотношение | Размер результата |
|---|---|
| 1:1 | 2048 × 2048 |
| 16:9 | 2688 × 1536 |
| 9:16 | 1536 × 2688 |
| 4:3 | 2368 × 1760 |
| 3:2 | 2496 × 1664 |
| 2:3 | 1664 × 2496 |
Всего пятнадцать соотношений — от 3:1 до 1:3, на уровнях 1k, 1.5k и 2k. Вывод — PNG.
Pro или Turbo
| Pro | Turbo | |
|---|---|---|
| Что это | Размещённый уровень Pro от Alibaba | 8-шаговый чекпойнт |
| Веса | Не опубликованы | Открытые, Qwen Research License |
| Изображений за запрос | От 1 до 6 | От 1 до 6 |
| Цена по уровню | Одна | Одна |
| Цена за изображение | Выше | Ниже |
| Фильтр контента | Нет | Нет |
Запрос один и тот же, так что можно отправить один промпт в обе модели и оставить результат, который нравится больше. Alibaba не публиковала сравнения качества между ними.
Руководство по промптам и советы
Для точной формулировки держите расширение выключенным
Переписывание может смягчить смелый запрос. Выключено — Pro рисует то, что вы написали.
Для коротких бытовых промптов включайте расширение
Идея из шести слов получает более развёрнутую сцену. direct подходит большинству промптов, agent переписывает подробнее, а режим thinking тратит дополнительное время на лучшее переписывание.
Пишите в фиксированном порядке
Объект, одежда, поза, свет, объектив и палитра — простыми предложениями. Называйте источник света и его направление вместо слова о настроении.
Берите в кавычки слова, которые должны появиться
Точные слова помещайте в кавычки, делайте каждую строку короткой и указывайте, где она стоит.
Просите шесть, оставляйте одно
Варианты стоят одинаково каждый, поэтому запрос на шесть изображений — самый быстрый способ найти позу или композицию, которые стоит править.
Быстрый старт 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": "alibaba/qwen-image-2.1-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# 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.
















