ساخت موسیقی با API (audio/music)

ساخت قطعهٔ موسیقی و آهنگ کوتاه با POST /v1/audio/music: نوشتن سبک و حال‌وهوا، تصویر الهام، انتخاب خودکار مدل، لینک فایل و قیمت تومانی هر قطعه.

به‌روزرسانی: ۱۲ مهر ۱۴۰۵

مسیر POST /v1/audio/music یک قطعهٔ موسیقی می‌سازد و مثل تصویر، هم‌زمان پاسخ می‌دهد: درخواست تا آماده‌شدن قطعه باز می‌ماند (معمولاً کمتر از یک دقیقه). این مسیر در SDK رسمی OpenAI نیست، پس با یک درخواست HTTP ساده صدایش بزن.

curl

curl https://api.uttapen.ir/v1/audio/music \
  -H "Authorization: Bearer sk-up-..." -H "Content-Type: application/json" \
  -d '{"model": "uttapen/auto-music", "prompt": "پیانوی آرام، عصر بارانی، بی‌کلام، حدود یک دقیقه"}'

Python (httpx)

import httpx

r = httpx.post(
    "https://api.uttapen.ir/v1/audio/music",
    headers={"Authorization": "Bearer sk-up-..."},
    json={"model": "uttapen/auto-music", "prompt": "upbeat jingle for a coffee shop ad, 20 seconds"},
    timeout=360,
)
r.raise_for_status()
track = r.json()
print(track["data"][0]["url"], track["uttapen"]["cost_toman"])

فیلدها

فیلد	توضیح
`model`	شناسهٔ مدل یا `uttapen/auto-music`؛ انتخاب خودکار برای درخواست «کوتاه» یا «جینگل» نسخهٔ کوتاه را برمی‌دارد
`prompt`	سبک، ساز، حال‌وهوا، سرعت و مدت تقریبی؛ حداکثر ۴٬۰۰۰ نویسه
`image`	اختیاری: تصویر الهام (آدرس `https` یا `data:image/…;base64`) برای مدل‌هایی که ورودی تصویر دارند
`seed`	عدد ثابت برای تکرارپذیری
`response_format`	`url` (پیش‌فرض) یا `b64_json`

پاسخ

{
  "created": 1791071431,
  "model": "google/lyria-3-pro-preview",
  "data": [{ "url": "https://api.uttapen.ir/v1/files/…/content?exp=…&sig=…", "mime_type": "audio/mpeg", "expires_at": "…" }],
  "uttapen": { "id": "01a1044a-…", "status": "completed", "cost_toman": "…", "hold_toman": "…" }
}

لینک ۲۴ ساعت معتبر است و فایل ۳۰ روز نگه داشته می‌شود؛ لینک تازه با GET /v1/uttapen/media/{id}. اگر ساخت از چند دقیقه بیشتر طول بکشد، 202 با شیء کار برمی‌گردد و نتیجه را بعداً با همان شناسه می‌گیری.

قیمت

قیمت به‌ازای هر قطعه است؛ عدد تقریبی هر مدل در مدل‌های موسیقی آمده. پیش از ساخت مبلغی رزرو و بعد از ساخت فقط هزینهٔ واقعی گزارش‌شده کم می‌شود. اگر پخش قطعه نیمه‌کاره قطع شود یا فایلی نرسد، چیزی کم نمی‌شود. جزئیات در مرور رسانه.

هنوز کلید API نداری؟

با شماره موبایل ثبت‌نام کن، کیف پول را از ۱۰۰٬۰۰۰ تومان شارژ کن و کلید بساز. مدل‌های رایگان بدون شارژ هم کار می‌کنند — تا ۵۰ درخواست در روز. ساخت کلید API ←