AiFO AiFO مستندات AiFO
قیمت
Input: 0.15 USD · Output: 0 USD · per_music_minute
Context
نامشخص
Endpoint
POST /v1/music/generations

کاربردها

  • تولید موسیقی پس‌زمینه برای ویدئوهای تبلیغاتی
  • ساخت موسیقی برای بازی‌های ویدئویی
  • ایجاد موسیقی بدون کلام برای محیط‌های کاری

نمونه درخواست (Chat Completions)

# Required: model, prompt, music_length_ms
curl https://api.aifoapp.ir/v1/music/generations \
  -H "Authorization: Bearer aifo_sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"music_v2_5","prompt":"یک قطعه موسیقی الکترونیک شاد برای معرفی محصول، پرانرژی و مدرن","music_length_ms":3000,"force_instrumental":false,"output_format":"auto"}' \
  --output music.mp3
import requests

url = "https://api.aifoapp.ir/v1/music/generations"
headers = {
    "Authorization": "Bearer aifo_sk_live_YOUR_API_KEY",
    "Content-Type": "application/json",
}
# Required: model, prompt, music_length_ms
payload = {
  "model": "music_v2_5",
  "prompt": "یک قطعه موسیقی الکترونیک شاد برای معرفی محصول، پرانرژی و مدرن",
  "music_length_ms": 3000,
  "force_instrumental": false,
  "output_format": "auto"
}

response = requests.post(url, headers=headers, json=payload)
with open("music.mp3", "wb") as f:
    f.write(response.content)
# Required: model, prompt, music_length_ms
const response = await fetch("https://api.aifoapp.ir/v1/music/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer aifo_sk_live_YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "music_v2_5",
  "prompt": "یک قطعه موسیقی الکترونیک شاد برای معرفی محصول، پرانرژی و مدرن",
  "music_length_ms": 3000,
  "force_instrumental": false,
  "output_format": "auto"
}),
});

const audio = await response.blob();
import axios from "axios";
import { writeFileSync } from "fs";

# Required: model, prompt, music_length_ms
const { data } = await axios.post(
  "https://api.aifoapp.ir/v1/music/generations",
  {
  "model": "music_v2_5",
  "prompt": "یک قطعه موسیقی الکترونیک شاد برای معرفی محصول، پرانرژی و مدرن",
  "music_length_ms": 3000,
  "force_instrumental": false,
  "output_format": "auto"
},
  {
    headers: { Authorization: "Bearer aifo_sk_live_YOUR_API_KEY" },
    responseType: "arraybuffer",
  },
);
writeFileSync("music.mp3", Buffer.from(data));

پارامترها

Endpoint

POST /v1/music/generations

Inputs

  • Text: via request body fields for this endpoint

Required body fields: model, prompt, music_length_ms

Parameters

Name Type Required/optional Default Notes
music_length_ms number required — —
force_instrumental boolean optional false —
output_format string optional auto —

محدودیت‌ها و نکات

  • حداقل طول موسیقی ۳۰۰۰ میلی‌ثانیه و حداکثر ۶۰۰۰۰۰ میلی‌ثانیه است.
  • قیمت‌گذاری بر اساس دقیقه موسیقی تولید شده است.
  • تنها ورودی متنی پشتیبانی می‌شود.

FAQ

چگونه می‌توانم از API استفاده کنم؟

برای استفاده از API، باید درخواست POST به endpoint مشخص شده ارسال کنید و پارامترهای مورد نیاز را ارائه دهید.

قیمت‌گذاری چگونه است؟

قیمت‌گذاری بر اساس هر دقیقه موسیقی تولید شده است و هزینه ورودی ۰.۱۵ دلار به ازای هر دقیقه است.

آیا می‌توانم موسیقی بدون کلام تولید کنم؟

بله، با تنظیم پارامتر force_instrumental به true می‌توانید موسیقی بدون کلام تولید کنید.

مدل‌های مرتبط