วิธีใช้งาน Qwen Image 3 Pro API ผ่าน DashScope: บทช่วยสอนสำหรับนักพัฒนา

โมเดล qwen-image-3.0-pro ของ Alibaba เป็นโมเดลสร้างภาพเรือธงที่ให้บริการผ่าน Model Studio หรือที่รู้จักกันในชื่อ DashScope หรือ Bailian โมเดลนี้มุ่งเป้าไปที่นักพัฒนาแบ็กเอนด์ที่ต้องการปลายทาง (endpoint) สำหรับการแปลงข้อความเป็นภาพที่เชื่อถือได้และมีราคาที่คาดการณ์ได้ รหัสโมเดลอย่างเป็นทางการ qwen-image-3.0-pro มีเอกสารอยู่ในแค็ตตาล็อก Model Studio ของ Alibaba (เอกสาร Alibaba Cloud Model Studio, 2026) และคุณสามารถเรียกใช้ได้จากไคลเอนต์ HTTP ใดก็ได้

บทช่วยสอนนี้จะอธิบายการผสานรวมทั้งหมด เมื่อจบแล้ว คุณจะมีคีย์ API, การเรียกใช้ cURL ที่ใช้งานได้, โค้ด Python สั้นๆ และเข้าใจโครงสร้างต้นทุนต่อภาพอย่างชัดเจน

ประเด็นสำคัญ

รหัสโมเดล: qwen-image-3.0-pro ให้บริการบน Alibaba Cloud Model Studio / DashScope ที่ https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026)

การยืนยันตัวตน: ตั้งค่า DASHSCOPE_API_KEY เป็นตัวแปรสภาพแวดล้อม จากนั้นส่งเป็นโทเค็น Bearer (Promptfoo, 2026)

ราคาอ้างอิง: โมเดลรุ่นก่อนหน้า qwen-image-2.0-pro มีค่าใช้จ่าย $0.075 ต่อภาพที่สร้างขึ้น ตามราคาอย่างเป็นทางการของ Alibaba (ราคา Alibaba Cloud, 2026)

โมเดลสร้างภาพแต่ละโมเดลมีโควตาฟรีสำหรับการทดสอบก่อนที่คุณจะต้องชำระเงิน (คำถามที่พบบ่อยเกี่ยวกับ Alibaba Image API, 2026)

ข้อกำหนดเบื้องต้น

ก่อนที่คุณจะเขียนโค้ดใดๆ โปรดยืนยันว่าคุณมีบัญชี Alibaba Cloud ที่สามารถเข้าถึง Model Studio ได้ คู่มืออย่างเป็นทางการ "First API call to Qwen" ระบุสามสิ่งที่นักพัฒนาทุกคนต้องการ: คีย์ API ที่สร้างขึ้นในคอนโซล Model Studio, รหัส Workspace ID ที่เชื่อมโยงกับโปรเจกต์ของคุณ และการเข้าถึงปลายทาง HTTP ของ DashScope (Alibaba Cloud, 2026)

คุณยังต้องการเครื่องมือพื้นฐานด้วย เทอร์มินัลที่มี cURL, Python 3.9 หรือใหม่กว่า และไลบรารี requests ครอบคลุมทุกอย่างในบทช่วยสอนนี้ ไม่จำเป็นต้องใช้ SDK ที่เป็นกรรมสิทธิ์ หากคุณเคยเรียกใช้ OpenAI API จากสคริปต์ รูปแบบของ DashScope จะให้ความรู้สึกคุ้นเคย เนื่องจากทั้งสองใช้โทเค็น Bearer และเนื้อหาคำขอ JSON

รูปแบบที่แนะนำคือการเก็บ Workspace เฉพาะหนึ่งรายการต่อสภาพแวดล้อม เพื่อให้คีย์สำหรับการทดสอบไม่ไปยุ่งเกี่ยวกับโควตาการผลิต การแยกนี้ยังช่วยให้การจัดสรรต้นทุนมีความชัดเจนมากขึ้นเมื่อสิ้นเดือน

ขั้นตอนที่ 1: รับคีย์ API และ Workspace ID ของคุณ

คีย์ API คือข้อมูลรับรองที่อนุญาตการเรียกใช้ทุกครั้งที่คุณทำกับ qwen-image-3.0-pro คู่มือเริ่มต้นใช้งานของ Alibaba แนะนำให้นักพัฒนาสร้างคีย์ในคอนโซล Model Studio แล้วคัดลอก Workspace ID จากแดชบอร์ดเดียวกัน (Alibaba Cloud, 2026) ให้ถือว่าค่าทั้งสองเป็นความลับ

ในการดึงข้อมูลเหล่านั้น:

ลงชื่อเข้าใช้คอนโซล Model Studio ที่พอร์ทัล Alibaba Cloud
เปิดส่วน API Keys และคลิก Create API Key
คัดลอกคีย์ที่สร้างขึ้นทันที คอนโซลจะซ่อนค่าเต็มหลังจากสร้าง
จด Workspace ID ที่แสดงอยู่ด้านบนของแดชบอร์ด

เก็บคีย์ไว้ในตัวจัดการรหัสผ่านหรือระบบจัดการความลับของทีมคุณ อย่าคัดลอกไปวางในไฟล์ซอร์สโค้ด Workspace ID มีความอ่อนไหวน้อยกว่า แต่ก็ยังควรเก็บไว้ในการกำหนดค่ามากกว่าที่จะเขียนลงในโค้ดโดยตรง

ข้อมูลอ้างอิง: คู่มืออย่างเป็นทางการ "First API call to Qwen" ของ Alibaba แนะนำให้นักพัฒนาสร้างคีย์ API ในคอนโซล Model Studio คัดลอก Workspace ID จากแดชบอร์ดเดียวกัน และเรียกใช้โมเดลผ่านปลายทาง DashScope ที่ https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026)

ขั้นตอนที่ 2: ตั้งค่าตัวแปรสภาพแวดล้อม DASHSCOPE_API_KEY

การโหลดคีย์เข้าสู่ตัวแปรสภาพแวดล้อมจะช่วยให้คีย์ไม่อยู่ในโค้ดของคุณและไม่อยู่ในการควบคุมเวอร์ชัน รูปแบบที่ชุมชนแนะนำซึ่งจัดทำเอกสารโดย Promptfoo คือการตั้งค่าตัวแปรชื่อ DASHSCOPE_API_KEY ก่อนรันสคริปต์ของคุณ ซึ่งจะถูกอ่านโดยไคลเอนต์ HTTP ในขณะที่ส่งคำขอ (Promptfoo, 2026)

On macOS and Linux:

export DASHSCOPE_API_KEY="sk-your-key-here"

On Windows PowerShell:

$env:DASHSCOPE_API_KEY = "sk-your-key-here"

สำหรับการตั้งค่าถาวร ให้เพิ่มบรรทัด export ลงใน ~/.zshrc, ~/.bashrc หรือตัวแปรสภาพแวดล้อมผู้ใช้ Windows ของคุณ รีสตาร์ทเทอร์มินัลของคุณหลังจากนั้น ตรวจสอบว่าตัวแปรถูกโหลดแล้วก่อนดำเนินการต่อ:

echo $DASHSCOPE_API_KEY

การตั้งค่าทั่วไปคือไฟล์ .env พร้อมกับตัวโหลดเช่น python-dotenv เพื่อให้การกำหนดค่าเดียวกันใช้งานได้กับการพัฒนาในเครื่อง, CI และการปรับใช้คอนเทนเนอร์ อย่าลืมเพิ่ม .env ลงใน .gitignore เพื่อไม่ให้คีย์ถูกคอมมิต

ขั้นตอนที่ 3: สร้างภาพครั้งแรกด้วย cURL

ปลายทาง DashScope ที่ https://dashscope-us.aliyuncs.com/api/v1 เป็นจุดเข้าใช้งานสำหรับโมเดล Qwen ทุกรุ่น รวมถึง qwen-image-3.0-pro (Alibaba Cloud, 2026) การเรียกใช้จะใช้โทเค็น Bearer ในส่วนหัว Authorization และเนื้อหา JSON ที่ระบุชื่อโมเดลพร้อมกับพรอมต์ของคุณ

ด้านล่างนี้คือตัวอย่างคำขอ cURL ที่แสดงให้เห็นตามปลายทางและรูปแบบการยืนยันตัวตนที่มีเอกสารประกอบ ชื่อฟิลด์และเส้นทางคำขอที่แน่นอนเป็นไปตามข้อตกลงของ DashScope แต่ คุณควรยืนยันสคีมาปัจจุบันกับเอกสารอ้างอิง API อย่างเป็นทางการ ที่ Qwen API via DashScope ก่อนนำไปใช้งานจริง

# Illustrative example. Confirm exact field names and paths against:
# https://www.alibabacloud.com/help/en/model-studio/qwen-api-via-dashscope
curl -X POST "https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  -d '{
    "model": "qwen-image-3.0-pro",
    "input": {
      "prompt": "A cozy bookstore cafe in autumn, warm light, highly detailed"
    },
    "parameters": {
      "size": "1024*1024",
      "n": 1
    }
  }'

ข้อควรทราบบางประการ:

ปลายทางสร้างภาพของ DashScope บางส่วนเป็นแบบอะซิงโครนัส ซึ่งหมายความว่าการตอบกลับครั้งแรกจะส่งคืนรหัสงาน (task ID) และคุณจะต้องเรียกใช้ URL ที่สองเพื่อดึงภาพที่สร้างเสร็จแล้ว ตรวจสอบเอกสารอ้างอิง API สำหรับพฤติกรรมที่แน่นอนของ qwen-image-3.0-pro
รักษาพรอมต์ให้อยู่ภายใต้ขีดจำกัดโทเค็นที่ระบุไว้ พรอมต์ที่ยาวเกินไปอาจถูกตัดทอนโดยไม่มีการแจ้งเตือน
ใช้พารามิเตอร์ size ที่ตรงกับอัตราส่วนภาพที่รองรับ มิฉะนั้นการเรียกใช้อาจกลับไปใช้ค่าเริ่มต้น

ข้อมูลอ้างอิง: ปลายทาง DashScope อย่างเป็นทางการที่ https://dashscope-us.aliyuncs.com/api/v1 ให้บริการ qwen-image-3.0-pro พร้อมเอกสารอ้างอิงพารามิเตอร์อินพุตและเอาต์พุตฉบับเต็มโดย Alibaba Cloud (Alibaba Cloud, 2026)

ขั้นตอนที่ 4: แยกวิเคราะห์การตอบกลับใน Python

Python เป็นภาษาที่นิยมที่สุดสำหรับการเรียกใช้ API สร้างภาพ เนื่องจากไลบรารี requests ทำให้การแยกวิเคราะห์ JSON เป็นเรื่องง่าย เมื่อการเรียกใช้ส่งคืนผลลัพธ์ คุณจะดึง URL ของภาพที่สร้างขึ้น ดาวน์โหลด และบันทึกลงดิสก์หรือที่เก็บวัตถุ

นี่คือสคริปต์ตัวอย่างสั้นๆ เช่นเดียวกับ cURL โปรดยืนยันชื่อฟิลด์การตอบกลับกับเอกสารอ้างอิง API อย่างเป็นทางการก่อนที่จะนำไปใช้

# Illustrative example. Confirm response schema against:
# https://www.alibabacloud.com/help/en/model-studio/qwen-api-via-dashscope
import os
import requests

API_KEY = os.environ["DASHSCOPE_API_KEY"]
ENDPOINT = "https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

payload = {
    "model": "qwen-image-3.0-pro",
    "input": {
        "prompt": "A cozy bookstore cafe in autumn, warm light, highly detailed"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}

response = requests.post(ENDPOINT, headers=headers, json=payload)
response.raise_for_status()
data = response.json()

# Field names below are illustrative. Verify against the official API reference.
image_url = data["output"]["results"][0]["url"]
print("Generated image URL:", image_url)

# Download the file
img = requests.get(image_url)
with open("output.png", "wb") as f:
    f.write(img.content)

เคล็ดลับสำหรับการใช้งานจริง:

ครอบการเรียกใช้ด้วย retry พร้อม exponential backoff ปัญหาเครือข่ายอาจเกิดขึ้นได้
เพิ่มการตั้งเวลาหมดอายุ (timeout) การสร้างภาพอาจใช้เวลาหลายวินาที
บันทึกรหัสคำขอแบบเต็ม ซึ่งมักจะส่งคืนในส่วนหัวการตอบกลับ เพื่อให้ฝ่ายสนับสนุนของ Alibaba สามารถติดตามความล้มเหลวได้

การเพิ่มเลเยอร์นามธรรมบางๆ ระหว่างไคลเอนต์ API และตรรกะทางธุรกิจจะช่วยได้ ด้วยวิธีนี้ การสลับโมเดลในภายหลัง (เช่น ไปยังปลายทางแก้ไขหรือ Qwen รุ่นใหม่กว่า) จะเปลี่ยนแปลงเพียงโมดูลเดียวเท่านั้น

Qwen Image 3 Pro มีค่าใช้จ่ายเท่าไหร่?

ราคาคิดตามภาพที่สร้างขึ้น และ Alibaba จะเรียกเก็บเงินเฉพาะการสร้างที่สำเร็จเท่านั้น หน้าการกำหนดราคาอย่างเป็นทางการระบุ qwen-image-2.0-pro ที่ $0.075 ต่อภาพ (ราคา Alibaba Cloud, 2026) ผู้ให้บริการบุคคลที่สามเสนอโมเดลสร้างภาพ Qwen ในราคาที่แตกต่างกัน: Fal ระบุโมเดลสร้างภาพ Qwen ที่ประมาณ $0.021 ต่อภาพ และ Replicate คิดค่าบริการประมาณ $0.030 ต่อภาพ ที่ขนาด 1024x1024 (รายละเอียดราคา Puter, 2026; pricepertoken, 2026)

สำหรับ qwen-image-3.0-pro โดยเฉพาะ ให้ถือว่าราคาของ 2.0-pro เป็นข้อมูลอ้างอิงอย่างเป็นทางการที่ใกล้เคียงที่สุด จากนั้นตรวจสอบตัวเลขปัจจุบันบนหน้าการกำหนดราคา Model Studio ก่อนจัดทำงบประมาณ

ข้อมูลอ้างอิง: Model Studio ของ Alibaba กำหนดราคา qwen-image-2.0-pro ที่ $0.075 ต่อภาพที่สร้างขึ้น โดยเรียกเก็บเงินเฉพาะการสร้างที่สำเร็จ ในขณะที่ผู้ให้บริการบุคคลที่สาม เช่น Fal และ Replicate ระบุโมเดลสร้างภาพ Qwen ที่ประมาณ $0.021 และ $0.030 ต่อภาพตามลำดับ (Alibaba Cloud, 2026; Puter, 2026)

งบประมาณรายเดือนโดยประมาณสำหรับแอปขนาดเล็กอาจมีลักษณะดังนี้:

ปริมาณ (ภาพ / เดือน)	ค่าใช้จ่ายที่ $0.075 (Alibaba)	ค่าใช้จ่ายที่ $0.021 (Fal)
1,000	$75	$21
10,000	$750	$210
100,000	$7,500	$2,100

ราคา ณ เดือนกรกฎาคม 2026

โควตาฟรีและข้อจำกัด

โมเดลสร้างภาพทุกรุ่นบน Model Studio มาพร้อมกับโควตาฟรี เพื่อให้คุณสามารถทดสอบได้ก่อนที่จะเริ่มใช้จ่าย (คำถามที่พบบ่อยเกี่ยวกับ Alibaba Image API, 2026) โควตาจะรีเซ็ตตามกำหนดเวลาที่ระบุไว้ในคำถามที่พบบ่อย

ข้อแนะนำที่เป็นประโยชน์บางประการ:

ใช้โควตาฟรีเพื่อตรวจสอบเทมเพลตพรอมต์และการรวมพารามิเตอร์
ตรวจสอบการใช้งานในแดชบอร์ด Model Studio เพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่คาดคิดเมื่อคุณเปลี่ยนไปใช้แผนแบบชำระเงิน
หากการทดสอบของคุณเริ่มล้มเหลวด้วยข้อผิดพลาดเกี่ยวกับโควตาอย่างกะทันหัน ให้ตรวจสอบอีกครั้งว่าโควตาฟรีหมดอายุแล้วหรือไม่ หรือคุณได้เปลี่ยน Workspace แล้ว

นอกเหนือจากการแปลงข้อความเป็นภาพ: Edit API

ตระกูล Qwen ยังมีปลายทางสำหรับการแก้ไขภาพโดยเฉพาะอีกด้วย ซึ่งรองรับอินพุตและเอาต์พุตหลายภาพ, การแก้ไขข้อความในภาพ, การเพิ่ม, ลบ และย้ายวัตถุ, และการเปลี่ยนท่าทาง (Qwen-Image Edit API, 2026)

สิ่งนี้สำคัญเนื่องจากการเรียกใช้การแก้ไขใช้รูปแบบคำขอที่แตกต่างจากการเรียกใช้การแปลงข้อความเป็นภาพ หากผลิตภัณฑ์ของคุณต้องการการสลับพื้นหลังหรือการลบวัตถุ คุณจะต้องเรียกใช้ปลายทางแยกต่างหากที่มีพารามิเตอร์และราคาของตัวเอง วางแผนสำหรับการผสานรวมสองเส้นทาง: หนึ่งสำหรับการสร้าง และอีกหนึ่งสำหรับการแก้ไข

คำถามที่พบบ่อย

รหัสโมเดลสำหรับ Qwen Image 3 Pro คืออะไร?

รหัสโมเดลอย่างเป็นทางการคือ qwen-image-3.0-pro ให้บริการบน Alibaba Cloud Model Studio / DashScope ที่ https://dashscope-us.aliyuncs.com/api/v1 (Alibaba Cloud, 2026) ใช้สตริงนี้ในฟิลด์ model ของเนื้อหาคำขอของคุณ

ฉันจะยืนยันตัวตนการเรียกใช้ DashScope API ได้อย่างไร?

ตั้งค่าตัวแปรสภาพแวดล้อม DASHSCOPE_API_KEY จากนั้นส่งเป็นโทเค็น Bearer ในส่วนหัว Authorization ของทุกคำขอ (Promptfoo, 2026) อย่าฮาร์ดโค้ดคีย์ในไฟล์ซอร์สโค้ดหรือคอมมิตไปยังระบบควบคุมเวอร์ชัน

Qwen Image 3 Pro มีค่าใช้จ่ายเท่าไหร่ต่อภาพ?

Alibaba กำหนดราคาโมเดลรุ่นก่อนหน้า qwen-image-2.0-pro ที่ $0.075 ต่อภาพ และเรียกเก็บเงินเฉพาะการสร้างที่สำเร็จ (ราคา Alibaba Cloud, 2026) ผู้ให้บริการบุคคลที่สาม เช่น Fal และ Replicate ระบุโมเดลสร้างภาพ Qwen ที่ประมาณ $0.021 และ $0.030 ต่อภาพ ตรวจสอบราคา 3.0-pro ปัจจุบันบนหน้าอย่างเป็นทางการ

มีโควตาฟรีหรือไม่?

มี โมเดลสร้างภาพแต่ละรุ่นบน Model Studio มีโควตาฟรีที่คุณสามารถใช้สำหรับการทดสอบก่อนที่จะเริ่มการเรียกเก็บเงินแบบชำระเงิน (คำถามที่พบบ่อยเกี่ยวกับ Alibaba Image API, 2026) ตรวจสอบคำถามที่พบบ่อยสำหรับรอบการรีเซ็ตและข้อจำกัด ซึ่งแตกต่างกันไปในแต่ละโมเดล

Qwen Image 3 Pro รองรับการแก้ไขภาพหรือไม่?

การแก้ไขจะจัดการโดยปลายทางแยกต่างหากที่เรียกว่า Qwen-Image Edit ซึ่งรองรับอินพุตและเอาต์พุตหลายภาพ, การแก้ไขข้อความในภาพ, การเพิ่ม, ลบ และย้ายวัตถุ, และการเปลี่ยนท่าทาง (Qwen-Image Edit API, 2026) API สำหรับการแปลงข้อความเป็นภาพและการแก้ไขมีรูปแบบคำขอที่แตกต่างกัน

สรุป

ตอนนี้คุณมีเส้นทางเต็มรูปแบบสำหรับการเรียกใช้ qwen-image-3.0-pro ครั้งแรกของคุณแล้ว: คีย์ API จากคอนโซล Model Studio, ตัวแปรสภาพแวดล้อม DASHSCOPE_API_KEY ที่โหลดไว้, คำขอ cURL ที่ใช้งานได้ และโค้ด Python ที่แยกวิเคราะห์และดาวน์โหลดผลลัพธ์ รูปแบบการกำหนดราคาต่อภาพ ซึ่งเริ่มต้นที่ $0.075 ตามราคาอย่างเป็นทางการของ Alibaba ทำให้ต้นทุนสามารถคาดการณ์ได้เมื่อคุณขยายขนาด

สองขั้นตอนถัดไปจะช่วยให้การผสานรวมของคุณคมชัดขึ้น ประการแรก ให้ยืนยันชื่อฟิลด์คำขอและคำตอบที่แน่นอนกับเอกสารอ้างอิง API อย่างเป็นทางการที่ Qwen API via DashScope เนื่องจากรายละเอียดสคีมาอาจเปลี่ยนแปลงได้ระหว่างเวอร์ชันของโมเดล ประการที่สอง หากผลิตภัณฑ์ของคุณต้องการการแก้ไขมากกว่าการสร้างภาพอย่างเดียว ให้สำรวจ Qwen-Image Edit API ซึ่งปลดล็อกการลบวัตถุ, การแก้ไขข้อความ, และการเปลี่ยนท่าทางผ่านปลายทางเฉพาะ

สร้างเล็กๆ, ตรวจสอบโควตาของคุณ, และนำไปใช้งาน

วิธีใช้งาน Qwen Image 3 Pro API ผ่าน DashScope: บทช่วยสอนสำหรับนักพัฒนา