Mage API · การสร้างภาพ
API สร้างภาพด้วย AI ครบทุกโมเดล
แปลงข้อความเป็นภาพ แก้ไขภาพ และสร้างตัวละครที่ต่อเนื่องจาก 18 โมเดล รวมถึง Mango 4 โมเดลเรือธงของ Mage ด้วยคีย์เดียวและยอดเดียว
POST https://api.mage.space/v1/{model}/generateดูแบบเร็ว ๆ
Mage image generation API คือ REST API ที่ https://api.mage.space/v1 ซึ่งรันโมเดลแปลงข้อความเป็นภาพและแก้ไขภาพ 18 โมเดล รวมถึง Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 และ Krea 2 คุณ POST พรอมต์ไปที่ /{model}/generate จากนั้นตรวจสอบสถานะคำขอและดาวน์โหลดภาพ แต่ละภาพจ่ายด้วย Gems ไม่ต้องสมัครสมาชิก
- 18โมเดลสร้างภาพ
- $0.009ราคาเริ่มต้นที่ถูกที่สุด ต่อภาพ
- 20งานสร้างพร้อมกัน
- $0ค่าบริการรายเดือน
โมเดล
โมเดลสร้างภาพทั้งหมดใน Mage API
ราคาคิดต่อการสร้างหนึ่งครั้ง เป็น Gems โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน และแพ็กที่ใหญ่กว่าจะได้ Gems โบนัสเพิ่ม ราคาขึ้นอยู่กับโมเดล ความละเอียด และความยาว ที่แสดงคือราคาตามการตั้งค่าเริ่มต้น และทุกการตอบกลับจะระบุยอดที่เรียกเก็บจริงใน billing.gems_charged หากการสร้างล้มเหลวจะคืน Gems ให้ แต่หากถูกบล็อกตามนโยบายเนื้อหาของ Mage จะไม่คืน
| โมเดล | เหมาะที่สุดสำหรับ | ค่า model_id | ราคาเริ่มต้น |
|---|---|---|---|
| Anima | สร้างมาเพื่ออนิเมะโดยเฉพาะ | anima-v1 | 20 Gems ($0.02) |
| Chroma | โอเพนเวทส์ สร้างบน Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | พรอมต์ยาวและการแก้ไขจากภาพอ้างอิงหลายภาพ | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | พรอมต์แม่นยำและข้อความอ่านง่าย | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine สองระดับให้เลือก | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | ความสมจริงจนเหมือนภาพถ่ายจริง | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | เร็วและหลากหลาย รองรับ negative prompt | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | ภาพสวยงดงามในไม่กี่วินาที | krea-2-turbo | 20 Gems ($0.02) |
| Mango | ตระกูลโมเดลภาพรุ่นเรือธงของเรา | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | ภาพ 16 เมกะพิกเซลแบบเนทีฟ โอเพนเวทส์ | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | พรอมต์ยาวและข้อความสองภาษา โอเพนเวทส์ | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | ข้อความคมชัดอ่านง่าย สูงสุด 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL ที่แก้ปัญหาใบหน้าและมือแล้ว | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream พร้อมตัวกรองแบบเข้มงวด | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | รุ่นคลาสสิก ราคาประหยัด | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Stable Diffusion ที่ทำตามคำสั่งได้ดีที่สุด | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL ที่ปรับแต่งให้สมจริงเหมือนภาพถ่าย | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | โมเดลสร้างภาพที่เร็วที่สุดบน Mage | z-image-turbo | 10 Gems ($0.01) |
เริ่มต้นอย่างรวดเร็ว
สร้างภาพด้วย Anima v1
ตั้งค่า MAGE_API_KEY ส่งคำขอ แล้วโพลล์จนกว่าจะเสร็จ เปลี่ยน anima ใน URL เป็นโมเดลใดก็ได้ข้างต้น
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
print(request["result"]["url"])วิธีการทำงาน
จาก API key สู่สื่อที่เสร็จสมบูรณ์ใน 3 คำขอ
ทุกโมเดลใช้รูปแบบการยืนยันตัวตนเดียวกัน วงจรคำขอแบบอะซิงโครนัสเดียวกัน และชื่อฟิลด์เหมือนกัน
สร้าง API key
ลงชื่อเข้าใช้ Mage เปิด API → API Keys แล้วสร้างคีย์ คีย์จะขึ้นต้นด้วย mage_sk_ และแสดงให้เห็นเพียงครั้งเดียว หนึ่งบัญชีมีคีย์ที่ใช้งานอยู่ได้ 10 คีย์
ส่งคำขอสร้าง
ส่ง POST พร้อมเนื้อหา JSON ไปที่ https://api.mage.space/v1/{model}/generate พร้อมเฮดเดอร์ Authorization: Bearer ระบบจะตอบกลับทันทีพร้อม request_id, status และ status_url ส่งเฮดเดอร์ Idempotency-Key ด้วย เพื่อไม่ให้การลองซ้ำถูกเรียกเก็บเงินสองครั้ง
ตรวจสอบสถานะและดาวน์โหลด
ตรวจสอบ status_url ต่อเนื่องจนกว่าสถานะจะเป็น completed, failed หรือ cancelled คำขอที่เสร็จสมบูรณ์จะมี result.url ที่ชี้ไปยังไฟล์ภาพ วิดีโอ หรือเสียง โดยเก็บไว้ 30 วัน
สร้างมาเพื่อใช้งานจริง
ทุกคำขอของ Mage API ได้อะไรบ้าง
คีย์เดียว ใช้ได้ทุกโมเดล
โมเดลสร้างภาพ วิดีโอ และเสียง 37 โมเดลผ่าน REST API เดียวและยอด Gems เดียว สลับโมเดลได้แค่เปลี่ยนพาธใน URL
จ่ายตามการสร้างจริง
ไม่มีค่าสมาชิกและไม่มีขั้นต่ำ คุณซื้อ Gems แล้วแต่ละคำขอจะถูกคิดตามราคาที่แสดงไว้ หากการสร้างล้มเหลวจะได้รับเงินคืน เว้นแต่ถูกบล็อกโดยนโยบายเนื้อหาของ Mage
ลองส่งซ้ำได้อย่างปลอดภัย
Idempotency key ช่วยให้การส่งซ้ำได้ผลลัพธ์ของคำขอเดิม โดยไม่ถูกเรียกเก็บเงินอีก
ตัวละครที่คงเดิมทุกครั้ง
บันทึกตัวละครหรือภาพอ้างอิงไว้ครั้งเดียว แล้วพิมพ์ @handle ในพรอมต์ใดก็ได้เพื่อใช้กับทุกโมเดลที่รองรับ
รองรับอินพุตขนาดใหญ่
ส่งอินพุตภาพ วิดีโอ และเสียงเป็น URL หรือ data URL หรืออัปโหลดไฟล์ได้สูงสุด 100 MB ผ่านการอัปโหลดแบบมีลายเซ็น
สร้างพร้อมกันได้ 20 งาน
แต่ละบัญชีสร้างพร้อมกันได้ 20 งาน และสามารถขยายขีดจำกัดให้เหมาะกับการใช้งานของคุณได้ คำขอที่ถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน
กรณีการใช้งาน
สิ่งที่นักพัฒนาสร้างด้วย API สร้างภาพ
ภาพสินค้าและงานการตลาด
สร้างภาพสินค้า โฆษณาหลายแบบ และโพสต์โซเชียลได้ทันทีที่ต้องการ พร้อมข้อความที่อ่านออกชัดเจนจาก GPT Image 2.6 หรือ Nano Banana 2
ตัวละครที่คงเดิมทุกครั้ง
บันทึกตัวละครไว้ครั้งเดียว แล้วใช้หน้าเดิมตลอดทั้งชุดภาพด้วย Mango 4, Guava 2 Pro และโมเดลอื่นที่รองรับการเมนชัน @handle
ไปป์ไลน์แก้ไขรูปภาพ
ส่งรูปภาพต้นฉบับพร้อมคำสั่ง แล้วเปลี่ยนเฉพาะสิ่งที่คุณต้องการ ส่วนที่เหลือคงไว้ตามเดิม
แอปและเกม
สร้างอวาตาร์ สติกเกอร์ การ์ด และฉากภายในผลิตภัณฑ์ของคุณ โดยไม่ต้องโฮสต์ GPU เอง
ภาพพอร์เทรตสมจริงเหมือนภาพถ่าย
Guava 2 Pro สร้างภาพพอร์เทรต แฟชั่น และไลฟ์สไตล์ ด้วยผิว เนื้อผ้า และแสงที่สมจริงราวกับของจริง
ร่างไว ทำได้ในปริมาณมาก
Z-Image Turbo และ Krea 2 ช่วยให้ราคาต่ำ เหมาะกับภาพปกจำนวนมากและงานร่างแรก
คำถามที่พบบ่อย
คำถามที่พบบ่อย
API สร้างภาพด้วย AI ที่ดีที่สุดคืออะไร
API สร้างภาพรองรับการแก้ไขภาพและภาพอ้างอิงไหม
API สร้างภาพรองรับความละเอียดเท่าไรบ้าง
Mage API ราคาเท่าไร
ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม
นำผลลัพธ์จาก API ไปใช้เชิงพาณิชย์ได้ไหม
ขีดจำกัดอัตราการใช้งาน (rate limit) เป็นอย่างไร?
เอเจนต์ AI ของฉันใช้ Mage API ได้ไหม?
มี SDK สำหรับ Mage API ไหม?
ฉันใช้ API สร้างคอนเทนต์ของเจ้าอื่นอยู่แล้ว ต้องเปลี่ยนอะไรบ้าง?
เริ่มสร้างสรรค์ด้วย Mage
หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง