Mage API · สร้างเสียง
API สร้างเสียงด้วย AI สำหรับเสียงพูด เพลง และเสียงประกอบ
สร้างเสียงพูด เสียงบรรยาย เพลง และเอฟเฟกต์เสียงจากพรอมต์เดียวด้วย Seed Audio พร้อมเสียงอ้างอิง และตัวปรับความเร็วพูด ความดัง และระดับเสียง
POST https://api.mage.space/v1/{model}/generateดูแบบเร็ว ๆ
Mage audio generation API ใช้ Seed Audio ที่ https://api.mage.space/v1/seed_audio/generate ส่งพรอมต์ข้อความ จะแนบเสียงอ้างอิงหรือรูปภาพด้วยก็ได้ แล้วรับไฟล์เสียงยาวสูงสุด 120 วินาทีที่มีเสียงพูด เพลง หรือเอฟเฟกต์เสียง คิดค่าใช้จ่ายต่อคลิปเป็น Gems ไม่ต้องสมัครสมาชิก
- 4โมเดลเสียง
- $0.019ค่าเริ่มต้นที่ถูกที่สุด ต่อคลิป
- 20งานสร้างพร้อมกัน
- $0ค่าบริการรายเดือน
โมเดล
โมเดลเสียงทั้งหมดใน Mage API
ราคาคิดต่อการสร้างหนึ่งครั้ง เป็น Gems โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน และแพ็กที่ใหญ่กว่าจะได้ Gems โบนัสเพิ่ม ราคาขึ้นอยู่กับโมเดล ความละเอียด และความยาว ที่แสดงคือราคาตามการตั้งค่าเริ่มต้น และทุกการตอบกลับจะระบุยอดที่เรียกเก็บจริงใน billing.gems_charged หากการสร้างล้มเหลวจะคืน Gems ให้ แต่หากถูกบล็อกตามนโยบายเนื้อหาของ Mage จะไม่คืน
| โมเดล | เหมาะที่สุดสำหรับ | ค่า model_id | ราคาเริ่มต้น |
|---|---|---|---|
| Eleven Music | เพลงจาก ElevenLabs จะมีเสียงร้องหรือไม่มีก็ได้ | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: เสียงพูดสมจริงที่คุณกำกับได้ | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | เพลงเต็มจากเนื้อเพลงของคุณ แบบ open weights | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | เสียงพูด เพลง และเอฟเฟกต์เสียงจากพรอมต์เดียว | seed-audio-1.0 | 19 Gems ($0.019) |
เริ่มต้นอย่างรวดเร็ว
สร้างเสียงด้วย Eleven Music v2.5
ตั้งค่า MAGE_API_KEY ส่งคำขอ แล้วโพลจนกว่าจะเสร็จ จะเปลี่ยน eleven_music ใน URL เป็นโมเดลไหนก็ได้ด้านบน
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
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 งาน และสามารถขยายขีดจำกัดให้เหมาะกับการใช้งานของคุณได้ คำขอที่ถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน
กรณีการใช้งาน
สิ่งที่นักพัฒนาสร้างด้วย audio API
เสียงบรรยายและเสียงพากย์
สร้างเสียงบรรยายสำหรับวิดีโอ คลิปอธิบาย และหนังสือเสียง พร้อมปรับความเร็วพูด ความดัง และระดับเสียงได้
เสียงที่เหมือนเดิมทุกคลิป
บันทึกคลิปเสียงเป็นเสียงอ้างอิง แล้วเรียกใช้ด้วย @handle เพื่อให้ได้เสียงเดิมในทุกคลิป
เอฟเฟกต์เสียง
สร้างเสียงบรรยากาศ เสียงโฟลีย์ และเสียง UI จากคำอธิบายสำหรับเกมและแอป
เพลงประกอบพื้นหลัง
สร้างเพลงพื้นหลังสำหรับคลิปโซเชียลและโฆษณาจากพรอมต์
ซาวด์แทร็กสำหรับวิดีโอที่สร้างด้วย AI
ใช้ Seed Audio ร่วมกับ video API เพื่อเติมเสียงให้คลิปจากโมเดลที่ไม่มีเสียง
เอเจนต์ที่พูดได้
ให้ Claude, ChatGPT หรือเอเจนต์ของคุณเองสร้างเสียงผ่านเซิร์ฟเวอร์ MCP หรือ REST API
คำถามที่พบบ่อย
คำถามที่พบบ่อย
audio API แปลงข้อความเป็นเสียงพูดได้ไหม
เสียงที่สร้างยาวได้นานแค่ไหน
Mage API ราคาเท่าไร
ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม
นำผลลัพธ์จาก API ไปใช้เชิงพาณิชย์ได้ไหม
ขีดจำกัดอัตราการใช้งาน (rate limit) เป็นอย่างไร?
เอเจนต์ AI ของฉันใช้ Mage API ได้ไหม?
มี SDK สำหรับ Mage API ไหม?
ฉันใช้ API สร้างคอนเทนต์ของเจ้าอื่นอยู่แล้ว ต้องเปลี่ยนอะไรบ้าง?
เริ่มสร้างสรรค์ด้วย Mage
หนึ่งบัญชี หนึ่งยอด Gems ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง