소개
Qwen Image 3.0 텍스트→이미지는 글로 쓴 브리프를 요청당 이미지 한 장으로 만듭니다. 이 모델을 구분 짓는 것은 타이포그래피입니다. 문고리 안내판, 바 간판, 포스터 헤드라인처럼 따옴표 안에 넣은 문자열은 글자 모양의 무늬가 아니라 읽히는 글자로 그려집니다.
Qwen Image 3.0은 이미지 속 글자 표현에 강한 Alibaba의 이미지 모델입니다. 5,000자 프롬프트, 화면비 8종, 1K 또는 2K 등급을 지원하며, 편집 엔드포인트는 레퍼런스를 1~3장 읽습니다. 무검열이며 설정할 플래그도 없습니다.
출발 소재로 고르는 Qwen Image 3.0 모드
| 출발 소재 | 모드 |
|---|---|
| 글로 쓴 아트 디렉션이나 디자인 브리프 | Qwen Image 3.0 텍스트→이미지 |
| 손봐야 할 승인된 원본 이미지 | Qwen Image 3.0 이미지 편집 |
핵심 기능 및 하이라이트
글자를 고려한 이미지 구성
Qwen Image 3.0 모델은 제공한 문구, 구도, 이미지 처리를 함께 고려해야 하는 시각 콘셉트에 유용합니다. 생성된 글자는 디자인 초안으로 다루고 게시 전에 교정하십시오.
새로 구성하는 일과 원본을 고치는 일은 다른 작업입니다
글로 쓴 브리프에서 이미지를 세울 때는 텍스트→이미지를 쓰십시오. 기존 이미지가 정해진 변경 중에도 지켜야 할 정체성, 레이아웃, 소재를 제공한다면 이미지 편집을 쓰십시오.
장식보다 위계를 먼저 검토하십시오
포스터, 패키지, 캠페인 콘셉트에서는 메시지의 위계와 초점 영역을 먼저 정하십시오. 보기 좋은 결과라도 승인된 문구나 제품 정보가 정확히 표현되지 않았다면 과제를 해낸 것이 아닙니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자이고 중국어와 영어 모두 되며 언어 플래그가 없습니다. 그림에 반드시 나와야 하는 문자열은 전부 작은따옴표에 넣고, 각각 여덟 단어 안팎으로 유지하세요. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 나중에 잘라내는 게 아니라 생성 전에 프레임을 구성하므로, 이미지가 게시될 형태를 고르세요. 여덟 비율 모두 장당 가격이 같습니다. |
resolution | 아니요 | 1k 또는 2k이고 기본은 2k이며, 여기서 가격을 바꾸는 유일한 값입니다. 읽히는 글자가 들어가는 건 전부 2k로 생성하세요. |
num_outputs | 아니요 | 1로 고정되어 요청마다 이미지 한 장이 돌아옵니다. 브리프 하나로 여러 장을 비교하려면 seed 없이 요청을 병렬로 보내세요. |
enable_prompt_expansion | 아니요 | 이 패밀리에서는 기본으로 켜져 있습니다. 얄팍한 브리프는 채워 주고 자세한 브리프는 다시 써 버리니, 프롬프트가 정밀한 컷 묘사가 되면 꺼 두세요. 기본값: |
negative_prompt | 아니요 | 제외할 내용을 최대 2,000자까지 본 프롬프트 밖에 담습니다. 프레임에 글자가 들어갈 때는 워터마크와 팔다리 중복, 뭉개진 글자에 쓸 값어치가 있습니다. 2000자 이하 |
prompt_optimization_mode | 아니요 |
|
seed | 아니요 | 탐색하는 동안 빼 두면 호출마다 알아서 뽑습니다. 프레임이 잘 나오면 고정하고, 그다음 다른 필드를 하나씩 바꿔 각 변화가 무엇을 했는지 확인하세요. |
요금
| 사양 | 요금 |
|---|---|
| $0.03 / 장 |
| $0.03 / 장 |
활용 사례
글로 쓴 브리프에서 시작하기
아직 원본 이미지가 없고, 화면 속 문구 일부가 읽혀야 할 때 이 모드를 씁니다. 간판, 라벨, 헤드라인 같은 것입니다. 게시할 비율을 고르고, 해상도는 2k로 두고, 각 문자열은 프롬프트 안에서 작은따옴표로 감싸십시오.
캐릭터 세트와 패션 시리즈
다른 API가 돌려보내는 스타일링 프롬프트도 여기서는 플래그 없이 실행됩니다. 캐릭터를 만든 시드를 고정한 다음, 요청마다 의상, 빛, 포즈 중 한 가지만 바꾸십시오. 관련 없는 결과의 모음이 아니라 일관된 세트가 됩니다.
포스터와 패키지 시안
헤드라인, 서브 카피, 법적 고지 한 줄까지 모두 화면 안에 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 레퍼런스에서 확인하세요.
