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.0 | Seed Audio | بله |
گزینهها
پارامترهای Seed Audio
مقادیر مجاز برای همه نسخهها؛ ممکن است یک نسخه گزینههای کمتری داشته باشد. گزینههای هر نسخه در مستندات آمده است.
| فیلد | مقادیر |
|---|---|
| duration | 5, 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 چقدر است؟
نشانی endpoint مربوط به API مدل Seed Audio چیست؟
کدام مدلهای Seed Audio را میتوانم فراخوانی کنم؟
آیا Seed Audio از تصاویر مرجع یا شخصیتها پشتیبانی میکند؟
آیا میتوانم Seed Audio را از Claude یا ChatGPT استفاده کنم؟
نتایج Seed Audio تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.