Qwen-Image 시리즈
Alibaba의 Tongyi 이미지 모델로, 모두 두 가지입니다. OpenAI 호환 엔드포인트 /v1/images/generations로 호출하며, 텍스트로 이미지 생성과 이미지 편집 모두 이 엔드포인트를 사용합니다.
모델 선택
두 모델의 파라미터는 완전히 같습니다. Pro는 상위 버전으로, 텍스트 렌더링과 이미지 질감이 더 뛰어납니다.
qwen/qwen-image-3.0-pro상위 등급qwen/qwen-image-3.0표준 등급실시간 가격은 모델 페이지 를 참고하십시오.
다른 시리즈와의 차이
링크 유효 기간: 링크의 Expires 파라미터는 생성 후 24시간입니다. 장기간 사용하려면 바로 다운로드하여 별도로 저장하고, 링크를 그대로 데이터베이스에 저장하지 마십시오.
텍스트로 이미지 생성
Python
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
resp = client.images.generate(
model="qwen/qwen-image-3.0-pro",
prompt="흰 테이블 위에 놓인 빨간 사과 하나, 옆에는 ‘OfoxAI’라고 적힌 카드",
size="1024x1024",
)
# 임시 링크가 반환되므로 24시간 이내에 다운로드하십시오
urllib.request.urlretrieve(resp.data[0].url, "output.png")크기와 장수
n의 최대값은 6입니다.실측 결과 2560x1440을 사용할 수 있었습니다. 소요 시간은 1024×1024가 약 1060초, 2560×1440이 약 60초, 편집이 약 50100초였습니다. 클라이언트 타임아웃은 300초 이상으로 설정하는 것을 권장합니다.
이미지 편집과 다중 참고 이미지
input_images를 사용하며 최대 3장입니다. image 필드는 사용하지 않으며, /v1/images/edits도 지원하지 않습니다.Python
import base64
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600)
with open("apple.jpg", "rb") as f:
ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
resp = client.images.generate(
model="qwen/qwen-image-3.0-pro",
prompt="사과를 보라색으로 바꾸고, 나머지는 그대로 두세요",
extra_body={"input_images": [ref]},
)
urllib.request.urlretrieve(resp.data[0].url, "apple_purple.png")input_images는 배열이며, 각 항목은 이미지 URL 또는data:image/...;base64,로 시작하는 문자열입니다. 1~3장을 넣을 수 있으며, 3장을 넘으면 400이 반환됩니다.image는 Seedream 전용 필드이며 Qwen-Image는 지원하지 않습니다.- 편집 시
size를 생략하면 실측 결과 2048×2048로 출력되어 원본과 다를 수 있습니다. 크기를 유지하려면 명시적으로 전달하십시오.
기타 파라미터
negative_prompt(나타나지 않기를 원하는 내용)와 prompt_extend(모델이 프롬프트를 자동으로 확장할지 여부)는 실측 결과 정상적으로 전달되었습니다. 파라미터 정의는 Alibaba Cloud Model Studio 공식 문서 를 참고하십시오.
자주 발생하는 오류
오류 원문의 qwen-image-3.0-distill은 상위 서비스의 내부 모델 이름이며, 호출할 때는 이 페이지에 나열된 모델 ID를 그대로 사용하십시오.
오류 원문
Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requests. Got area=10000 (width=100, height=100).
Input should be less than or equal to 6: parameters.n
Model 'qwen-image-3.0-distill' supports 0~3 image content items. Got 4 image items. (0 images = T2I mode, 1~3 images = I2I mode)자주 묻는 질문
Qwen-Image는 왜 b64_json이 아니라 url을 반환합니까?
Qwen-Image는 base64가 아니라 Alibaba Cloud OSS의 임시 이미지 링크(data[].url)를 반환합니다. 링크는 24시간 후 만료되므로, 받은 뒤 가능한 한 빨리 다운로드하여 저장하십시오.
Qwen-Image로 이미지를 편집하려면 어떻게 합니까?
/v1/images/generations에 input_images(배열, 1~3장, 각 항목은 이미지 URL 또는 data:image로 시작하는 base64)를 전달하십시오. image는 Seedream의 필드이므로 Qwen-Image는 지원하지 않으며, /v1/images/edits도 지원하지 않습니다.
Qwen-Image에서 Image area must be between 262144 and 6553600 pixels 오류가 납니까?
크기의 총 픽셀 수는 512x512에서 2560x2560 사이여야 합니다. 예를 들어 100x100은 너무 작고 3000x3000은 너무 큽니다. 1024x1024, 2048x2048, 2560x1440 등으로 변경하십시오.
Qwen-Image는 한 번에 최대 몇 장을 생성할 수 있습니까?
n은 최대 6이며, 7 이상을 전달하면 400이 반환됩니다. 더 필요하면 여러 번 나누어 요청하십시오.
Qwen-Image의 이미지 링크가 열리지 않습니까?
링크의 Expires 파라미터는 생성 후 24시간이며, 만료되면 다운로드할 수 없으므로 다시 생성해야 합니다. 링크를 받으면 바로 다운로드하여 자체 스토리지에 저장하십시오.