KIE.AI
old-model
  • All Model
  • old-model
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Support
old-model
  • All Model
  • old-model
old-model
  • All Model
  • old-model
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
Suno API
4o Image APIVeo3.1 APIRunway APIFlux Kontext API
  1. Music Generation
  • Suno API 快速开始
  • Music Generation
    • 音乐封面生成回调
    • 生成音乐回调
    • 音乐扩展回调
    • 音频上传和翻唱回调
    • 音频上传和扩展回调
    • 添加伴奏回调
    • 添加人声回调
    • 替换音乐分区回调
    • 生成音乐
      POST
    • 延长音乐
      POST
    • 上传并翻唱音乐
      POST
    • 上传并扩展音乐
      POST
    • 添加伴奏生成音乐
      POST
    • 添加人声生成音乐
      POST
    • 获取音乐任务详情
      GET
    • 获取带时间戳的歌词
      POST
    • 提升音乐风格
      POST
    • 替换音乐分区
      POST
    • 生成音乐封面
      POST
    • 获取音乐封面生成详情
      GET
    • 生成 Persona
      POST
    • 生成混音音乐
      POST
    • 恢复音频
      POST
  • Lyrics Generation
    • 生成歌词回调
    • 生成歌词
      POST
    • 获取歌词任务详情
      GET
  • WAV Conversion
    • 转换为WAV格式回调
    • 转换为WAV格式
    • 获取WAV转换详情
  • Vocal Removal
    • 音频分离回调
    • MIDI 生成回调
    • 人声和乐器分离
    • 获取人声和乐器分离详情
    • 从音频生成 MIDI
    • 获取 MIDI 生成详情
  • Music Video Generation
    • MP4生成完成回调
    • 创建音乐视频
    • 获取音乐视频详情
  • Sounds Generation
    • 生成声音
  • voice
    • Suno Voice 生成回调
    • Suno Voice 验证短句回调
    • Suno Voice生成验证短句接口
    • Suno Voice获取验证短句接口
    • Suno Voice自建音色生成接口
    • Suno Voice获取自建音色记录
    • Suno Voice 重新生成验证短句
    • Suno Voice检查是否可用接口
  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
请求成功
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/api/v1/generate/record-info?taskId=5c79****be8e' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "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",
                    "audio_url": "https://example.cn/****.mp3",
                    "source_audio_url": "",
                    "stream_audio_url": "https://example.cn/****",
                    "source_stream_audio_url": "https://example.cn/****",
                    "image_url": "https://example.cn/****.jpeg",
                    "source_image_url": "https://example.cn/****.jpeg",
                    "prompt": "[Verse] 夜晚城市 灯火辉煌",
                    "model_name": "chirp-v3-5",
                    "title": "钢铁侠",
                    "tags": "electrifying, rock",
                    "createTime": "2025-01-01 00:00:00",
                    "duration": 198.44
                }
            ]
        },
        "status": "SUCCESS",
        "type": "GENERATE",
        "operationType": "generate",
        "errorCode": null,
        "errorMessage": null
    }
}
Previous
添加人声生成音乐
Next
获取带时间戳的歌词
Built with