رفتن به محتوا

Mage API · مدل صوتی

API مدل Seed Audio

صدا، موسیقی و افکت صوتی از یک پرامپت

POST https://api.mage.space/v1/seed_audio/generate

در یک نگاه

API مدل Seed Audio در Mage، مدل Seed Audio را از طریق POST https://api.mage.space/v1/seed_audio/generate اجرا می‌کند. هر درخواست با تنظیمات پیش‌فرض ۱۹ Gems (حدود ۰٫۰۱۹ دلار) هزینه دارد و نیازی به اشتراک نیست. Seed Audio مرجع‌های صوتی ذخیره‌شده را با @handle در پرامپت می‌پذیرد.

  • صداخروجی
  • 1نسخه
  • 19Gems برای هر کلیپ، پیش‌فرض
  • $0.019حدود، به دلار

نگاه کلی

API مدل Seed Audio چه کار می‌کند

گفتار، گفت‌وگو، موسیقی و افکت صوتی از یک پرامپت، به‌صورت MP3 با همان مدتی که می‌خواهی، از ۵ ثانیه تا ۲ دقیقه. صدا را از روی حداکثر ۳ کلیپ صوتی تطبیق بده.

صدا، گفت‌وگو، موسیقی و افکت صوتی از یک پرامپت، به‌صورت MP3 با همان مدت درخواستی.

image را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی API مدل Seed Audio

مقدار MAGE_API_KEY را تنظیم کن، درخواست را به /seed_audio/generate بفرست و تا تکمیل درخواست، status_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"])

مدل‌ها

مقادیر model_id برای Seed Audio

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
seed-audio-1.0Seed Audioبله

گزینه‌ها

پارامترهای Seed Audio

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
duration5, 10, 30, 60, 120

ورودی‌ها

ورودی‌های رسانه‌ای که Seed Audio می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.

قوانین

محدودیت‌هایی که API مدل Seed Audio اعمال می‌کند

  • مرجع تصویری را نمی‌توان همراه مرجع صوتی فرستاد: فقط یکی از این دو نوع را بفرست.
  • پرامپت حداکثر ۲۹۸۶ نویسه می‌تواند باشد.
  • `sample_rate` یکی از این مقادیر است: 8000، 16000، 24000، 32000، 44100، 48000.
  • `speech_rate` یک عدد صحیح از 50- تا 100 است.
  • `loudness_rate` یک عدد صحیح از 50- تا 100 است.
  • `pitch_rate` یک عدد صحیح از 12- تا 12 است.

مدل‌های صوتی بیشتر

سایر APIهای تولید صدا در Mage

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

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

    هزینه API مدل Seed Audio چقدر است؟
    یک درخواست Seed Audio با تنظیمات پیش‌فرض (Seed Audio) ۱۹ Gems هزینه دارد، حدود ۰٫۰۱۹ دلار. رزولوشن، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند و هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد هزینه برمی‌گردد، اما اگر سیاست محتوایی Mage جلوی آن را بگیرد برنمی‌گردد.
    نشانی endpoint مربوط به API مدل Seed Audio چیست؟
    POST https://api.mage.space/v1/seed_audio/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک status_url است که برای گرفتن نتیجه باید آن را پیوسته بررسی کنید.
    کدام مدل‌های Seed Audio را می‌توانم فراخوانی کنم؟
    seed-audio-1.0 (Seed Audio). مدل پیش‌فرض Seed Audio است.
    آیا Seed Audio از تصاویر مرجع یا شخصیت‌ها پشتیبانی می‌کند؟
    Seed Audio مقدار image را می‌پذیرد. Seed Audio مرجع‌های صوتی ذخیره‌شده را با @handle در پرامپت می‌پذیرد.
    آیا می‌توانم Seed Audio را از Claude یا ChatGPT استفاده کنم؟
    بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کن و Seed Audio را با نام بخواه. دستیارت گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
    نتایج Seed Audio تا چه مدت نگه‌داری می‌شوند؟
    نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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