ดูแบบเร็ว ๆ
Z-Image API รัน Z-Image ผ่าน Mage ที่ POST https://api.mage.space/v1/z_image/generate คำขอที่ใช้การตั้งค่าเริ่มต้นใช้ 10 Gems (ประมาณ $0.01) ไม่ต้องสมัครสมาชิก Z-Image ไม่รองรับการอ้างถึงด้วย @handle
รูปภาพ
ผลลัพธ์
1
รุ่น
10
Gems ต่อภาพ (ค่าเริ่มต้น)
$0.01
ประมาณ (USD)
ภาพรวม
Z-Image API ทำอะไรได้บ้าง
เร็วสุดๆ และใช้ Gems น้อย สร้างภาพจากข้อความได้สมจริงราวภาพถ่าย กายวิภาคแม่นยำ ตัวอักษรคมชัด สูงสุด 2K ไม่รองรับภาพอ้างอิง
โมเดลสร้างภาพที่เร็วที่สุดบน Mage สร้างภาพจากข้อความได้สมจริงราวภาพถ่าย กายวิภาคและตัวอักษรแม่นยำ ที่ 1K หรือ 2K
สร้างภาพจากพรอมต์เพียงอย่างเดียว
เริ่มต้นอย่างรวดเร็ว
เรียกใช้ Z-Image API
ตั้งค่า MAGE_API_KEY ส่งคำขอไปที่ /z_image/generate แล้วโพล status_url จนกว่าคำขอจะเสร็จสมบูรณ์
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('z_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'z-image-turbo',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("z_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "z-image-turbo",
})
print(request["result"]["url"])โมเดล
ค่า model_id ของ Z-Image
ส่ง model_id เพื่อเลือกรุ่น หากไม่ระบุ ระบบจะใช้รุ่นเริ่มต้น
| model_id | ชื่อ | ค่าเริ่มต้น |
|---|---|---|
| z-image-turbo | Z-Image | ใช่ |
ตัวเลือก
พารามิเตอร์ของ Z-Image
ค่าที่ใช้ได้รวมทุกรุ่น บางรุ่นอาจมีตัวเลือกน้อยกว่า ดูตัวเลือกของแต่ละรุ่นได้ในเอกสาร
| ฟิลด์ | ค่า |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
โมเดลภาพอื่นๆ
API สร้างภาพอื่นๆ บน Mage
ภาพ · เริ่มต้น 20 Gems
Anima API
สร้างมาเพื่ออนิเมะโดยเฉพาะ
ภาพ · เริ่มต้น 35 Gems
Chroma API
โอเพนเวทส์ สร้างบน Flux
ภาพ · เริ่มต้น 40 Gems
Flux 2 API
รองรับพรอมต์ยาวและการแก้ไขด้วยภาพอ้างอิงหลายภาพ
ภาพ · เริ่มต้น 9 Gems
GPT Image 2 API
พรอมต์แม่นยำ ข้อความอ่านชัด
ภาพ · เริ่มต้น 75 Gems
Grok Image API
Grok Imagine แบ่งเป็น 3 ระดับคุณภาพ
ภาพ · เริ่มต้น 37 Gems
Guava API
ภาพสมจริงราวกับภาพถ่ายจริง
คำถามที่พบบ่อย
คำถามที่พบบ่อย
Z-Image API ราคาเท่าไร
คำขอ Z-Image ที่ใช้การตั้งค่าเริ่มต้น (Z-Image) ใช้ 10 Gems หรือประมาณ $0.01 ความละเอียด ความยาว และรุ่นอื่นจะทำให้ราคาเปลี่ยนไป โดยผลลัพธ์จะแจ้งยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะคืน Gems ให้ แต่ถ้านโยบายเนื้อหาของ Mage บล็อกไว้ จะไม่คืนให้
endpoint ของ Z-Image API คืออะไร
POST https://api.mage.space/v1/z_image/generate พร้อมเฮดเดอร์ Authorization: Bearer ที่ใส่ Mage API key ของคุณ ผลลัพธ์ที่ได้จะมี status_url ให้โพลเพื่อรอผลลัพธ์
เรียกใช้โมเดล Z-Image ตัวไหนได้บ้าง
z-image-turbo (Z-Image) ค่าเริ่มต้นคือ Z-Image
Z-Image รองรับภาพอ้างอิงหรือ Characters ไหม
Z-Image ไม่รองรับอินพุตที่เป็นภาพ วิดีโอ หรือเสียง และไม่รองรับการอ้างถึงด้วย @handle
ใช้ Z-Image จาก Claude หรือ ChatGPT ได้ไหม
ได้ เชื่อมต่อ Mage MCP server กับ Claude, ChatGPT, Claude Code, Grok หรือ Cursor แล้วเรียกใช้ Z-Image ตามชื่อได้เลย ผู้ช่วยของคุณจะอ่านตัวเลือกด้วย get_model และแจ้งราคาก่อนสร้างทุกครั้ง
ผลลัพธ์ของ Z-Image เก็บไว้นานแค่ไหน
ผลลัพธ์และอินพุตจะถูกเก็บไว้ 30 วัน ดาวน์โหลดสิ่งที่ต้องการเก็บไว้ลงในพื้นที่จัดเก็บของคุณเอง
เริ่มสร้างสรรค์ด้วย Mage
หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง