رفتن به محتوا
محیط آزمایشمستنداتدریافت کلید API

API مج · تولید صدا

API تولید صدا با هوش مصنوعی برای صدا، موسیقی و افکت

گفتار، روایت، موسیقی و افکت صوتی از یک پرامپت با Seed Audio، همراه با مرجع صدا و کنترل سرعت گفتار، بلندی صدا و زیر و بمی.

دریافت کلید APIمطالعه مستندات API
POST https://api.mage.space/v1/{model}/generate

در یک نگاه

API تولید صدای Mage مدل Seed Audio را در https://api.mage.space/v1/seed_audio/generate اجرا می‌کند. یک پرامپت متنی بفرستید، در صورت نیاز همراه با مرجع صدا یا یک تصویر، و فایل صوتی‌ای تا ۱۲۰ ثانیه با صدا، موسیقی یا افکت صوتی دریافت کنید. هزینه هر کلیپ با Gems پرداخت می‌شود و اشتراکی لازم نیست.

  • 1مدل صوتی
  • $0.019ارزان‌ترین گزینهٔ پیش‌فرض، هر کلیپ
  • 20تولید هم‌زمان
  • $0هزینه ماهانه

مدل‌ها

همه مدل‌های صوتی در API مج

قیمت‌ها به‌ازای هر تولید و بر حسب Gem است. ۱,۰۰۰ Gem در بستهٔ استاندارد ۱ دلار است و بسته‌های بزرگ‌تر Gem جایزه دارند. قیمت به مدل، رزولوشن و مدت‌زمان بستگی دارد؛ قیمت با تنظیمات پیش‌فرض نمایش داده شده و هر پاسخ مبلغ دقیق را در billing.gems_charged اعلام می‌کند. تولیدی که ناموفق شود بازپرداخت می‌شود؛ تولیدی که سیاست محتوایی 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 تا رسانه آماده در سه فراخوانی

همه مدل‌ها یک روش احراز هویت، یک چرخه عمر درخواست ناهمگام و نام فیلدهای یکسان دارند.

  1. ساخت کلید API

    وارد Mage شوید، به API → API Keys بروید و یک کلید بسازید. کلید با mage_sk_ شروع می‌شود و فقط یک بار نمایش داده می‌شود. هر حساب می‌تواند ۱۰ کلید فعال داشته باشد.

  2. ارسال یک درخواست تولید

    یک بدنه JSON را با POST به https://api.mage.space/v1/{model}/generate بفرستید و هدر Authorization: Bearer را اضافه کنید. پاسخ بلافاصله همراه با request_id، status و status_url برمی‌گردد. هدر Idempotency-Key را هم بفرستید تا تلاش مجدد هرگز دو بار هزینه نداشته باشد.

  3. بررسی وضعیت و دانلود

    status_url را مرتب بررسی کنید تا status به completed، failed یا cancelled برسد. درخواست تکمیل‌شده شامل result.url با فایل تصویر، ویدیو یا صدا است که ۳۰ روز نگهداری می‌شود.

ساخته‌شده برای محیط عملیاتی

هر درخواست Mage API چه امکاناتی دارد

  • یک کلید، همه‌ی مدل‌ها

    ۲۸ مدل تصویر، ویدیو و صدا پشت یک REST API و یک موجودی Gem. فقط با تغییر مسیر URL مدل را عوض کنید.

  • پرداخت به‌ازای هر تولید

    بدون اشتراک و بدون حداقل هزینه. شما Gem می‌خرید و برای هر درخواست قیمت اعلام‌شده کسر می‌شود. اگر تولیدی ناموفق باشد، هزینه‌اش برمی‌گردد، مگر اینکه سیاست محتوایی Mage جلوی آن را گرفته باشد.

  • تلاش مجدد ایمن

    با کلیدهای idempotency، ارسال دوباره‌ی درخواست همان درخواست اولیه را برمی‌گرداند و دوباره هزینه‌ای کسر نمی‌شود.

  • شخصیت‌های یکدست

    یک بار شخصیت یا رفرنس را ذخیره کنید، بعد در هر پرامپت @handle را بنویسید تا با هر مدلی که از آن پشتیبانی می‌کند استفاده شود.

  • ورودی‌های حجیم

    ورودی‌های تصویر، ویدیو و صدا را به‌صورت URL یا data URL بفرستید، یا فایل‌هایی تا ۱۰۰ مگابایت را با آپلود امضاشده بارگذاری کنید.

  • ۲۰ تولید هم‌زمان

    هر حساب می‌تواند هم‌زمان ۲۰ تولید را اجرا کند و این سقف را می‌شود متناسب با نیاز شما افزایش داد. برای درخواست‌های ردشده هیچ هزینه‌ای کسر نمی‌شود.

موارد استفاده

