معرفی و مستندات مدل هوش مصنوعی music-01

import requests

# Insert your ای آی کار (AI-KAR) key here:
AI-KARapi_key = "<YOUR_AI-KARAPI_KEY>"

# Input data
audio_url = "https://tand-dev.github.io/audio-hosting/spinning-head-271171.mp3"
file_name = "spinning-head-271171.mp3"
purpose = "song"  # Possible values: 'song', 'voice', 'instrumental'

def upload_reference_file():
    """Download file from URL and upload it to AI-KAR API"""
    url = "https://api.ai-kar.com/v2/generate/audio/minimax/upload"
    try:
        # Step 1: Download the file
        response = requests.get(audio_url)
        response.raise_for_status()

        # Step 2: Upload to AI-KAR API
        payload = {"purpose": purpose}
        files = {"file": (file_name, response.content, "audio/mpeg")}
        headers = {"Authorization": f"Bearer {AI-KARapi_key}"}
        upload_response = requests.post(url, headers=headers, files=files, data=payload)
        upload_response.raise_for_status()
        data = upload_response.json()
        print("Upload successful:", data)
        return data  # return JSON with file ids
    except requests.exceptions.RequestException as error:
        print(f"Error during upload: {error}")
        return None

def generate_audio(voice_id=None, instrumental_id=None):
    """Send audio generation request and save result"""
    url = "https://api.ai-kar.com/v2/generate/audio/minimax/generate"
    lyrics = (
        "##Side by side, through thick and thin, \n\n"
        "With a laugh, we always win. \n\n"
        "Storms may come, but we stay true, \n\n"
        "Friends forever—me and you!##"
    )
    payload = {
        "refer_voice": voice_id,
        "refer_instrumental": instrumental_id,
        "lyrics": lyrics,
        "model": "music-01",
    }
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {AI-KARapi_key}",
    }
    response = requests.post(url, headers=headers, json=payload)
    response.raise_for_status()
    audio_hex = response.json()["data"]["audio"]
    decoded_hex = bytes.fromhex(audio_hex)
    out_name = "generated_audio.mp3"
    with open(out_name, "wb") as f:
        f.write(decoded_hex)
    print(f"Generated audio saved as {out_name}")

def main():
    uploaded = upload_reference_file()
    if not uploaded:
        return

    # Extract IDs depending on purpose
    voice_id = uploaded.get("voice_id")
    instrumental_id = uploaded.get("instrumental_id")
    generate_audio(voice_id, instrumental_id)

if __name__ == "__main__":
    main()

{
  "voice_id": "vocal-2025011003141025-d5ZEMxmp",
  "instrumental_id": "instrumental-2025011003141125-Akz9eWnD",
  "base_resp": {
    "status_code": 1,
    "status_msg": "text"
  }
}