Mage API · การสร้างภาพ

API สร้างภาพด้วย AI ครบทุกโมเดล

สร้างภาพจากข้อความ แก้ไขภาพ และสร้างตัวละครหน้าเดิมจาก 15 โมเดล รวมถึง Mango 3 รุ่นเรือธงของ Mage ด้วยคีย์เดียวและยอดคงเหลือเดียว

รับ API keyอ่านเอกสาร API
POST https://api.mage.space/v1/{model}/generate

ดูแบบเร็ว ๆ

API สร้างภาพของ Mage เป็น REST API ที่ https://api.mage.space/v1 ใช้รันโมเดลสร้างภาพจากข้อความและแก้ไขภาพ 15 โมเดล เช่น Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 และ Krea 2 คุณ POST พรอมต์ไปที่ /{model}/generate โพลล์สถานะคำขอ แล้วดาวน์โหลดภาพ จ่ายต่อภาพด้วย Gems ไม่ต้องสมัครสมาชิก

โมเดล

โมเดลสร้างภาพทั้งหมดใน Mage API

ราคาคิดต่อการสร้างหนึ่งครั้ง เป็น Gems โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน และแพ็กที่ใหญ่กว่าจะได้ Gems โบนัสเพิ่ม ราคาขึ้นอยู่กับโมเดล ความละเอียด และความยาว ที่แสดงคือราคาตามการตั้งค่าเริ่มต้น และทุกการตอบกลับจะระบุยอดที่เรียกเก็บจริงใน billing.gems_charged หากการสร้างล้มเหลวจะคืน Gems ให้ แต่หากถูกบล็อกตามนโยบายเนื้อหาของ Mage จะไม่คืน

โมเดลเหมาะที่สุดสำหรับค่า model_idราคาเริ่มต้น
Animaสร้างมาเพื่ออนิเมะโดยเฉพาะanima-v120 Gems ($0.02)
Chromaโอเพนเวทส์ สร้างบน Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2พรอมต์ยาวและการแก้ไขจากภาพอ้างอิงหลายภาพflux2-dev40 Gems ($0.04)
GPT Image 2พรอมต์แม่นยำและข้อความอ่านง่ายgpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine แบ่งเป็นสามระดับคุณภาพgrok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.075 Gems ($0.075)
Guavaความสมจริงจนเหมือนภาพถ่ายจริงguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamเร็วและหลากหลาย รองรับ negative prompthidream-fast20 Gems ($0.02)
Krea 2ภาพสวยงดงามในไม่กี่วินาทีkrea-2-turbo20 Gems ($0.02)
Mangoตระกูลโมเดลภาพรุ่นเรือธงของเราmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo135 Gems ($0.135)
Nano Banana 2ข้อความคมชัดอ่านง่าย สูงสุด 4Knano-banana-v268 Gems ($0.068)
SDXL PlusSDXL ที่แก้ปัญหาใบหน้าและมือแล้ว6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
Stable Diffusion v1.5รุ่นคลาสสิก ราคาประหยัด15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeStable Diffusion ที่ทำตามคำสั่งได้ดีที่สุดsd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL ที่ปรับแต่งให้สมจริงเหมือนภาพถ่าย6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-Imageโมเดลสร้างภาพที่เร็วที่สุดบน Magez-image-turbo10 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 คำขอ

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

  1. สร้าง API key

    ลงชื่อเข้าใช้ Mage เปิด API → API Keys แล้วสร้างคีย์ คีย์จะขึ้นต้นด้วย mage_sk_ และแสดงให้เห็นเพียงครั้งเดียว หนึ่งบัญชีมีคีย์ที่ใช้งานอยู่ได้ 10 คีย์

  2. ส่งคำขอสร้าง

    ส่ง POST พร้อมเนื้อหา JSON ไปที่ https://api.mage.space/v1/{model}/generate พร้อมเฮดเดอร์ Authorization: Bearer ระบบจะตอบกลับทันทีพร้อม request_id, status และ status_url ส่งเฮดเดอร์ Idempotency-Key ด้วย เพื่อไม่ให้การลองซ้ำถูกเรียกเก็บเงินสองครั้ง

  3. ตรวจสอบสถานะและดาวน์โหลด

    ตรวจสอบ status_url ต่อเนื่องจนกว่าสถานะจะเป็น completed, failed หรือ cancelled คำขอที่เสร็จสมบูรณ์จะมี result.url ที่ชี้ไปยังไฟล์ภาพ วิดีโอ หรือเสียง โดยเก็บไว้ 30 วัน

สร้างมาเพื่อใช้งานจริง

ทุกคำขอของ Mage API ได้อะไรบ้าง

คีย์เดียว ใช้ได้ทุกโมเดล

โมเดลภาพ วิดีโอ และเสียง 28 โมเดลใน REST API เดียว และยอด Gems เดียว สลับโมเดลได้เพียงเปลี่ยนพาธ URL

จ่ายตามการสร้างจริง

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

ลองส่งซ้ำได้อย่างปลอดภัย

Idempotency key ช่วยให้การส่งซ้ำได้ผลลัพธ์ของคำขอเดิม โดยไม่ถูกเรียกเก็บเงินอีก

ตัวละครที่คงเดิมทุกครั้ง

บันทึกตัวละครหรือภาพอ้างอิงไว้ครั้งเดียว แล้วพิมพ์ @handle ในพรอมต์ใดก็ได้เพื่อใช้กับทุกโมเดลที่รองรับ

รองรับอินพุตขนาดใหญ่

ส่งอินพุตภาพ วิดีโอ และเสียงเป็น URL หรือ data URL หรืออัปโหลดไฟล์ได้สูงสุด 100 MB ผ่านการอัปโหลดแบบมีลายเซ็น

สร้างพร้อมกันได้ 20 งาน

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

กรณีการใช้งาน

สิ่งที่นักพัฒนาสร้างด้วย API สร้างภาพ

ภาพสินค้าและงานการตลาด

เรนเดอร์ภาพสินค้า โฆษณาหลายเวอร์ชัน และโพสต์โซเชียลได้ตามต้องการ พร้อมข้อความอ่านง่ายจาก GPT Image 2.5 หรือ Nano Banana 2

ตัวละครที่คงเดิมทุกครั้ง

บันทึกตัวละครไว้ครั้งเดียว แล้วคงใบหน้าเดิมตลอดทั้งชุดภาพด้วย Mango 3, Guava 2 Pro และโมเดลอื่นที่รองรับการระบุ @handle

ไปป์ไลน์แก้ไขรูปภาพ

ส่งรูปภาพต้นฉบับพร้อมคำสั่ง แล้วเปลี่ยนเฉพาะสิ่งที่คุณต้องการ ส่วนที่เหลือคงไว้ตามเดิม

แอปและเกม

สร้างอวาตาร์ สติกเกอร์ การ์ด และฉากภายในผลิตภัณฑ์ของคุณ โดยไม่ต้องโฮสต์ GPU เอง

ภาพพอร์เทรตสมจริงเหมือนภาพถ่าย

Guava 2 Pro สร้างภาพพอร์เทรต แฟชั่น และไลฟ์สไตล์ ด้วยผิว เนื้อผ้า และแสงที่สมจริงราวกับของจริง

ร่างไว ทำได้ในปริมาณมาก

Z-Image Turbo และ Krea 2 ช่วยให้ราคาต่ำ เหมาะกับภาพปกจำนวนมากและงานร่างแรก

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

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

API สร้างภาพด้วย AI ที่ดีที่สุดคืออะไร

ขึ้นอยู่กับงาน บน Mage นั้น Mango 3 เป็นค่าเริ่มต้นสำหรับภาพส่วนใหญ่ เพราะทำตามคำสั่งได้แม่นยำ รักษาความสม่ำเสมอของตัวละคร และแก้ไขภาพโดยไม่กระทบส่วนอื่น Guava 2 Pro เหมาะที่สุดกับภาพสมจริงเหมือนภาพถ่าย GPT Image 2.5 และ Nano Banana 2 เหมาะกับข้อความในภาพ ส่วน Z-Image Turbo หรือ Krea 2 เหมาะกับงานร่างที่เร็วและราคาประหยัด ทั้งหมดใช้งานผ่าน API เดียวกัน

API สร้างภาพรองรับการแก้ไขภาพและภาพอ้างอิงไหม

รองรับ โมเดลที่รับรูปภาพได้จะรับผ่านฟิลด์ image และ additional_images ในรูปแบบ URL, data URL หรืออัปโหลด หน้าโมเดลแต่ละรุ่นจะแสดงอินพุตและจำนวนภาพอ้างอิงที่รับได้

