صدا و موسیقی

ساخت موسیقی

یک کار تولید موسیقی از روی توصیف و متن ترانه می‌سازد. پاسخ ۲۰۲ با شناسه‌ی کار است؛ وضعیت را پیگیری و فایل را بعداً دریافت می‌کنید.

POST/v1/music/generations

تولید موسیقی زمان می‌برد، پس همیشه به صورت کار پس‌زمینه اجرا می‌شود. درخواست بلافاصله با 202 و شیئی با status: queued و شناسه‌ی job_... جواب می‌گیرد. بعد GET /v1/music/generations/{id} را صدا بزنید تا status به completed، failed یا cancelled برسد، و فایل را با /content بردارید.

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

این کارها و فایل‌هایشان در استودیو و گالری حساب شما دیده نمی‌شوند.

نمونه‌ها

curl https://1ai.ir/v1/music/generations \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/lyria-3-clip",
  "prompt": "Short calm santoor melody, instrumental"
}'
202پاسخ
{
  "id": "job_3Kp9xQvT7mYwZc2RnFh8Ad",
  "object": "music",
  "model": "google/lyria-3-clip",
  "status": "queued",
  "progress": 0,
  "created_at": 1793923200,
  "completed_at": null,
  "prompt": "Short calm santoor melody, instrumental",
  "estimated_credits": 1.5,
  "credits": 0,
  "output": null,
  "error": null
}

بدنه‌ی درخواست

  • modelstringالزامی

    شناسه‌ی مدل موسیقی، برای نمونه google/lyria-3-clip.

  • promptstringالزامی

    توصیف سبک و حال‌وهوای قطعه، بین ۱ و ۴٬۰۰۰ نویسه.

  • lyricsstring

    متن ترانه، حداکثر ۳٬۰۰۰ نویسه. اگر نفرستید، مدل خودش تصمیم می‌گیرد.

  • secondsinteger

    مدت قطعه به ثانیه، بین ۱۰ و ۲۴۰. اینکه مدل چه مدت‌هایی بسازد به خود مدل بستگی دارد.

خطاها

  • invalid_request400

    فیلدی نامعتبر یا ناشناخته است؛ بدنه‌ی این مسیر فقط همین چهار فیلد را می‌پذیرد.

  • model_kind_mismatch400

    مدل داده‌شده مدل موسیقی نیست.

  • insufficient_credits402

    اعتبار برای رزرو هزینه کافی نیست.

  • model_not_found404

    مدل وجود ندارد یا کلید شما به آن دسترسی ندارد.

  • no_routable_target400

    مدل فعلاً مسیر قابل استفاده ندارد.

صفحه‌های مرتبط