音乐接口 (Music Generation)

音乐接口提供AI音乐创作能力,支持从文本描述生成原创音乐作品。

接口地址


POST https://aiapi.services/vertex/v1/audio/generations

鉴权方式


Authorization: Bearer YOUR_API_KEY

支持的模型

音乐生成

lyria-002 - Lyria第2代，AI音乐创作和生成模型

完整模型列表请查看可用模型。

请求参数

必需参数

参数	类型	说明
`prompt`	string	音乐描述,包括风格、节奏、乐器、情绪等
`model`	string	模型ID,如 `lyria-002`

可选参数

参数	类型	默认值	说明
`duration`	number	30	音乐时长(秒),范围: 10-120
`temperature`	number	0.7	创作随机性(0-1)
`response_format`	string	`mp3`	音频格式: mp3, wav, flac

代码示例

cURL


curl https://aiapi.services/vertex/v1/audio/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lyria-002",
    "prompt": "舒缓的钢琴爵士乐,慵懒的午后,温暖的阳光",
    "duration": 60
  }'

Python


import requests
 
response = requests.post(
    'https://aiapi.services/vertex/v1/audio/generations',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'model': 'lyria-002',
        'prompt': '舒缓的钢琴爵士乐,慵懒的午后,温暖的阳光',
        'duration': 60
    }
)
 
# 保存音乐文件
with open('music.mp3', 'wb') as f:
    f.write(response.content)
 
print('音乐文件已保存为 music.mp3')

JavaScript


const response = await fetch('https://aiapi.services/vertex/v1/audio/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'lyria-002',
    prompt: '舒缓的钢琴爵士乐,慵懒的午后,温暖的阳光',
    duration: 60
  })
});
 
const audioBlob = await response.blob();
const url = URL.createObjectURL(audioBlob);
 
// 播放音乐
const audio = new Audio(url);
audio.play();

Go


package main
 
import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
  "os"
)
 
func main() {
  url := "https://aiapi.services/vertex/v1/audio/generations"
 
  payload := map[string]interface{}{
    "model": "lyria-002",
    "prompt": "舒缓的钢琴爵士乐,慵懒的午后,温暖的阳光",
    "duration": 60,
  }
 
  jsonData, _ := json.Marshal(payload)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")
 
  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()
 
  // 保存音乐文件
  out, _ := os.Create("music.mp3")
  defer out.Close()
 
  io.Copy(out, resp.Body)
  fmt.Println("音乐文件已保存为 music.mp3")
}

Rust


use reqwest::header::{HeaderMap, HeaderValue, AUTHORIZATION, CONTENT_TYPE};
use serde_json::json;
use std::fs::File;
use std::io::Write;
 
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
 
    let mut headers = HeaderMap::new();
    headers.insert(AUTHORIZATION, HeaderValue::from_static("Bearer YOUR_API_KEY"));
    headers.insert(CONTENT_TYPE, HeaderValue::from_static("application/json"));
 
    let payload = json!({
        "model": "lyria-002",
        "prompt": "舒缓的钢琴爵士乐,慵懒的午后,温暖的阳光",
        "duration": 60
    });
 
    let response = client
        .post("https://aiapi.services/vertex/v1/audio/generations")
        .headers(headers)
        .json(&payload)
        .send()
        .await?;
 
    let audio_data = response.bytes().await?;
 
    // 保存音乐文件
    let mut file = File::create("music.mp3")?;
    file.write_all(&audio_data)?;
 
    println!("音乐文件已保存为 music.mp3");
 
    Ok(())
}

PHP


<?php
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://aiapi.services/vertex/v1/audio/generations");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json"
]);
 
$data = [
    "model" => "lyria-002",
    "prompt" => "舒缓的钢琴爵士乐,慵懒的午后,温暖的阳光",
    "duration" => 60
];
 
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);
 
// 保存音乐文件
file_put_contents('music.mp3', $response);
echo "音乐文件已保存为 music.mp3\n";
?>

Ruby


require 'net/http'
require 'json'
 
uri = URI('https://aiapi.services/vertex/v1/audio/generations')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
 
request.body = {
  model: 'lyria-002',
  prompt: '舒缓的钢琴爵士乐,慵懒的午后,温暖的阳光',
  duration: 60
}.to_json
 
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
 
# 保存音乐文件
File.write('music.mp3', response.body)
puts "音乐文件已保存为 music.mp3"

提示词编写技巧

音乐元素描述


# 完整的提示词应包含:
prompt = """
风格: 爵士乐 (Jazz)
节奏: 中速 (Moderate tempo, 100 BPM)
乐器: 钢琴主奏,低音贝斯,轻柔鼓点
情绪: 放松、温暖、浪漫
场景: 咖啡馆午后,阳光洒进窗户
"""

常见音乐风格

风格	关键词	特点
古典	classical, orchestral, symphony	管弦乐,交响曲
爵士	jazz, swing, bebop	即兴,复杂和声
流行	pop, catchy, upbeat	朗朗上口,节奏明快
电子	electronic, EDM, synthesizer	合成器,舞曲
摇滚	rock, guitar, drums	吉他驱动,强劲节奏
氛围	ambient, atmospheric, calm	环境音乐,舒缓
乡村	country, acoustic, folk	原声吉他,民谣

应用场景

1. 背景音乐生成


def generate_background_music(scene_type, duration=60):
    """为不同场景生成背景音乐"""
 
    scene_prompts = {
        'cafe': '轻柔的爵士钢琴,咖啡馆氛围,放松舒适',
        'gaming': '史诗级管弦乐,激昂磅礴,冒险主题',
        'meditation': '宁静的环境音乐,西藏颂钵,深度冥想',
        'workout': '动感电子音乐,快节奏,充满能量',
        'study': '极简钢琴,专注氛围,白噪音元素'
    }
 
    response = requests.post(
        'https://aiapi.services/vertex/v1/audio/generations',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        json={
            'model': 'lyria-002',
            'prompt': scene_prompts[scene_type],
            'duration': duration
        }
    )
 
    return response.content
 
# 使用示例
cafe_music = generate_background_music('cafe', 120)

2. 视频配乐


async function generateVideoSoundtrack(videoDescription, duration) {
  const musicPrompt = `
    Background music for: ${videoDescription}
    Style: Cinematic orchestral
    Mood: Inspiring and uplifting
    Duration: ${duration} seconds
    No vocals, instrumental only
  `;
 
  const response = await fetch('https://aiapi.services/vertex/v1/audio/generations', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'lyria-002',
      prompt: musicPrompt,
      duration: duration
    })
  });
 
  return await response.blob();
}
 
// 使用示例
const soundtrack = await generateVideoSoundtrack(
  '壮丽的山景延时摄影,日出到日落',
  90
);

最佳实践

1. 明确音乐目标

清晰描述用途和氛围:


# ✅ 详细描述
prompt = """
用途: 产品宣传片背景音乐
风格: 现代流行电子
节奏: 中快速,充满活力
乐器: 合成器,鼓点,贝斯
情绪: 积极向上,充满希望
"""
 
# ❌ 模糊描述
prompt = "好听的音乐"

2. 指定技术参数


const technicalPrompt = `
Genre: Electronic Dance Music (EDM)
BPM: 128
Key: C Major
Instruments: Synthesizer, Kick drum, Hi-hat, Bass
Structure: Intro → Build → Drop → Break → Drop → Outro
Mood: Energetic and uplifting
`;

音乐接口 (Music Generation)

接口地址

鉴权方式

支持的模型

音乐生成

请求参数

必需参数

可选参数

代码示例

cURL

Python

JavaScript

Go

Rust

PHP

Ruby

提示词编写技巧

音乐元素描述

常见音乐风格

应用场景

1. 背景音乐生成

2. 视频配乐

最佳实践

1. 明确音乐目标

2. 指定技术参数

相关资源