Mage API · สร้างเสียง

API สร้างเสียงด้วย AI สำหรับเสียงพูด เพลง และเสียงประกอบ

สร้างเสียงพูด เสียงบรรยาย เพลง และเอฟเฟกต์เสียงจากพรอมต์เดียวด้วย Seed Audio พร้อมเสียงอ้างอิง และตัวปรับความเร็วพูด ความดัง และระดับเสียง

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

ดูแบบเร็ว ๆ

Mage audio generation API ใช้ Seed Audio ที่ https://api.mage.space/v1/seed_audio/generate ส่งพรอมต์ข้อความ จะแนบเสียงอ้างอิงหรือรูปภาพด้วยก็ได้ แล้วรับไฟล์เสียงยาวสูงสุด 120 วินาทีที่มีเสียงพูด เพลง หรือเอฟเฟกต์เสียง คิดค่าใช้จ่ายต่อคลิปเป็น Gems ไม่ต้องสมัครสมาชิก

โมเดล

โมเดลเสียงทั้งหมดใน Mage API

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

โมเดลเหมาะที่สุดสำหรับค่า model_idราคาเริ่มต้น
Seed Audioเสียงพูด เพลง และเอฟเฟกต์เสียงจากพรอมต์เดียวseed-audio-1.019 Gems ($0.019)

เริ่มต้นอย่างรวดเร็ว

สร้างเสียงด้วย Seed Audio

ตั้งค่า MAGE_API_KEY ส่งคำขอ แล้วโพลจนกว่าจะเสร็จ จะเปลี่ยน seed_audio ใน URL เป็นโมเดลใดก็ได้ข้างบน

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A calm narrator reading a short weather report",
  "duration": "5",
  "model_id": "seed-audio-1.0"
}' | 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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seed_audio", {
    "prompt": "A calm narrator reading a short weather report",
    "duration": "5",
    "model_id": "seed-audio-1.0",
})

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 งาน และสามารถขยายขีดจำกัดให้เหมาะกับการใช้งานของคุณได้ คำขอที่ถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน

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

สิ่งที่นักพัฒนาสร้างด้วย 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 ดังนั้นบัญชี 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

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