API สร้างภาพรองรับความละเอียดเท่าไรบ้าง

ขึ้นอยู่กับโมเดล โมเดลส่วนใหญ่รองรับ 1K และ 2K, Mango 3S รองรับ 3K ส่วน Mango 2 และ Nano Banana 2 รองรับสูงสุด 4K หน้าโมเดลแต่ละรุ่นจะแสดงตัวเลือกความละเอียดและอัตราส่วนภาพ

Mage API ราคาเท่าไร

ไม่มีค่าสมาชิกหรือค่ารายเดือน การสร้างแต่ละครั้งจ่ายเป็น Gems ตามราคาของโมเดลนั้น โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน หน้าโมเดลทุกหน้าแสดงราคาตามการตั้งค่าเริ่มต้น และผลลัพธ์ของแต่ละคำขอจะระบุยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะได้รับเงินคืน แต่หากถูกบล็อกโดยนโยบายเนื้อหาของ Mage จะไม่คืนให้ หากยอดคงเหลือไม่พอสำหรับคำขอ ระบบจะปฏิเสธก่อนเรียกเก็บเงินใดๆ

ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม

ไม่ต้อง API ใช้ Gems เท่านั้น แพ็กเกจสมาชิกและสิทธิ์สร้างไม่จำกัดในแอปไม่มีผลกับคำขอ API ดังนั้นบัญชี Mage ใดก็ตามที่มี Gems ก็เรียกใช้ได้

นำผลลัพธ์จาก API ไปใช้เชิงพาณิชย์ได้ไหม

ได้ คอนเทนต์ที่คุณสร้างด้วย Mage รวมถึงที่สร้างผ่าน API และเซิร์ฟเวอร์ MCP นำไปใช้เชิงพาณิชย์ได้ ยินดีหากให้เครดิต แต่ไม่จำเป็น

ขีดจำกัดอัตราการใช้งาน (rate limit) เป็นอย่างไร?

หนึ่งบัญชีมีงานสร้างที่อยู่ในคิวหรือกำลังทำงานพร้อมกันได้ 20 งาน หากส่งเกินจากนั้นจะถูกปฏิเสธด้วยรหัส 429 และไม่เสียค่าใช้จ่าย หากต้องการเพิ่มขีดจำกัดให้เหมาะกับการใช้งานของคุณ ติดต่อได้ที่ [email protected]

เอเจนต์ AI ของฉันใช้ Mage API ได้ไหม?

ได้ เอเจนต์เรียกใช้ REST API ด้วยคีย์ หรือเชื่อมต่อกับเซิร์ฟเวอร์ MCP ของ Mage ซึ่งมีเครื่องมือสำเร็จรูป 16 รายการให้ Claude, ChatGPT, Claude Code, Grok และ Cursor ใช้เลือกโมเดล ตีราคา สร้าง และดึงผลลัพธ์ ดู เซิร์ฟเวอร์ MCP.

มี SDK สำหรับ Mage API ไหม?

มี แพ็กเกจทางการ @mage-space/sdk บน npm และ mage-space บน PyPI เป็นโอเพนซอร์สและมี type ครบทุกโมเดล ทำหน้าที่ส่งคำขอ รอผลลัพธ์ ลองใหม่อย่างปลอดภัย และอัปโหลดไฟล์ให้คุณ ผู้ใช้ ComfyUI ติดตั้งชุดโหนด comfyui-mage ได้ ดู Mage SDK.

ฉันใช้ API สร้างคอนเทนต์ของเจ้าอื่นอยู่แล้ว ต้องเปลี่ยนอะไรบ้าง?

ชี้ไคลเอนต์ของคุณไปที่ https://api.mage.space/v1 ส่งคีย์ Mage เป็น Bearer token แล้วแมปฟิลด์ของคุณตามหน้าโมเดล: prompt, aspect_ratio, resolution, duration และ model_id ใช้งานแบบเดียวกันในทุกโมเดลของ Mage คำขอทำงานแบบอะซิงโครนัส จึงต้องส่งคำขอก่อน แล้วโพลล์ที่ status_url

เริ่มสร้างสรรค์ด้วย Mage

หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง

รับ API keyอ่านเอกสาร API

ที่เกี่ยวข้อง