Введение
Qwen Image 3.0 Текст в изображение превращает письменный бриф в одно изображение на запрос. Его отличительная черта — типографика: строки в кавычках — табличка на двери, вывеска бара, заголовок афиши — отрисовываются как настоящий текст, а не как текстура в форме букв.
Qwen Image 3.0 — модель изображений Alibaba с упором на отрисовку текста: промпт до 5000 символов, восемь соотношений сторон, уровень 1K или 2K и эндпоинт правки, который читает от одного до трёх референсов. Без цензуры и без флагов.
Выберите режим Qwen Image 3.0 по исходному материалу
| Исходный материал | Режим |
|---|---|
| Письменная арт-дирекция или дизайн-бриф | Qwen Image 3.0 Текст в изображение |
| Утверждённое исходное изображение, которое нужно доработать | Qwen Image 3.0 Редактирование изображения |
Ключевые возможности и особенности
Композиция, которая учитывает текст
Qwen Image 3.0 подходит для визуальных концепций, где предоставленный текст, композицию и обработку изображения нужно продумывать вместе. Считайте сгенерированные надписи черновиком дизайна и вычитывайте их перед публикацией.
Новая композиция и доработка исходника — разные задачи
Используйте «текст в изображение», чтобы построить визуал по письменному брифу. Используйте редактирование изображения, когда существующий кадр задаёт образ, компоновку или материал, которые нужно сохранить при конкретном изменении.
Сначала иерархия, потом декор
Для постеров, упаковки и концепций кампаний сначала определите иерархию сообщений и фокусную зону. Привлекательный результат всё равно не решает задачу, если утверждённый текст или данные о продукте переданы неверно.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов, по-китайски или по-английски, без флага языка. Каждую строку, которая обязана появиться в кадре, ставьте в одинарные кавычки и держите примерно в восьми словах. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Компонует кадр до генерации, а не обрезает после, поэтому выбирайте ту форму, в которой изображение будет опубликовано. Все восемь соотношений стоят одинаково за кадр. |
resolution | Нет | 1k или 2k, по умолчанию 2k, и это единственная ценовая переменная. Всё с читаемым текстом генерируйте в 2k; 1k — под быстрые черновики компоновки, где читать нечего. |
num_outputs | Нет | Всегда 1: каждый запрос возвращает одно изображение. |
enable_prompt_expansion | Нет | У этого семейства включено по умолчанию. Тощие брифы оно дополняет, подробные переписывает, поэтому выключайте, как только prompt стал точным описанием кадра. По умолчанию: |
negative_prompt | Нет | До 2000 символов исключений, вынесенных из основного prompt. Их стоит потратить на водяные знаки, задвоенные конечности и покорёженные буквы, когда в кадре есть шрифт. Не более 2000 символов |
prompt_optimization_mode | Нет | Как расширение промпта переписывает ваш бриф, пока |
seed | Нет | На этапе поиска не указывайте — каждый вызов возьмёт свой. Зафиксируйте, когда кадр получился, и дальше меняйте по одному полю, чтобы видеть эффект каждой правки. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.03 / изображение |
| $0.03 / изображение |
Сценарии использования
Начать с письменного брифа
Используйте этот режим, когда у изображения ещё нет исходника, а часть текста в кадре должна читаться: вывеска, этикетка, заголовок. Выберите формат, в котором будете публиковать, оставьте разрешение 2k и заключайте каждую строку в промпте в одинарные кавычки.
Наборы персонажей и модные серии
Промпты для стайлинга, которые другие API отклоняют, здесь работают без всяких флагов. Зафиксируйте seed, который дал вам персонажа, и меняйте по одной детали за запрос — наряд, свет, позу — чтобы получить цельный набор, а не кучу несвязанных результатов.
Макеты афиш и упаковки
Заголовок, подзаголовок и юридическая строка — всё отрисовано в кадре в 2k и в том формате, который реально использует размещение. Полезно, чтобы показать макет до того, как дизайнер наложит настоящий шрифт на чистую подложку.
Сцены для гостиничного бизнеса и декора
Гостиничные номера, бары и лобби, где конкретная надпись должна читаться правильно: таблички на дверь, номера комнат, коктейльные карты, неон над барной стойкой. Генерируйте кадр с уже вписанным текстом, а не накладывайте шрифт поверх рендера потом.
Руководство по промптам и практические советы
Сначала формат и уровень
aspect_ratio строит композицию под формат, а не обрезает кадр, так что выбирайте форму, в которой будете публиковать. Оставляйте разрешение 2k, если в кадре есть текст; опускайтесь до 1k только для черновиков макета, где ничего не нужно читать.
Опишите сцену и процитируйте текст дословно
Опишите объект, одежду, свет и объектив, затем заключите каждую точную строку в одинарные кавычки — примерно до восьми слов. enable_prompt_expansion включён по умолчанию и переписывает подробные промпты, поэтому выключите его, когда ваш текст уже точно описывает кадр.
Адаптируйте приложенный пример
Начните с опубликованного примера с aspect_ratio: 3:4 и resolution: 2k. Замените объект и творческое направление, сохранив контракт входных данных этого режима.
Editorial photograph, an adult woman sitting on a hotel bed in a navy satin slip dress, city lights blurred through the window behind her, a brass door hanger hanging in sharp foreground reading 'DO NOT DISTURB', warm tungsten bedside lamp, cinematic 35mm, shallow focus, moody blue and amber palette.
Это точный запрос, по которому получен опубликованный кадр: гостиничная сцена в 3:4 на уровне 2k с текстом дверной таблички, процитированным в промпте.
Проверьте результат, прежде чем повторять
Надёжный случай — короткие строки в кавычках: название журнала, вывеска, этикетка, примерно восемь слов или меньше на элемент. Текст длиной в абзац по-прежнему превращается в правдоподобную бессмыслицу, а плотный мелкий шрифт первым ломается на уровне 1k — генерируйте типографику в 2k. Нелатинские письменности отрисовываются, но их нужно вычитывать: на редких глифах модель скорее уверена, чем точна.
Быстрый старт 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/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.


















