ข้ามไปยังเนื้อหา

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.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4: เสียงพูดสมจริงที่คุณกำกับได้eleven-v430 Gems ($0.03)
MiniMax Music 3เพลงเต็มจากเนื้อเพลงของคุณ แบบ open weightsminimax-music-3125 Gems ($0.125)
Seed Audioเสียงพูด เพลง และเอฟเฟกต์เสียงจากพรอมต์เดียวseed-audio-1.019 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 คำขอ

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

  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 ได้อะไรบ้าง

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

    โมเดลสร้างภาพ วิดีโอ และเสียง 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 แปลงข้อความเป็นเสียงพูดได้ไหม
ได้ Seed Audio อ่านสคริปต์ด้วยเสียงตามที่อธิบาย หรือด้วยเสียงอ้างอิงที่บันทึกไว้ และมีตัวปรับความเร็วพูด ความดัง และระดับเสียง นอกจากนี้ยังสร้างเพลงและเอฟเฟกต์เสียงจากช่องพรอมต์เดียวกันได้
เสียงที่สร้างยาวได้นานแค่ไหน
Seed Audio สร้างคลิปได้ยาวสูงสุด 120 วินาที
Mage API ราคาเท่าไร
ไม่มีค่าสมาชิกหรือค่ารายเดือน การสร้างแต่ละครั้งจ่ายเป็น Gems ตามราคาของโมเดลนั้น โดย 1,000 Gems ราคา $1 ในแพ็กมาตรฐาน หน้าโมเดลทุกหน้าแสดงราคาตามการตั้งค่าเริ่มต้น และผลลัพธ์ของแต่ละคำขอจะระบุยอดที่เรียกเก็บจริง หากการสร้างล้มเหลวจะได้รับเงินคืน แต่หากถูกบล็อกโดยนโยบายเนื้อหาของ Mage จะไม่คืนให้ หากยอดคงเหลือไม่พอสำหรับคำขอ ระบบจะปฏิเสธก่อนเรียกเก็บเงินใดๆ
ต้องเป็นสมาชิก Mage ถึงจะใช้ API ได้ไหม
ไม่ได้ API ใช้งานด้วย Gems เท่านั้น แผนสมาชิกและสิทธิ์สร้างไม่จำกัดในแอปไม่ครอบคลุมคำขอ API นอกจากนี้บัญชีต้องชำระเงินสำเร็จอย่างน้อยหนึ่งครั้งก่อน ไม่ว่าจะเป็นแพ็ก Gem หรือแผนใดก็ได้ โดย Gems โบนัสจากการสมัครใช้ได้ในแอป Mage เท่านั้น
นำผลลัพธ์จาก 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 ใช้ได้ทุกโมเดล จ่ายเฉพาะที่สร้างจริง

Charactersชุมชน