models

Qwen: Qwen Image 3

Markdown · JSON

Qwen: Qwen Image 3

Qwen-Image-3.0 รวมการสร้างและแก้ไขภาพสำหรับเลย์เอาต์ที่มีข้อมูลหนาแน่น ฉากละเอียด และตัวอักษรหลายภาษา รุ่นมาตรฐานสมดุลระหว่างคุณภาพกับความเร็ว โดยรับคำอธิบายข้อความหรือภาพได้สูงสุดสามภาพพร้อมคำสั่งแก้ไข

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

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

ความสามารถด้านเนื้อหาที่หลากหลายเหมาะกับพื้นที่ออกแบบที่มีหลายส่วนสัมพันธ์กันหรือเลย์เอาต์ภาพซ้อนกัน เตรียมพาดหัว ถ้อยคำที่แน่นอน ลำดับความสำคัญ และความสัมพันธ์ระหว่างช่องภาพก่อนเพิ่มรายละเอียดด้านสไตล์ สำหรับการเปรียบเทียบผลิตภัณฑ์ คำอธิบายที่มีประโยชน์จะระบุมุมมองหลักของผลิตภัณฑ์ คุณลักษณะที่ต้องติดป้าย และลำดับการอ่านช่องภาพประกอบ สำหรับสตอรีบอร์ด ให้แยกอธิบายตัวแบบ การกระทำ และคำบรรยายของแต่ละช่อง ความยาวพรอมป์ต์สูงสุดที่แนะนำคือ 4,500 โทเคน ใช้พื้นที่นั้นกับเนื้อหาและเลย์เอาต์ที่ภาพต้องการจริง

โมเดลรองรับพื้นผิวละเอียด ตัวอักษรขนาดเล็กซึ่งสาธิตไว้ที่ 10 พิกเซล และการเรนเดอร์ข้อความโดยตรงใน 12 ภาษา พร้อมแบบอักษรและรูปแบบศิลปะหลายชนิด ความสามารถเหล่านี้อาจรวมวัตถุสมจริงกับกราฟิกที่มีข้อมูลมากไว้ด้วยกัน แทนที่จะต้องเลือกระหว่างภาพถ่ายกับเลย์เอาต์ที่มีข้อความหนาแน่น ส่งคำและตัวเลขที่ต้องการให้แสดงอย่างตรงตัว พร้อมภาษาและตำแหน่งที่ต้องการ ให้ถือว่าอินเทอร์เฟซที่สร้างเป็นเพียงม็อกอัปภาพ: ปุ่ม แผนภูมิ และป้ายข้อความในภาพไม่ได้ทำให้แอปพลิเคชันทำงาน

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

กระบวนการป้อนภาพที่ระบุไว้รับ JPG, JPEG, PNG, BMP, TIFF, WebP และ GIF โดยประมวลผลเฉพาะเฟรมแรกของ GIF เคลื่อนไหว แต่ละภาพมีขนาดได้สูงสุด 10 MB API ปัจจุบันรับขนาดตั้งแต่ 1 ถึง 8,000 พิกเซล โดยอัตราส่วนด้านยาวต่อด้านสั้นต้องไม่เกิน 10:1 และแนะนำขนาด 384–2,048 พิกเซลเพื่อผลลัพธ์ที่ดี เลือกภาพขาเข้าที่แสดงรายละเอียดซึ่งจะย้ายหรือแก้ไขได้ชัดเจน ภาพอ้างอิงที่ครอปแน่นเกินไปอาจซ่อนโครงสร้างรอบข้างที่จำเป็นต่อการวางวัตถุอย่างเป็นธรรมชาติ

ผลลัพธ์เป็น PNG โดยให้ภาพหนึ่งถึงหกภาพต่อคำขอ และค่าเริ่มต้นคือหนึ่งภาพ พื้นที่ภาพขาออกในหน่วยพิกเซลอยู่ตั้งแต่ 512 × 512 ถึง 2,048 × 2,048 และมีอัตราส่วนภาพระหว่าง 1:8 ถึง 8:1 นี่คือขีดจำกัดด้านพื้นที่ ไม่ใช่กฎว่าทุกด้านต้องยาวไม่เกิน 2,048 พิกเซล หากไม่ระบุขนาด โมเดลจะแนะนำความละเอียดจากพรอมป์ต์ เลือกองค์ประกอบแนวนอน สี่เหลี่ยมจัตุรัส หรือแนวตั้งให้เหมาะกับการใช้งาน แล้วตรวจภาพที่คืนมาในขนาดจริงนั้น เพื่อประเมินตัวอักษรเล็กและรายละเอียดในตำแหน่งที่จะปรากฏ

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

สำหรับชิ้นงานสุดท้ายที่ใช้ได้จริง ให้ตรวจคำที่แสดง หน่วย ลำดับช่องภาพ และรายละเอียดที่ระบุตัวแบบ แล้วแก้เฉพาะส่วนที่ไม่ตรงตามคำอธิบาย คำตอบที่มีหลายภาพให้ตัวเลือกสำหรับเปรียบเทียบ เก็บแต่ละภาพที่คืนมาเชื่อมโยงกับพรอมป์ต์และภาพอ้างอิงที่ใช้สร้าง ลิงก์ภาพของผู้พัฒนาหมดอายุหลัง 24 ชั่วโมง จึงควรเก็บไฟล์ภาพจริงเมื่อผลลัพธ์กลายเป็นส่วนหนึ่งของโครงการ รุ่นมาตรฐาน 3.0 ยังคงแยกจาก Pro และจากโมเดล Qwen 2.1 ซึ่งมีจำนวนภาพอ้างอิงและความสามารถด้านความโปร่งใสต่างกัน

Ailoot Ultra · รูปภาพ POST /v1/images/generations qwen/qwen-image-3

qwen/qwen-image-3

Alibaba /qwen/qwen-image-3

เริ่มต้น

Qwen-Image-3.0 รวมการสร้างและแก้ไขภาพสำหรับเลย์เอาต์ที่มีข้อมูลหนาแน่น ฉากละเอียด และตัวอักษรหลายภาษา รุ่นมาตรฐานสมดุลระหว่างคุณภาพกับความเร็ว โดยรับคำอธิบายข้อความหรือภาพได้สูงสุดสามภาพพร้อมคำสั่งแก้ไข

อินพุตที่รองรับ
ข้อความ · รูปภาพ
ผลลัพธ์
รูปภาพ

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

Ailoot Ultra · รูปภาพ POST /v1/images/generations
ขาเข้า
text, image
ขาออก
image
ฟิลด์ประเภทข้อกำหนดค่าและข้อจำกัดค่าเริ่มต้น
ฟิลด์modelประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
qwen/qwen-image-3
ค่าเริ่มต้น—
ฟิลด์promptประเภทstringข้อกำหนดจำเป็นค่าและข้อจำกัด
ความยาวขั้นต่ำ: 1
ค่าเริ่มต้น—
ฟิลด์resolutionประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัด
1K, 2K
ค่าเริ่มต้น—
ฟิลด์aspect_ratioประเภทstringข้อกำหนดไม่บังคับค่าและข้อจำกัด
1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9
ค่าเริ่มต้น—
ฟิลด์nประเภทintegerข้อกำหนดไม่บังคับค่าและข้อจำกัด
ขั้นต่ำ: 1
สูงสุด: 6
ค่าเริ่มต้น—
ฟิลด์input_referencesประเภทarrayข้อกำหนดไม่บังคับค่าและข้อจำกัด
จำนวนรายการขั้นต่ำ: 0
จำนวนรายการสูงสุด: 4
ค่าเริ่มต้น—
ฟิลด์providerประเภทobjectข้อกำหนดไม่บังคับค่าและข้อจำกัดค่าเริ่มต้น—
พารามิเตอร์และวงจรการทำงานของเมธอด
พารามิเตอร์ข้อกำหนด
พารามิเตอร์content_typeข้อกำหนดapplication/json
พารามิเตอร์requiredข้อกำหนดmodel, prompt
พารามิเตอร์material_typesข้อกำหนดtext, image

วงจรการทำงาน: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ค่า task_id ที่ส่งกลับมาจริง หรือระเบียนในคลังสื่อ

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

ราคา

วิธีคำนวณค่าบริการสุดท้าย

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

ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก

โหมดรวดเร็ว
ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
โหมดยืดหยุ่น
ไม่ได้ระบุ เมื่อเลือกโหมด flex
ระดับการใช้เหตุผลสูงสุด
ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

อัตราประมาณการเพื่อเปรียบเทียบ

ราคาตามการตั้งค่า

เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน

การตั้งค่าตารางอัตราค่าบริการปริมาณคาดการณ์หน่วยคิดค่าบริการค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐานตารางอัตราค่าบริการอัตราพื้นฐานปริมาณคาดการณ์—หน่วยคิดค่าบริการ—ค่าบริการ
ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
การตั้งค่าภาพขาเข้าตารางอัตราค่าบริการ—ปริมาณคาดการณ์—หน่วยคิดค่าบริการต่อภาพอินพุตค่าบริการ
ขาเข้า · ภาพขาเข้า · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.006 ต่อภาพอินพุต
การตั้งค่าต้นทุนการสร้างโดยประมาณตารางอัตราค่าบริการ—ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้งหน่วยคิดค่าบริการ—ค่าบริการ
ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.06 ประมาณการก่อนสร้าง

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

Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →

ตัวอย่างคำขอ

Ailoot Ultra · รูปภาพ

curl
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

รับและบันทึกผลลัพธ์

Ailoot Ultra · รูปภาพ

ดาวน์โหลดภาพที่ส่งกลับมาทุกภาพ หรือบันทึกเนื้อหา Base64 ของภาพนั้น

  • GET /v1/media/tasks/{task_id}
  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
การอ่านเนื้อหาแบบอื่น
อ่านไฟล์สื่อที่มีอยู่และเป็นของคุณ
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

บันทึกภาพที่สร้างเสร็จทุกภาพ โดยดึงภาพจากทุก URL ที่ส่งกลับมา หรือถอดรหัสเนื้อหา Base64

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

เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ

เก็บ X-Client-Request-ID ที่ส่งกลับมาไว้เพื่อกระทบยอด อ่านเฉพาะค่า task_id/asset_id ที่ส่งกลับมาจริง หรืออ่านจากคลังสื่อที่เป็นของตนเอง ห้ามสร้าง URL ของงานจาก ID การดำเนินการ และห้ามส่งคำขอสร้างซ้ำเด็ดขาด

ฟิลด์การตอบกลับ
ฟิลด์ประเภท
ฟิลด์createdประเภท
ฟิลด์data[].urlประเภท
ฟิลด์data[].b64_jsonประเภท
ฟิลด์usageประเภท

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra qwen/qwen-image-3

ชื่อพาธเมธอดอื่น

/v1/images

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

qwen/qwen-image-3

FAQ · Qwen: Qwen Image 3
มีอินพุตและผลลัพธ์ใดบ้าง?

POST /v1/images/generations · qwen/qwen-image-3: text, image → image

คำขอใช้ฟิลด์ใดบ้าง?

POST /v1/images/generations · qwen/qwen-image-3: model, prompt, resolution, aspect_ratio, n, input_references, provider

มีข้อจำกัดใดบ้าง?

POST /v1/images/generations · qwen/qwen-image-3: n.minimum: 1; n.maximum: 6

รายละเอียดเพิ่มเติม

เชื่อม Ailoot กับ Claude Code, OpenCode, Hermes หรือแอปของคุณ

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท: ลูกค้าหลายล้านราย; ยอดขายระดับหลายพันล้านต่อเดือน.

ซื้อโทเคนพร้อมส่วนลด

ส่วนลดสมาชิกสำหรับงานประจำ โค้ดโปรโมชั่นลดซื้อโทเคนสูงสุด 50%

สมาชิก
เลือกแพ็กเกจมีส่วนลดสำหรับคำขอประจำ
โค้ดลดสูงสุด 50%
ใส่โค้ดขณะซื้อ ราคาคำนวณใหม่ตามโปรโมชั่นที่ใช้
รายจ่ายในประวัติ
เก็บโมเดล โทเคน และยอดสำหรับทุกคำขอ

เลือกสมาชิก · ดูราคาโมเดล

เชื่อม API กับผลิตภัณฑ์ ที่คุณขาย

SaaS แอป และบอต ตามข้อเสนอและสัญญาอนุญาต Ailoot หากขายต่อให้ขอใบอนุญาตรีเซลเลอร์

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

ขอใบอนุญาตขายต่อ · ข้อเสนอและสัญญาอนุญาต