TL;DR
Qwen Image 3.0 รวมความสามารถสร้างภาพจากข้อความ (text-to-image) และการแก้ไขภาพโดยอ้างอิงรูปภาพ ภายใต้รุ่น Standard (qwen-image-3.0) และ Pro (qwen-image-3.0-pro) เริ่มด้วยพรอมต์ข้อความ เลือกขนาดเอาต์พุต ส่งคำขอสร้างภาพ และบันทึกผลลัพธ์ทันที สำหรับการแก้ไข ให้แนบภาพอ้างอิง 1–3 ภาพ พร้อมคำสั่งระบุสิ่งที่ต้องคงไว้ให้ชัดเจน บน CometAPI ควรยืนยันเส้นทางจริงและสคีมาคำขอที่เข้ากันได้ก่อนนำตัวอย่างไปใช้งาน
Key Takeaways
- Qwen Image 3.0 API รองรับทั้งการสร้างภาพจากข้อความและการแก้ไขโดยอ้างอิงรูปภาพ ผ่านรุ่น Standard (qwen-image-3.0) และ Pro (qwen-image-3.0-pro); เอาต์พุตเนทีฟเป็น PNG
- เข้าถึง Qwen Image 3.0 API ได้ผ่าน CometAPI นักพัฒนาสามารถขอคีย์ API ตรวจสอบเอ็นด์พอยต์ที่รองรับ และผสานการสร้างภาพเข้ากับแอปพลิเคชัน
- ราคาเริ่มต้นที่ $0.024/คำขอ บน CometAPI เปรียบเทียบกับ Alibaba Cloud Singapore ที่เริ่ม $0.030 ต่อภาพเอาต์พุต Standard และ $0.040 ต่อภาพเอาต์พุต Pro ระดับ 1K
- การแก้ไขภาพของ Qwen Image 3.0 รองรับภาพอ้างอิงสูงสุดสามภาพผ่าน API เนทีฟของ Alibaba Cloud ส่วนการสร้างภาพรองรับเอาต์พุต 1–6 ภาพต่อคำขอ
- การผสาน Qwen Image 3.0 API ต้องตรวจสอบพารามิเตอร์เฉพาะผู้ให้บริการ การยืนยันตัวตน หน่วยการคิดค่าบริการ และ URL ภาพชั่วคราว ก่อนปรับใช้ในเวิร์กโฟลว์จริง
What Is the Qwen Image 3.0 API?
Qwen Image 3.0 API แปลงคำสั่งข้อความเป็นภาพ และสามารถปรับเปลี่ยนภาพถ่ายหรือไฟล์ดีไซน์ที่ให้มาได้ รองรับสถานการณ์ใช้งาน เช่น โปสเตอร์หลายภาษา ภาพถ่ายอีคอมเมิร์ซ ม็อกอัปแคมเปญ การเปลี่ยนฉากหลัง และการตัดต่อภาพแบบผสม
Qwen Image 3.0 Standard (qwen-image-3.0) คือพื้นฐานที่เน้นต้นทุนสำหรับการสร้างภาพจากข้อความและการแก้ไขโดยอ้างอิง เหมาะเริ่มต้นในงานปริมาณมาก เช่น เปลี่ยนฉากหลังภาพสินค้า ร่างภาพสำหรับโซเชียล หรือสำรวจคอนเซ็ปต์แคมเปญ เช่น ใช้ Standard เพื่อสร้างตัวเลือกฉากหลังสินค้าหลายแบบ แล้วตรวจสอบความซื่อตรงของตัวสินค้าและคัดเลือกเวอร์ชันที่จะปรับแต่งต่อ
Qwen Image 3.0 Pro (qwen-image-3.0-pro) รองรับการสร้างและการแก้ไขโดยอ้างอิง พร้อมระดับเอาต์พุตเนทีฟ 2K ที่มีราคาสูงกว่า เหมาะกับงานคุณภาพอ่อนไหว เช่น ภาพไฮโร่ของแคมเปญ คอมโพสิชันสินค้าที่ละเอียด หรือโปสเตอร์โปรโมชัน เช่น ทดสอบคอนเซ็ปต์ที่คัดมาแล้วด้วย Pro เมื่อต้องการรายละเอียดหรือเลย์เอาต์ที่แม่นยำ และเปรียบเทียบผลกับ Standard ก่อนทุ่มงบประมาณมากขึ้น
จะเลือกอย่างไร: เริ่มที่ Standard สำหรับดราฟต์และเวอร์ชันที่คุมงบ ทดสอบ Pro บนโจทย์เดียวกันเมื่อเป็นงานไฟนอลที่ต้องการคุณภาพสูง แล้วเลือก Pro เมื่อการปรับปรุงที่วัดได้คุ้มกับต้นทุนที่เพิ่มขึ้น ทั้งนี้ยังจำเป็นต้องทดสอบตามการใช้งานจริงในเรื่องตัวอักษรบนภาพ ความซื่อตรงของสินค้า จำนวนวัตถุ และความแม่นยำของเลย์เอาต์
| Specification | Qwen Image 3.0 | Qwen Image 3.0 Pro |
|---|---|---|
| Model ID | qwen-image-3.0 | qwen-image-3.0-pro |
| Generation / editing | ทั้งสองอย่าง | ทั้งสองอย่าง |
| Reference images for editing | 1–3 | 1–3 |
| Generated images per request | 1–6 | 1–6 |
| Output format | PNG | PNG |
| Output pixel area | 512²–2048² | 512²–2048² |
| Recommended prompt length | 4,500 โทเค็น | 4,500 โทเค็น |
| Primary selection rationale | อัตราส่วนคุ้มค่า | ประเมินเอาต์พุตพรีเมียม |
What Parameters Does Qwen Image 3.0 API Support?
ใช้พารามิเตอร์เหล่านี้กับอินเทอร์เฟซเนทีฟที่เข้ากันได้กับ OpenAI ของ Alibaba Cloud เพิ่มออปชันเฉพาะผู้ให้บริการลงในคำขอบน CometAPI เฉพาะเมื่อเส้นทางที่เลือกมีเอกสารรองรับเท่านั้น
ใช้ได้กับทั้งสองรุ่น: qwen-image-3.0 (Standard) และ qwen-image-3.0-pro (Pro) รองรับพารามิเตอร์เดียวกันตามรายการด้านล่างบนอินเทอร์เฟซเนทีฟที่เข้ากันได้กับ OpenAI ของ Alibaba Cloud ให้เลือกเวอร์ชันด้วย model; ส่วนตัวควบคุมสำหรับการสร้างและการแก้ไขใช้ร่วมกัน ข้อนี้ไม่ได้หมายความว่าคุณภาพเอาต์พุตหรือราคาเหมือนกัน และไม่ได้รับประกันว่าเส้นทาง CometAPI ทุกเส้นทางจะเปิดพารามิเตอร์เนทีฟทั้งหมด
| Parameter | Type / example | Purpose |
|---|---|---|
| model | qwen-image-3.0 | เลือก Standard หรือ Pro |
| prompt | string | คำสั่งและเนื้อหา |
| image | URL / base64 string or array | ภาพอ้างอิง 1–3 ภาพสำหรับแก้ไข; เว้นไว้เมื่อสร้างภาพ |
| size | 1024x1024 | ขนาดเอาต์พุต; อัตโนมัติเมื่อรองรับ |
| n | integer 1–6 | จำนวนเอาต์พุตต่อคำขอ |
| negative_prompt | string | อธิบายสิ่งที่ต้องหลีกเลี่ยง |
| prompt_extend | boolean | เปิดใช้งานการเขียนพรอมต์ใหม่ |
| prompt_extend_mode | direct / agent | โหมด Agent ใช้ได้เฉพาะ T2I |
| enable_thinking | boolean | ควบคุมการให้เหตุผล ขึ้นกับการตั้งค่าการเพิ่มพลัง |
| watermark | boolean | ลายน้ำแบบเลือกได้ |
| seed | integer | ช่วยให้ทำซ้ำผลลัพธ์ได้ |
สำหรับคำขอเนทีฟ อัตราส่วนกว้างยาวต้องอยู่ระหว่าง 1:8 ถึง 8:1 ภาพอ้างอิงต้องมีขนาดไม่เกิน 10 MB แต่ละด้านอยู่ระหว่าง 1 ถึง 8,000 พิกเซล และอัตราส่วนด้านยาวสุดต่อสั้นสุดไม่เกิน 10:1 ใช้ data URI สำหรับอินพุตแบบ Base64 ฟีเจอร์ Thinking ต้องใช้ prompt_extend=true; และการเสริมด้วย agent รองรับเฉพาะการสร้างภาพจากข้อความ
คำขอภาพที่เข้ากันได้ควรวางฟิลด์การสร้างไว้ที่ระดับบนสุดของ JSON และระบุขนาดเป็น 1024x1024 ส่วน DashScope เนทีฟใช้ input/parameters แบบซ้อน และมักเขียนขนาดเป็น 1024*1024 การคัดลอกคำขอระหว่างเอ็นด์พอยต์เหล่านี้โดยไม่แปลงรูปแบบอาจทำให้ผิดพลาดได้
How Do You Call Qwen Image 3.0 API with CometAPI?
บทนำนี้สมมติว่าใช้ Python 3 เทอร์มินัลที่เข้ากันได้กับ Bash บัญชี CometAPI ที่เข้าถึงโมเดลได้ และมีวงเงินเพียงพอ คำขอแรกใช้เฉพาะฟิลด์ model และ prompt ตามตัวอย่างผู้ให้บริการ ตรวจสอบเอกสารเมื่อ 16 ตุลาคม 2026; ตัวอย่างเหล่านี้ยังไม่ได้รันกับบัญชีแบบชำระเงิน
Create credentials
สร้างคีย์ API ฝั่งเซิร์ฟเวอร์ในแดชบอร์ด CometAPI ห้ามนำไปฝังในไคลเอนต์เว็บหรือมือถือ
export COMETAPI_KEY="your_api_key"python -m pip install requests
Submit a minimal generation request
นักพัฒนาสามารถเข้าถึง Qwen Image 3.0 API บน CometAPI โดยใช้เส้นทางสร้างภาพที่มีเอกสารกำกับ เริ่มจากคำขอแบบมินิมอลด้านล่าง ก่อนเพิ่มพารามิเตอร์ทางเลือก
curl --fail-with-body https://api.cometapi.com/v1/images/generations \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen-image-3.0","prompt":"ขวดสกินแคร์ระดับพรีเมียมวางบนแท่นหิน แสงสตูดิโอนุ่มนวล"}'
Save every returned image
บันทึกสคริปต์ต่อไปนี้เป็น generate.py แล้วรัน python generate.py สคริปต์จะส่งคำขอ รองรับผลลัพธ์แบบ URL หรือ Base64 และเขียนภาพแต่ละไฟล์ลงเครื่อง หากคำตอบมีข้อมูลงานแทนที่จะเป็นอาเรย์ data สคริปต์จะหยุดแทนการเดาเอ็นด์พอยต์ polling; ให้ใช้สัญญาแบบอะซิงโครนัสของบัญชีเพื่อนำผลลัพธ์สำเร็จกลับมา
import base64import osfrom pathlib import Pathimport requestsresponse = requests.post( "https://api.cometapi.com/v1/images/generations", headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"}, json={"model": "qwen-image-3.0", "prompt": "คาเฟ่ร้านหนังสือบรรยากาศแดดอุ่น โทนภาพถ่ายสไตล์บรรณาธิการ"}, timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images: raise RuntimeError(f"ไม่มีภาพแบบซิงโครนัส; ตรวจสอบฟิลด์ task/error: {list(result)}")for index, item in enumerate(images, 1): if item.get("url"): download = requests.get(item["url"], timeout=(15, 120)) download.raise_for_status() content = download.content elif item.get("b64_json"): content = base64.b64decode(item["b64_json"], validate=True) else: raise RuntimeError(f"ภาพ {index} ไม่มี URL หรือเพย์โหลด Base64") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"บันทึก {path} แล้ว")
เมื่อรันสำเร็จจะได้ไฟล์ภาพในเครื่อง เปิดตรวจสอบให้แน่ใจว่าอ่านได้และตรงกับฉากที่ร้องขอ เก็บหมายเลขคำขอและฟิลด์การใช้งานไว้ในล็อกของเซิร์ฟเวอร์ โดยไม่บันทึกข้อมูลรับรอง
How Do You Generate Multiple Images with Qwen Image 3.0?
บนอินเทอร์เฟซเนทีฟของ Alibaba Cloud กำหนดค่า n เป็นสองถึงหกเพื่อสร้างเวอร์ชันที่หลากหลาย สำหรับ CometAPI ให้เปิดใช้ n หลังยืนยันว่ามีรองรับบนเส้นทางที่เลือก ตรวจสอบความถูกต้องของทรัพย์สินแต่ละรายการแยกกัน; การเพิ่ม n ไม่ได้การันตีว่าทุกผลลัพธ์จะผ่านการรีวิวขั้นถัดไป
คุณสามารถสร้างภาพได้สูงสุด 6 ภาพในคำขอเดียวด้วย Qwen Image 3.0 โดยตั้งค่าพารามิเตอร์ n ใช้ได้กับทั้ง qwen-image-3.0 และ qwen-image-3.0-pro สำหรับการสร้างภาพและการแก้ไขภาพ ค่าเริ่มต้นคือหนึ่งภาพ
มีสองแนวทางหลัก: ใช้ส่วนติดต่อแบบกราฟิกหากแพลตฟอร์มของคุณมีตัวเลือก หรือเรียกใช้ API โดยตรง
Generate multiple images using the API
- เปิดเอกสาร API
- ขอคีย์ API จาก QwenCloud console/ CometAPI
- เลือก
qwen-image-3.0หรือqwen-image-3.0-pro - ตั้งค่า
nเป็นจำนวนภาพที่ต้องการ ตั้งแต่1ถึง6 - ส่งพรอมต์และบันทึกภาพที่ส่งกลับมา
เช่น ตั้งค่า "n": 4 เพื่อขอรูปแบบแตกต่างกันสี่ภาพจากพรอมต์เดียวกัน
Python example
ตัวอย่างพร้อมปรับใช้ โดยใช้อินเทอร์เฟซที่เข้ากันได้กับ OpenAI
from openai import OpenAIimport requestsclient = OpenAI( api_key="YOUR_QWEN_API_KEY", base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate( model="qwen-image-3.0-pro",
prompt=( "คาเฟ่ญี่ปุ่นบรรยากาศอบอุ่นในค่ำคืนฝนตก, " "แสงไฟอบอุ่นส่องสว่าง, งานภาพถ่ายเชิงภาพยนตร์, " "รายละเอียดแน่น, เงาสะท้อนสมจริง" ),
n=4,
size="1024x1024")# บันทึกภาพแต่ละภาพที่สร้างได้
for i, item in enumerate(result.data, start=1): response = requests.get(item.url) response.raise_for_status() with open(f"qwen_image_{i}.png", "wb")
as f:
f.write(response.content)print("สร้างภาพเสร็จแล้ว!")
ติดตั้งแพ็กเกจที่ต้องการก่อน:
pip install openai requests
API จะส่งกลับ URL ของภาพสำหรับแต่ละผลลัพธ์ URL ของภาพที่สร้างมีอายุชั่วคราว ควรดาวน์โหลดทันที
Important settings
| Parameter | What it does |
|---|---|
| n=4 | สร้างเอาต์พุตสี่ภาพ |
| model="qwen-image-3.0-pro" | เลือกโมเดล Pro |
| size="1024x1024" | ขอภาพสี่เหลี่ยมจัตุรัส |
| seed=12345 | ช่วยให้ผลลัพธ์ทำซ้ำได้มากขึ้น |
| negative_prompt | ตัดสิ่งที่ไม่ต้องการให้อยู่ในภาพออกไป |
จำนวนเอาต์พุตสูงสุดคือหกภาพต่อคำขอ ควรทราบว่าการขอภาพมากขึ้นทำให้ต้นทุนการสร้างสูงขึ้นด้วย
ข้อสังเกตสำคัญ: n=4 จะขอสี่เวอร์ชันจากพรอมต์เดียว หากต้องการสี่พรอมต์ที่ต่างกัน ควรส่งคำขอแยกกันหรือวนลูปตามรายการพรอมต์ของคุณ
How Do You Edit Images with Qwen Image 3.0?
การแก้ไขประกอบด้วยภาพอ้างอิงหนึ่งถึงสามภาพพร้อมคำสั่ง ระบุทั้งการเปลี่ยนแปลงที่ต้องการและสิ่งที่ต้องคงไว้ เช่น ฉลากสินค้า สี มุมกล้อง หรือรูปทรงบรรจุภัณฑ์
ตัวอย่างถัดไปใช้ข้อมูลยืนยันตัวตนของ Alibaba Cloud และ ฟิลด์ JSON สำหรับการแก้ไขภาพ สร้างคีย์ Model Studio ตามภูมิภาค รับ Workspace ID และกำหนดค่าเอ็นด์พอยต์ที่สอดคล้องกัน ห้ามใช้คีย์ CometAPI แทนในคำขอนี้
export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"
ภาพอ้างอิงด้านล่างนำมาจากตัวอย่างอย่างเป็นทางการของ API เป็นภาพอินพุต ไม่ใช่ผลลัพธ์ที่สร้างจากบทความนี้
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# เอ็นด์พอยต์ระดับภูมิภาค .../images/generations ตามเอกสาร
payload = {
"model": "qwen-image-3.0",
"prompt": "เปลี่ยนชุดเป็นสูทธุรกิจสีชาโคลในคาเฟ่ คงไว้ซึ่งใบหน้าและทรงผม",
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"],
"size": "1024x1024",
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())
เอ็นด์พอยต์เนทีฟที่เข้ากันได้ใช้ JSON บน /images/generations ไม่ใช่ multipart uploads บน /images/edits ไม่รองรับมาสก์หรือสตรีมมิง ให้อ่านอาเรย์ data ที่ส่งกลับมาและบันทึกแต่ละ URL โดยใช้ลูปดาวน์โหลดแบบเดียวกับด้านบน
สำหรับภาพอ้างอิงสองภาพ ให้ใส่สอง URL ในอาเรย์ image และระบุบทบาทในพรอมต์ (เช่น สินค้าจากภาพหนึ่ง ฉากจากภาพสอง) ซีรีส์ Qwen Image 3.0 รองรับภาพอ้างอิงไม่เกินสามภาพ หากต้องการต้นฉบับมากกว่านั้นให้ใช้โมเดลอื่นหรือเวิร์กโฟลว์ประมวลผลล่วงหน้า
How Much Does Qwen Image 3.0 API Cost?
ราคาของ Qwen Image 3.0 API แตกต่างตามรุ่น ขนาดความละเอียดเอาต์พุต และผู้ให้บริการ ตารางด้านล่างเสริมการเปรียบเทียบของ Alibaba Cloud Singapore ด้วยอัตรา CometAPI ตามตารางราคาที่ผู้รีวิวแนบไว้ ไฟล์แนบระบุราคาเอาต์พุตเป็น USD ต่อภาพ และส่วนลด 20% สำหรับทั้งสี่ชุดโมเดล/ความละเอียด อัตราเหล่านี้ยังไม่ได้ยืนยันกับการเรียกเก็บเงินจริง โปรดยืนยันเรตราคาที่ใช้ก่อนใช้งานจริง
| Pricing item | Alibaba Cloud Standard | Alibaba Cloud Pro | CometAPI |
|---|---|---|---|
| Input reference image | $0.003/image | $0.003/image | $0.0024/image สำหรับ Standard และ Pro |
| Successful 1K output | $0.030/image | $0.040/image | Standard: $0.0240/image; Pro: $0.0320/image |
| Successful 2K output | $0.030/image | $0.075/image | Standard: $0.0240/image; Pro: $0.0600/image |
| 100 successful 1K outputs | $3.00 | $4.00 | Standard: $2.40; Pro: $3.20 สำหรับ 100 ภาพเอาต์พุต* |
| 1,000 successful 2K outputs | $30.00 | $75.00 | Standard: $24.00; Pro: $60.00 สำหรับ 1,000 ภาพเอาต์พุต* |
| Billing unit | ภาพอินพุต/เอาต์พุต | ภาพอินพุต/เอาต์พุต | คิดตามภาพอ้างอิงที่เรียกเก็บเงินได้และภาพเอาต์พุตที่สำเร็จ ตามตารางราคาที่ให้มา |
| CometAPI output-price discount | 20% ที่ 1K และ 2K | 20% ที่ 1K และ 2K | อัตราภาพอินพุตและเอาต์พุตคิดที่ 80% ของราคาภาพอย่างเป็นทางการตามตารางที่ให้มา |
*ตัวอย่างปริมาณด้านบนคิดเฉพาะภาพเอาต์พุต: 100 ภาพ Standard 1K ราคา $2.40 และ 100 ภาพ Pro 1K ราคา $3.20; 1,000 ภาพ Standard 2K ราคา $24.00 และ 1,000 ภาพ Pro 2K ราคา $60.00 สำหรับการแก้ไข ให้บวก $0.0024 ต่อภาพอ้างอิงที่เรียกเก็บเงินได้ ไม่รวมกฎงานล้มเหลว ภาษี และเงื่อนไขเฉพาะบัญชี
โดยใช้อัตราภาพอินพุตและเอาต์พุตที่ให้มา คำนวณค่าใช้จ่ายโดยประมาณได้ดังนี้:
Total cost = (จำนวนภาพอ้างอิงที่เรียกเก็บเงินได้ × ราคาอินพุตต่อภาพ) + (จำนวนเอาต์พุตที่สำเร็จ × ราคาเอาต์พุตต่อภาพ).
สำหรับงานที่คิดค่าบริการภาพอ้างอิงสองภาพและเอาต์พุต Standard 1K สำเร็จสามภาพ ค่าใช้จ่ายภาพของ Alibaba Cloud คือ (2 × $0.0030) + (3 × $0.0300) = $0.0960 ส่วนค่าใช้จ่ายภาพของ CometAPI คือ (2 × $0.0024) + (3 × $0.0240) = $0.0768 ตามอัตราที่ให้มา
CometAPI คิด $0.0024 ต่อภาพอ้างอิงสำหรับทั้งสองรุ่น ราคาภาพเอาต์พุตคือ $0.0240 ต่อภาพสำหรับ Standard ที่ 1K หรือ 2K, $0.0320 ต่อภาพสำหรับ Pro ที่ 1K และ $0.0600 ต่อภาพสำหรับ Pro ที่ 2K ตารางที่ให้มาระบุว่าอัตราอินพุตและเอาต์พุตแต่ละรายการต่ำกว่าราคาอย่างเป็นทางการ 20% ดังนั้นเมื่อจำนวนภาพที่คิดเงินเท่ากัน ค่าใช้จ่ายภาพจึงต่ำกว่า 20%; ค่าธรรมเนียมเพิ่มเติมหรือเงื่อนไขบัญชีอาจเปลี่ยนผลลัพธ์ในบิลสุดท้าย
สำหรับการประมาณงบประมาณจริง โปรดยืนยันรุ่นที่เลือก ความละเอียดภาพ ค่าใช้จ่ายภาพอ้างอิง จำนวนเอาต์พุตต่อคำขอ และส่วนลดตามบัญชีก่อนประเมินค่าใช้จ่ายรวม
How Do You Handle Qwen Image 3.0 API Errors?
| Symptom | Likely cause | Action |
|---|---|---|
| 401/403 | คีย์ไม่ถูกต้องหรือภูมิภาคไม่ตรง | ตรวจสอบข้อมูลยืนยันสิทธิ์ สิทธิ์การเข้าถึง และตำแหน่งดีพลอย |
| 400 invalid image | จำนวน/ชนิดของภาพอ้างอิงไม่ถูกต้อง | ใช้ 1–3 ภาพ เป็น URL/base64 ที่รองรับ และฟอร์แมตที่รองรับ |
| 400 invalid size | พื้นที่/อัตราส่วนภาพหรือตัวคั่นไม่รองรับ | ปรับรูปแบบขนาดให้ตรงตามข้อกำหนดของเอ็นด์พอยต์ |
| Unexpected JSON | ใช้เอ็นด์พอยต์ผิดหรือสัญญาการตอบไม่ตรงกัน | ล็อกฟิลด์คำตอบและปรับตัวพาร์สเซอร์ให้สอดคล้อง |
| Expired image URL | ไม่บันทึกภาพก่อน URL หมดอายุ | ดาวน์โหลดและจัดเก็บทันทีที่สร้างเสร็จ |
| Unexpected bill | ไม่ได้คำนวณภาพอ้างอิงหรือระดับเอาต์พุตไว้ | ใช้ฟิลด์การใช้งานภาพและเรตราคา ณ ปัจจุบัน |
| Inconsistent brand text | ข้อจำกัดของการสร้างข้อความบนภาพ | ใช้เกตตรวจสอบหรือซ้อนตัวอักษรในภายหลัง |
FAQ
ควรลองส่งคำขอ Qwen Image 3.0 ใหม่หลังจากไทม์เอาต์หรือไม่?
ไทม์เอาต์ฝั่งไคลเอนต์ไม่ได้ยืนยันว่าการสร้างหยุดไปแล้ว ให้เก็บหมายเลขคำขอหรืองาน ตรวจสอบประวัติงานของผู้ให้บริการหรือ API สถานะตามเอกสาร และดูว่ามีเอาต์พุตแล้วหรือไม่ก่อนส่งซ้ำ การลองใหม่แบบไม่ตรวจสอบอาจสร้างงานซ้ำและมีค่าใช้จ่ายเพิ่ม ใช้การลองใหม่แบบจำกัดสำหรับความล้มเหลวชั่วคราว และปฏิบัติตามแนวทาง idempotency ของผู้ให้บริการเมื่อมี
จะใช้ภาพอ้างอิงจากไฟล์ภายในเครื่องกับ Qwen Image 3.0 ได้อย่างไร?
สำหรับอินเทอร์เฟซเนทีฟที่เข้ากันได้ ให้อ่านไฟล์เป็นไบต์ เข้ารหัสเป็น Base64 และเติม data URI เช่น data:image/png;base64, ไว้ด้านหน้า ใส่สตริงเต็มนี้ลงใน image อินพุตแบบ Base64 ยังต้องเป็นไปตามข้อจำกัดขนาดและมิติภาพ เส้นทางไฟล์ในเครื่องไม่ใช่ URL ที่บริการจะดึงได้
จะส่งออปชันเฉพาะ Qwen ผ่าน OpenAI SDK อย่างไร?
เก็บฟิลด์ภาพมาตรฐานไว้ในอาร์กิวเมนต์ปกติของ SDK และวางฟิลด์ขยายของ Model Studio เช่น image และ prompt_extend ไว้ใน extra_body คำขอ HTTP ดิบจะวางฟิลด์เหล่านี้ไว้ที่ระดับบนสุดของ JSON แนวทางนี้ใช้กับอินเทอร์เฟซเนทีฟที่เข้ากันได้; โปรดตรวจสอบเส้นทาง CometAPI ที่เลือกก่อนส่งต่อออปชันเฉพาะผู้ให้บริการ
ควรทำอย่างไรเมื่อ Qwen Image 3.0 ส่งกลับภาพน้อยกว่าที่ร้องขอ?
บันทึกเอาต์พุตที่สำเร็จก่อนและบันทึกจำนวนจริง สำหรับการคิดค่าบริการของ Alibaba Cloud จะคิดตามภาพเอาต์พุตที่สร้างสำเร็จ หากต้องการภาพเพิ่มเติม ให้ขอเฉพาะจำนวนที่ขาดไปหลังตรวจสอบคำตอบและบันทึกการใช้งานแล้ว; การคิดค่าบริการบน CometAPI ต้องกระทบยอดตามเงื่อนไขบัญชีของตนเอง
Conclusion
Qwen Image 3.0 เป็นตัวเลือกที่ใช้งานได้จริงสำหรับทีมที่ต้องการทั้งการสร้างภาพและการแก้ไขโดยอ้างอิงภายในตระกูลโมเดลเดียว ใช้ Standard เป็นพื้นฐานที่คุ้มค่า ทดสอบ Pro สำหรับงาน 2K หรือครีเอทีฟที่ต้องการความละเอียดสูง และวัดต้นทุนต่อเอาต์พุตที่ยอมรับได้แทนการดูราคาต่อคำขอเพียงอย่างเดียว เริ่มจากการเรียกสร้างภาพแบบมินิมอล บันทึกผลลัพธ์ แล้วค่อยเพิ่มการแก้ไขหรือเอาต์พุตหลายภาพผ่านสัญญาผู้ให้บริการที่เหมาะสม เก็บข้อมูลยืนยันตัวตนและสคีมาคำขอแยกจากกัน จัดการข้อผิดพลาดอย่างชัดเจน และกระทบยอดการใช้งานภาพกับเรตราคาที่เลือกใช้งาน
