KIE.AI
Chinese
  • English
  • Chinese
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation
  • Suno API 快速开始
  • Music Generation
    • 生成音乐回调
    • 音乐扩展回调
    • 音频上传和翻唱回调
    • 音频上传和扩展回调
    • 添加伴奏回调
    • 添加人声回调
    • 音乐封面生成回调
    • 替换音乐分区回调
    • 生成音乐
      POST
    • 延长音乐
      POST
    • 上传并翻唱音乐
      POST
    • 上传并扩展音乐
      POST
    • 添加伴奏生成音乐
      POST
    • 添加人声生成音乐
      POST
    • 获取音乐任务详情
      GET
    • 获取带时间戳的歌词
      POST
    • 提升音乐风格
      POST
    • 替换音乐分区
      POST
    • 生成音乐封面
      POST
    • 获取音乐封面生成详情
      GET
    • 生成 Persona
      POST
  • Lyrics Generation
    • 生成歌词回调
    • 生成歌词
      POST
    • 获取歌词任务详情
      GET
  • WAV Conversion
    • 转换为WAV格式回调
    • 转换为WAV格式
      POST
    • 获取WAV转换详情
      GET
  • Vocal Removal
    • 音频分离回调
    • MIDI 生成回调
    • 从音频生成 MIDI
    • 获取 MIDI 生成详情
    • 人声和乐器分离
    • 获取人声和乐器分离详情
  • Music Video Generation
    • MP4生成完成回调
    • 创建音乐视频
    • 获取音乐视频详情
Chinese
  • English
  • Chinese
Support
Chinese
  • English
  • Chinese
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 APISuno API
4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Music Generation

获取音乐任务详情

GET
/api/v1/generate/record-info
获取音乐生成任务的详细信息。

使用指南#

使用此接口检查任务状态并访问生成结果
任务详情包括状态、参数和生成的曲目
生成的曲目可通过返回的URL访问

状态说明#

PENDING: 任务等待处理中
TEXT_SUCCESS: 歌词/文本生成成功
FIRST_SUCCESS: 第一个音轨生成完成
SUCCESS: 所有音轨生成成功
CREATE_TASK_FAILED: 创建任务失败
GENERATE_AUDIO_FAILED: 音频生成失败
CALLBACK_EXCEPTION: 回调过程中出错
SENSITIVE_WORD_ERROR: 内容因敏感词被过滤

开发者注意事项#

对于纯音乐曲目(instrumental=true),响应中不会包含歌词数据
最大查询频率:每个任务每秒最多3次请求
响应包括音频文件、图片和流式端点的直接URL

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Responses

🟢200
application/json
请求成功
Body

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kie.ai/api/v1/generate/record-info?taskId=5c79****be8e' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - 成功示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "5c79****be8e",
        "parentMusicId": "",
        "param": "{\"prompt\":\"A calm piano track\",\"style\":\"Classical\",\"title\":\"Peaceful Piano\",\"customMode\":true,\"instrumental\":true,\"model\":\"V3_5\"}",
        "response": {
            "taskId": "5c79****be8e",
            "sunoData": [
                {
                    "id": "e231****-****-****-****-****8cadc7dc",
                    "audioUrl": "https://example.cn/****.mp3",
                    "streamAudioUrl": "https://example.cn/****",
                    "imageUrl": "https://example.cn/****.jpeg",
                    "prompt": "[Verse] 夜晚城市 灯火辉煌",
                    "modelName": "chirp-v3-5",
                    "title": "钢铁侠",
                    "tags": "electrifying, rock",
                    "createTime": "2025-01-01 00:00:00",
                    "duration": 198.44
                }
            ]
        },
        "status": "SUCCESS",
        "type": "GENERATE",
        "errorCode": null,
        "errorMessage": null
    }
}
Previous
添加人声生成音乐
Next
获取带时间戳的歌词
Built with