跳到主要内容

创建音乐视频

POST 
https://apibox.erweima.ai/api/v1/mp4/generate

为音乐曲目生成带有可视化效果的MP4视频。

用法指南​

  • 此接口为您的音乐曲目创建MP4视频格式的可视化表示。
  • 需要同时提供 taskId 和 audioId 来识别具体曲目。
  • 可选的 author 和 domainName 参数可用于添加品牌信息。

开发者说明​

  1. 生成的视频文件将保留15天。
  2. 视频包含与音乐同步的视觉效果。
  3. 此功能非常适合社交媒体分享、音乐推广或创建视觉内容。
  4. 视频保持与原始音轨相同的音频质量。

Request​

Bodyrequired

    taskIdstringrequired

    音乐生成任务的任务ID。

    • 必填。用于标识包含待转换为视频的音频的任务。
    • 需要同时提供 taskId 和 audioId 以识别确切的音轨。
    Example: taskId_774b9aa0422f
    audioIdstringrequired

    要转换为视频的具体音轨ID。

    • 必填。用于标识任务中要转换的具体音轨。
    • 需要同时提供 taskId 和 audioId 以识别确切的音轨。
    Example: audioId_0295980ec02e
    callBackUrlurirequired

    接收视频生成完成通知的URL。

    • 必填。
    • 回调将包含生成的MP4视频的单个可下载URL。
    Example: https://api.example.com/callback
    authorstring

    显示在视频上的艺术家或创作者名称。

    • 可选。
    • 将在视频中显著展示，通常在开头。
    • 最长50个字符。

    Possible values: <= 50 characters

    Example: Suno Artist
    domainNamestring

    作为水印显示的网站或品牌。

    • 可选。
    • 将作为微妙的水印出现在视频底部。
    • 最长50个字符。

    Possible values: <= 50 characters

    Example: music.example.com

Responses​

请求成功

Schema
    codeinteger

    状态码说明

    • ✅ 200 - 请求成功
    • ⚠️ 400 - 参数错误
    • ⚠️ 401 - 没有访问权限
    • ⚠️ 404 - 请求方式或者路径错误
    • ⚠️ 405 - 调用超过限制
    • ⚠️ 413 - 主题或者prompt过长
    • ⚠️ 429 - 积分不足
    • ⚠️ 455 - 网站维护
    • ❌ 500 - 服务器异常

    Possible values: [200, 400, 401, 404, 405, 413, 429, 455, 500]

    Example: 200
    msgstring

    当 code != 200 时，展示错误信息

    Example: success
    data object
    taskIdstring

    任务ID，用于后续查询任务状态

    Example: taskId_774b9aa0422f

Callbacks​

POST 
{$request.body#/callBackUrl}

当MP4视频生成完成时，系统会调用此回调通知结果。

回调示例​

{
  "code": 200,
  "msg": "MP4 generated successfully.",
  "data": {
    "task_id": "taskId_774b9aa0422f",
    "video_url": "https://example.com/videos/video_847715e66259.mp4"
  }
}

Body

    codeinteger

    状态码

    Example: 200
    msgstring

    返回消息

    Example: MP4 generated successfully.
    data object
    task_idstring

    任务ID

    video_urlstring

    生成的MP4视频URL

Callbacks Responses​

回调接收成功

Authorization: http

name: BearerAuthtype: httpscheme: bearerbearerFormat: API Keydescription: # 🔑 API 认证说明

所有接口都需要通过 Bearer Token 方式进行认证。

## 获取 API Key

1. 访问 [API Key 管理页面](https://sunoapi.org/api-key) 获取您的 API Key

## 使用方式

在请求头中添加：

```
Authorization: Bearer YOUR_API_KEY
```

> **⚠️ 注意：**
> - 请妥善保管您的 API Key，不要泄露给他人
> - 如果怀疑 API Key 泄露，请立即在管理页面重置
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://apibox.erweima.ai/api/v1/mp4/generate");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent("{\n  \"taskId\": \"taskId_774b9aa0422f\",\n  \"audioId\": \"audioId_0295980ec02e\",\n  \"callBackUrl\": \"https://api.example.com/callback\",\n  \"author\": \"Suno Artist\",\n  \"domainName\": \"music.example.com\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
Request Collapse all
Base URL
https://apibox.erweima.ai
Auth
Body required
{
  "taskId": "taskId_774b9aa0422f",
  "audioId": "audioId_0295980ec02e",
  "callBackUrl": "https://api.example.com/callback",
  "author": "Suno Artist",
  "domainName": "music.example.com"
}
ResponseClear

Click the Send API Request button above and see the response here!