导读

想快速调用 Suno V5 的“灵感模式”,用一句话生成 AI 音乐?本篇文章将手把手教你用 php 对接 Suno API v5 的灵感模式,附完整源码,助你一键生成歌词+旋律的创意音乐!

什么是 Suno 灵感模式(Prompt Mode)?

Suno是当前领先的 AI 音乐生成平台,其 V5 版本支持多种模式生成音乐,其中“灵感模式(Prompt Mode)”是一种根据“描述词 + 音乐场景”来生成整首音乐的模式。用户无需准备乐谱或音频,仅通过一段文字提示,即可生成旋律、节奏、歌词乃至歌声。

接口准备

你需要以下准备项:

一个有效的 API令牌:https://suno4.cn/#/api?i=8NCBS8_WXFF

php开发环境

API 调用逻辑

Suno v5 的灵感模式调用流程如下:

  1. 发送 POST 请求到/_open/suno/music/generate
  2. 请求头中携带 x-token进行认证
  3. 请求体中提交 JSON,包括灵感提示(prompt)、模型版本(v5)、音频数量等参数
  4. 解析返回的 task_id 或生成结果

示例源码(灵感模式对接)

php http1代码:

<?php

$request = new HttpRequest();
$request->setUrl('https://xxxxx.com/apiuser/_open/suno/music/generate');
$request->setMethod(HTTP_METH_POST);

$request->setHeaders([
  'x-token' => 'sk-xxxxxxxx',
  'x-userId' => '1000'
]);

$request->setBody('{
   "mvVersion": "chirp-v4-5+",
   "inputType": "10",
   "makeInstrumental": "false",
   "gptDescriptionPrompt": "你不是真正的快乐",
   "callbackUrl": ""
}');

try {
  $response = $request->send();

  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}

php http2代码:

<?php

$client = new http\Client;
$request = new http\Client\Request;

$body = new http\Message\Body;
$body->append('{
   "mvVersion": "chirp-v4-5+",
   "inputType": "10",
   "makeInstrumental": "false",
   "gptDescriptionPrompt": "你不是真正的快乐",
   "callbackUrl": ""
}');

$request->setRequestUrl('https://xxxx.com/apiuser/_open/suno/music/generate');
$request->setRequestMethod('POST');
$request->setBody($body);

$request->setHeaders([
  'x-token' => 'sk-xxxxxxx',
  'x-userId' => '1000'
]);

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();

🕓 补充:查询任务状态

生成音乐是异步任务,可以通过

/_open/suno/music/getState?taskBatchId=1158764664723492865

接口查询自己的作品列表。

🎁 灵感提示词推荐

你可以尝试以下 Prompt:

  1. 一首80年代复古流行歌曲,男女对唱,关于重逢的主题”
  2. 未来感科幻氛围音乐,适合电影开场,电子音效强烈”
  3. 节奏舒缓的钢琴曲,适合冥想和睡眠”
  4. 热血动漫风格的主题曲,主角逆境反击的场景”

提示

  1. 若返回 401 错误,请检查 session token 是否有效。
  2. 如果长时间没有出现在 feed 列表中,说明排队中,可稍后再查。
  3. 使用过程中建议在请求之间加上 time.sleep(1~2) 避免频率过高被限制。

📌 总结

通过本文,你可以:

  1. 通过本文,你可以:
  2. 掌握 Suno API v5 的灵感模式调用方法
  3. 使用 php 快速接入生成音乐
  4. 使用 getState 接口获取生成结果

AI音乐创作已经进入“提示词即音乐”的时代,而你只需要一段 prompt,就可以让灵感跃然耳上!

Logo

火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。

更多推荐