توسعه‌دهندگان با API صوتی چه می‌سازند

  • روایت و گویندگی

    برای ویدیوها، ویدیوهای آموزشی و کتاب‌های صوتی روایت تولید کنید، با کنترل سرعت گفتار، بلندی صدا و زیر و بمی.

  • صداهای ثابت

    یک کلیپ صوتی را به‌عنوان مرجع ذخیره کنید و با @handle آن را صدا بزنید تا در همه کلیپ‌ها صدا یکسان بماند.

  • افکت‌های صوتی

    از روی یک توضیح، صدای محیط، فولی و صداهای رابط کاربری برای بازی‌ها و اپ‌ها بسازید.

  • موسیقی پس‌زمینه

    از روی یک پرامپت، موسیقی پس‌زمینه برای کلیپ‌های شبکه‌های اجتماعی و تبلیغات تولید کنید.

  • موسیقی متن برای ویدیوهای تولیدشده

    Seed Audio را با API ویدیو ترکیب کنید تا به کلیپ‌های مدل‌های بی‌صدا، صدا اضافه شود.

  • ایجنت‌هایی که حرف می‌زنند

    بگذارید Claude، ChatGPT یا ایجنت خودتان از طریق سرور MCP یا REST API صدا تولید کند.

سؤالات متداول

سؤالات متداول

آیا API صوتی می‌تواند متن را به گفتار تبدیل کند؟
بله. Seed Audio یک متن را با صدایی که توصیف می‌کنید یا با یک مرجع صدای ذخیره‌شده می‌خواند و تنظیمات سرعت گفتار، بلندی صدا و زیر و بمی دارد. همچنین از همان فیلد پرامپت، موسیقی و افکت صوتی هم تولید می‌کند.
صدای تولیدشده می‌تواند چقدر طولانی باشد؟
Seed Audio کلیپ‌هایی تا ۱۲۰ ثانیه تولید می‌کند.
هزینه‌ی Mage API چقدر است؟
اشتراک یا هزینه‌ی ماهانه‌ای وجود ندارد. هر تولید با Gem و به قیمت اعلام‌شده‌ی مدلش پرداخت می‌شود و در بسته‌ی استاندارد، ۱٬۰۰۰ Gem معادل ۱ دلار است. صفحه‌ی هر مدل قیمت با تنظیمات پیش‌فرض را نشان می‌دهد و هر پاسخ مبلغ دقیق کسرشده را اعلام می‌کند. اگر تولیدی ناموفق باشد، هزینه‌اش برمی‌گردد؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برنمی‌گردد. درخواستی که موجودی‌تان برای آن کافی نباشد، پیش از کسر هر مبلغی رد می‌شود.
برای استفاده از API به عضویت Mage نیاز دارم؟
نه. API فقط با Gem کار می‌کند. طرح‌های عضویت و تولید نامحدود داخل برنامه شامل درخواست‌های API نمی‌شوند، پس هر حساب Mage که Gem داشته باشد می‌تواند از آن استفاده کند.
آیا می‌توانم از خروجی‌های API استفاده تجاری کنم؟
بله. محتوایی که با Mage می‌سازید، از جمله از طریق API و سرور MCP، قابل استفادهٔ تجاری است. ذکر منبع مایهٔ قدردانی است، اما الزامی نیست.
محدودیت نرخ درخواست چقدر است؟
هر حساب می‌تواند هم‌زمان ۲۰ تولید در صف یا در حال اجرا داشته باشد. ارسال بیش از این مقدار با خطای 429 رد می‌شود و هزینه‌ای ندارد. برای افزایش این سقف متناسب با نیازتان به [email protected] ایمیل بزنید.
آیا ایجنت هوش مصنوعی من می‌تواند از API مجموعهٔ Mage استفاده کند؟
بله. ایجنت‌ها می‌توانند با یک کلید، REST API را فراخوانی کنند یا به سرور MCP مجموعهٔ Mage وصل شوند که شانزده ابزار آماده برای Claude، ChatGPT، Claude Code، Grok و Cursor فراهم می‌کند تا مدل انتخاب کنند، قیمت را استعلام کنند، تولید کنند و نتیجه را دریافت کنند. جزئیات: سرور MCP.
آیا برای Mage API یک SDK وجود دارد؟
بله. بستهٔ رسمی @mage-space/sdk روی npm و mage-space روی PyPI متن‌باز هستند و برای همهٔ مدل‌ها تایپ‌شده‌اند. این بسته‌ها درخواست را ارسال می‌کنند، منتظر نتیجه می‌مانند، با اطمینان دوباره تلاش می‌کنند و فایل‌ها را برایتان آپلود می‌کنند. کاربران ComfyUI می‌توانند بستهٔ نودهای comfyui-mage را نصب کنند. جزئیات: SDKهای Mage.
من از قبل از API تولید دیگری استفاده می‌کنم. چه چیزی را باید تغییر بدهم؟
کلاینتتان را به https://api.mage.space/v1 وصل کنید، کلید Mage را به‌صورت Bearer token بفرستید و فیلدهایتان را با صفحهٔ مدل تطبیق دهید: prompt، aspect_ratio، resolution، duration و model_id در همهٔ مدل‌های Mage به یک شکل کار می‌کنند. درخواست‌ها ناهم‌گام‌اند؛ پس ابتدا ارسال کنید و سپس status_url را مرتب بررسی کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.

دریافت کلید APIمطالعه مستندات API