Введение
Qwen Image 3.0 Pro Текст в изображение — финишный уровень линейки. Он принимает тот же запрос, что и Qwen Image 3.0, но тратит больше на детали — заметнее всего в типографике из нескольких элементов и в передаче материалов: кожи, ткани и стекла.
Qwen Image 3.0 Pro — детальный уровень линейки изображений Qwen от Alibaba: промпт до 5000 символов, восемь соотношений сторон, уровень 1K или 2K и правка по одному–трём референсам. Для кадров, которые идут в работу, без цензуры.
Выберите режим Qwen Image 3.0 Pro по исходному материалу
| Исходный материал | Режим |
|---|---|
| Письменная арт-дирекция или дизайн-бриф | Qwen Image 3.0 Pro Текст в изображение |
| Утверждённое исходное изображение, которое нужно доработать | Qwen Image 3.0 Pro Редактирование изображения |
Ключевые возможности и особенности
Композиция, которая учитывает текст
Qwen Image 3.0 Pro подходит для визуальных концепций, где предоставленный текст, композицию и обработку изображения нужно продумывать вместе. Считайте сгенерированные надписи черновиком дизайна и вычитывайте их перед публикацией.
Новая композиция и доработка исходника — разные задачи
Используйте «текст в изображение», чтобы построить визуал по письменному брифу. Используйте редактирование изображения, когда существующий кадр задаёт образ, компоновку или материал, которые нужно сохранить при конкретном изменении.
Сначала иерархия, потом декор
Для постеров, упаковки и концепций кампаний сначала определите иерархию сообщений и фокусную зону. Привлекательный результат всё равно не решает задачу, если утверждённый текст или данные о продукте переданы неверно.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов, по-китайски или по-английски. Цитируйте каждую строку, которая обязана появиться, и указывайте её место; надёжный диапазон — три-четыре короткие строки на кадр. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Компонует кадр, а не обрезает его. 3:4 и 2:3 — формы, под которые верстают обложки и плакаты; все восемь стоят одинаково за кадр. |
resolution | Нет | 1k или 2k, по умолчанию 2k, и это единственная ценовая переменная. В 1k преимущество ступени почти незаметно — берите 1k только под черновики компоновки. |
num_outputs | Нет | Всегда 1: одно изображение на запрос. |
enable_prompt_expansion | Нет | У этого семейства включено по умолчанию. Тощие брифы оно дополняет, подробные переписывает, поэтому выключайте, как только prompt стал точным описанием кадра. По умолчанию: |
negative_prompt | Нет | До 2000 символов исключений. На типографике он окупается против задвоенных букв, случайных водяных знаков и размазанных краёв этикетки. Не более 2000 символов |
prompt_optimization_mode | Нет | Как расширение промпта переписывает ваш бриф, пока |
seed | Нет | На этапе поиска не указывайте; закрепите, когда компоновка сложилась, и дальше меняйте по одной обложечной строке, чтобы видеть эффект каждой правки отдельно. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.04 / изображение |
| $0.075 / изображение |
Сценарии использования
Начать с письменного брифа
Используйте этот уровень, когда кадр пойдёт в работу таким, каким вернётся, и несёт несколько текстовых элементов: название, строку с датой, короткий слоган. Оставьте разрешение 2k, процитируйте каждую строку и укажите, где она стоит.
Макеты упаковки и этикеток
Этикетки бутылок, коробок и банок, где название бренда и короткий слоган должны читаться на изогнутой поверхности. Цитируйте каждую строку, называйте материал, а случайные задвоенные буквы оставьте негативному промпту.
Обложки журналов и редакционные съёмки без цензуры
Полноформатный портрет с настоящей шапкой издания, номером выпуска и двумя заголовками обложки, сгенерированный одним вызовом. Стиль может меняться, но запрос при этом не меняется: один и тот же эндпоинт отвечает и за вёрстку, и за стиль.
Макеты афиш и наружной рекламы
Кадры 3:4 и 2:3 с заголовком, строкой даты и юридической плашкой, уже вписанными в изображение, на уровне 2k. Достаточно, чтобы показать на согласовании до того, как кто-то наложит настоящий шрифт на чистую подложку.
Руководство по промптам и практические советы
Цитируйте каждую строку и указывайте, где она стоит
Называйте название журнала, анонсы на обложке и капитель отдельно, каждое в одинарных кавычках и каждое с позицией. Три-четыре короткие строки на кадр — надёжный диапазон; negative_prompt может отсечь задвоенные буквы и случайные водяные знаки.
Зафиксируйте seed и меняйте по одной строке
Когда макет сложился, запишите seed и меняйте по одному анонсу за раз. Если вместо одного окончательного кадра нужны несколько прочтений одного макета, не указывайте seed и отправьте бриф параллельными запросами.
Адаптируйте приложенный пример
Начните с опубликованного примера с aspect_ratio: 3:4 и resolution: 2k. Замените объект и творческое направление, сохранив контракт входных данных этого режима.
A glossy fashion magazine cover, full-bleed portrait of an adult woman in a black lace bodysuit under a sheer open kimono, arms raised adjusting her hair, studio rim light on a deep charcoal background; masthead text 'SPICY' in large condensed type across the top, cover lines reading 'THE LATE SHIFT' and 'ISSUE 07' in small caps, high-end print typography, razor-sharp 2K detail.
Это точный запрос, по которому получена обложка, показанная для этого эндпоинта: портрет навылет в 3:4 на уровне 2k, с названием, строкой номера и анонсами, процитированными в промпте.
Проверьте результат, прежде чем повторять
Типографика из нескольких элементов — причина выбрать этот уровень, и у неё тоже есть потолок: три-четыре короткие строки на кадр надёжны, целая страница текста — нет. Генерируйте шрифт в 2k: уровень 1k — для черновиков композиции. Редкие глифы и нелатинские письменности отрисовываются, но перед сдачей их нужно вычитать.
Быстрый старт 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-3.0-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.
