docs.emix.ai
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
language
language
  • 🇺🇸 English
  • 🇨🇳 Chinese
Market
File Upload API
Market
File Upload API
  1. Music Generation
  • 开始使用
  • Market
  • Image Models
    • Topaz
      • Topaz 图像优化
    • Seedream
      • Seedream3.0 生成图像
      • Seedream4.0 文生图
      • Seedream4.0 图片编辑
      • Seedream4.5 文生图
      • Seedream4.5 图片编辑
      • Seedream5.0 Lite 文生图
      • Seedream5.0 Lite 图片编辑
      • Seedream5.0 Pro 文生图
      • Seedream5.0 Pro 图片编辑
      • Seedream 5.0 Pro 图层分离
    • Wan
      • Wan 2.7 Image
      • Wan 2.7 Image Pro
    • Google
      • Google Imagen4 Fast
      • Google Imagen4 Ultra
      • Google Imagen4
      • Google Nano Banana
      • Nano Banana Pro 图生图
      • 使用 nano-banana-2 生成内容
      • Nano Banana 2 Lite
    • Z-image
      • 使用 z-image 生成内容
    • Flux-2
      • Flux-2 Pro 图生图
      • Flux-2 Pro 文生图
      • Flux-2 图生图
      • Flux-2 文生图
    • Grok Imagine
      • Grok Imagine 文生图
      • Grok Imagine 图生图
      • Grok Imagine Image 2.0 文生图
      • Grok Imagine Image 2.0 Segment Map
      • Grok Imagine Image 2.0 图片编辑
    • GPT Image
      • GPT Image1.5 文生图
      • GPT Image1.5 图生图
      • GPT Image 2 文生图
      • GPT Image 2 图生图
      • GPT Image 2.5 Sunburst 文生图
      • GPT Image 2.5 Flare 文生图
      • GPT Image 2.5 Sunburst 图生图
      • GPT Image 2.5 Flare 图生图
    • Recraft
      • Recraft 背景移除
      • Recraft 图像优化
    • Ideogram
      • Ideogram V3 图片重构
      • Ideogram 角色编辑
      • Ideogram 角色重混
      • Ideogram 角色图像生成
      • Ideogram V3 文生图
      • Ideogram V3 图像编辑
      • Ideogram V3 混合
    • Qwen
      • Qwen 文生图
      • Qwen 图生图
      • Qwen 图片编辑
      • Qwen2 图片编辑
      • Qwen2 文生图
      • Qwen 2.1 文生图
      • Qwen 2.1 图生图
      • Qwen3 Pro 文生图
      • Qwen3 文生图
      • Qwen3 Pro 图生图
      • Qwen3 图生图
    • 4o Image API
      • 4o Image API 快速开始
      • 4o 图片生成回调
      • 生成4o图像
      • 获取4o图像详情
      • 获取直接下载URL
    • Flux Kontext API
      • Flux Kontext API 快速开始
      • 图像生成或编辑回调
      • 生成或编辑图像
      • 获取图像详情
  • Video Models
    • Omnihuman 1.5
      • OmniHuman 1.5
      • Omnihuman 1.5 主体识别
      • Omnihuman 1.5 主体检测
    • Hailuo
      • Hailuo 2.3 Pro 图生视频
      • Hailuo 2.3 Standard 图生视频
      • Hailuo Pro 文生视频
      • Hailuo Pro 图生视频
      • Hailuo Standard 文生视频
      • Hailuo Standard 图生视频
    • Topaz
      • Topaz视频优化
    • Runway API
      • Runway 图生视频
      • Runway 文生视频
      • Runway 视频扩展
    • Wan
      • Wan 2.6 - 图转视频
      • Wan 2.6 - 文转视频
      • Wan 2.6 - 视频转视频
      • Wan 2.2 A14B Turbo 图生视频
      • Wan 2.2 A14B Turbo 文生视频
      • Wan 2.2 A14B Turbo 语音转视频
      • Wan 动画移动
      • Wan 动画替换
      • Wan 2.5 - 图转视频
      • Wan 2.5 - 文转视频
      • Wan 2.7 - 文转视频
      • Wan 2.7 - 图转视频
      • Wan 2.7 - 视频编辑
      • Wan 2.7 - 参考生视频
      • Wan 3.0 - 生成视频
      • Wan 3.0 - 高速生成视频
    • Bytedance
      • Bytedance Seedance 2.0
      • Bytedance Seedance 2.0 Fast
      • Bytedance Seedance 2.0 Mini
      • Bytedance Seedance 1.5 Pro
      • Bytedance V1 Pro Fast 图生视频
      • Bytedance V1 Pro 图生视频
      • Bytedance V1 Pro 文生视频
      • Bytedance V1 Lite 文生视频
      • Bytedance V1 Lite 图生视频
      • Bytedance Seedance 2.5
    • HappyHorse
      • HappyHorse-文生视频
      • HappyHorse-图生视频
      • HappyHorse-参考生视频
      • HappyHorse-视频编辑
      • HappyHorse 1.1 图生视频
      • HappyHorse 1.1 文生视频
      • HappyHorse 1.1 参考图生成视频
    • Grok Imagine
      • Grok Imagine 文生视频
      • Grok Imagine 图生视频
      • 放大 Grok Imagine 视频
      • 扩展 Grok Imagine 视频
      • Grok Imagine Video 1.5 Preview
    • Kling
      • Kling-2.6 文生视频
      • Kling-2.6 图生视频
      • Kling V2.5 Turbo Pro 图生视频
      • Kling V2.5 Turbo Pro 文生视频
      • Kling AI Avatar Standard
      • Kling AI Avatar Pro
      • Kling V2.1 Master 图生视频
      • Kling V2.1 Master 文生视频
      • Kling V2.1 Pro
      • Kling V2.1 Standard
      • Kling-2.6 motion-control
      • Kling-3.0 motion-control
      • Kling 3.0
      • Kling V3 Turbo 文生视频
      • Kling V3 Turbo 图生视频
      • Kling 3.0 Omni 文生视频
      • Kling 3.0 Omni 图生视频
      • Kling 3.0 Omni Transformation
      • Kling 3.0 Omni Reference-To-Video
    • Veo3.1 API
      • Veo3.1 API 快速开始
      • Veo3.1 视频生成回调
      • 获取 4K 视频回调
      • 生成veo3.1视频
      • VEO 3.1 扩展视频
      • 获取1080P视频
      • 获取4K视频
      • 查询veo3.1视频详情
      • VEO 3.1 文生视频
      • VEO 3.1 图生视频
      • VEO 3.1 参考生视频
    • Gemini Omni
      • Gemini Omni 1.1 Flash
      • Gemini Omni 生视频
      • Gemini Omni Audio 生语音
      • Gemini Omni Character 生角色
    • Volcengine
      • Volcengine 视频对口型
    • PixVerse
      • PixVerse V6 文生视频
      • PixVerse V6 图生视频
      • PixVerse V6 首尾帧/转场
      • PixVerse V6 视频扩展
      • PixVerse V6 Reference-to-video/参考图生成
    • MiniMax-H3
      • MiniMax H3 文生视频
      • MiniMax H3 图生视频
      • MiniMax H3 参考生视频
  • Music Models
    • ElevenLabs
      • ElevenLabs对话文生语音V3
      • ElevenLabs Turbo 2.5文生语音
      • ElevenLabs文生语音 多语言V2
      • ElevenLabs语音转文字
      • ElevenLabs音效V2
      • ElevenLabs音频分离
    • Suno API
      • Music Generation
        • 生成音乐回调
        • 音乐扩展回调
        • 添加伴奏回调
        • 添加人声回调
        • 音乐封面生成回调
        • 替换音乐分区回调
        • 音频上传和扩展回调
        • 音频上传和翻唱回调
        • 生成音乐
          POST
        • 延长音乐
          POST
        • 上传并翻唱音乐
          POST
        • 上传并扩展音乐
          POST
        • 添加伴奏生成音乐
          POST
        • 添加人声生成音乐
          POST
        • 获取带时间戳的歌词
          POST
        • 提升音乐风格
          POST
        • 替换音乐分区
          POST
        • 生成音乐封面
          POST
        • 生成混音音乐
          POST
        • 生成 Persona
          POST
      • Lyrics Generation
        • 生成歌词回调
        • 生成歌词
      • WAV Conversion
        • 转换为WAV格式
      • Vocal Removal
        • 音频分离回调
        • 人声和乐器分离
        • 从音频生成 MIDI
      • Music Video Generation
        • MP4生成完成回调
        • 创建音乐视频
      • Sounds Generation
        • 生成声音
      • voice
        • Suno Voice 生成回调
        • Suno Voice 验证短句回调
        • Suno Voice生成验证短句接口
        • Suno Voice自建音色生成接口
        • Suno Voice 重新生成验证短句
        • Suno Voice检查是否可用接口
    • Gemini
      • Gemini 3.1 Flash文生语音
      • Gemini 2.5 Pro文生语音
  • Chat Models
    • Codex
      • GPT Codex
    • Grok
      • Grok 4.5
      • Grok 4.3
      • Grok 4.6
    • GPT
      • GPT 5.2
      • GPT 5.4 (response)
      • GPT 5.6 Luna
      • GPT 5.6 Terra
      • GPT 5.6 Sol
      • GPT 5.5 (response)
    • Claude
      • Claude Code 对接 emix.ai 使用指南
      • Claude Sonnet 5
      • Claude Opus 5
      • Claude Opus 4.7
      • Claude Opus 4.8
      • Claude Fable 5
      • Claude Sonnet 4.5
      • Claude Haiku 4.5
      • Claude Opus 4.5
      • Claude Opus 4.6
      • Claude Sonnet 4.5
      • Claude Sonnet 4.6
    • Gemini
      • Gemini 3.6 Flash
      • Gemini 3.6 Flash (openai)
      • Gemini 3.7 Flash (openai)
      • Gemini 2.5 Pro (openai)
      • Gemini 3 Pro (openai)
      • Gemini 3.1 Pro (openai)
      • Gemini 2.5 Flash (openai)
      • Gemini 3 Flash (openai)
      • Gemini 3.5 Flash
      • Gemini 3.5 Flash (openai)
      • Gemini 3 Flash
      • Gemini 3.7 Flash
      • Gemini 3.8 Flash
      • Gemini 3.8 Flash (openai)
  • 获取任务详情
    GET
  1. Music Generation

上传并扩展音乐

POST
/api/v1/client/tasks

上传并扩展音乐#

此 API 在保留音频轨道原始样式的同时扩展音频。它包含 Suno 的上传功能,允许用户上传音频文件进行处理。预期结果是生成更长的音轨,并无缝延续输入音频的风格。

参数使用指南#

字符限制
字符限制根据模型版本而异:
模型 V6、V6_WILD 和 V6_MINI:style(最大 1000 字符)、title(最大 100 字符)、lyrics / prompt(最大 5000 字符)
模型 V5_5 和 V5:style(最大 1000 字符)、title(最大 100 字符)、prompt(最大 5000 字符)
模型 V4_5PLUS 和 V4_5:style(最大 1000 字符)、title(最大 100 字符)、prompt(最大 5000 字符)
模型 V4_5ALL:style(最大 1000 字符)、title(最大 80 字符)、prompt(最大 5000 字符)
模型 V4:style(最大 200 字符)、title(最大 80 字符)、prompt(最大 3000 字符)
有源音频(uploadUrl)即可生成;lyrics(原 prompt)、title、style 非必传
始终必填:uploadUrl、model
lyrics 优先于 prompt 作为歌词;未传 lyrics 时,若提供了 prompt 则将 prompt 作为歌词
continueAt 指定从原始音频的哪个时间点开始进行扩展
uploadUrl 用于指定源音频文件。请确保上传的音频长度不超过 8 分钟。

开发者注意事项#

1.
生成的文件将保留 14 天。
2.
模型版本必须与源音乐保持一致。
3.
此功能非常适合通过延长现有音乐来创作更长的作品。
4.
uploadUrl 参数用于指定音频文件的上传位置;请提供有效的 URL。

可选参数#

参数名类型说明
lyricsstring歌词内容。可选。优先于 prompt 作为歌词。V6 最多 5000 字符。
promptstring未传 lyrics 时作为歌词。可选。V6 最多 5000 字符。
stylestring音乐风格。可选。V6 最多 1000 字符。
titlestring曲目标题。可选。最多 100 字符。
continueAtnumber开始延长的时间点(秒)。大于 0 且小于上传音频时长。
varietyinteger生成结果多样性。0–4 的整数,默认 1。0 关 / 1 普通 / 2 高 / 3 额外 / 4 最大。
vocalGenderstring人声性别偏好。m 代表男声,f 代表女声。
styleWeightnumber对风格的遵循强度。范围 0–1,保留两位小数。示例:0.65。
weirdnessConstraintnumber创意/离散程度控制。范围 0–1,保留两位小数。示例:0.65。
audioWeightnumber音频要素权重。范围 0–1,保留两位小数。示例:0.65。
personaIdstring应用到生成音乐的 Persona ID 或 Voice ID。生成 Persona ID 请访问 生成 Persona。

Callbacks

audioExtend

Request

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

Examples

Responses

🟢200
application/json
请求成功
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.emix.ai/api/v1/client/tasks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "suno/upload-and-extend-audio",
    "callBackUrl": "https://api.example.com/callback",
    "input": {
        "uploadUrl": "https://api.example.com/upload",
        "prompt": "用更多舒缓的音符延长音乐",
        "lyrics": "[主歌]\n让旋律继续流淌\n走进一段柔和的过渡\n[副歌]\n钢琴起伏回旋",
        "style": "古典",
        "title": "宁静钢琴延长版",
        "continueAt": 60,
        "instrumental": true,
        "model": "V6",
        "negativeTags": "舒缓钢琴",
        "vocalGender": "m",
        "styleWeight": 0.65,
        "weirdnessConstraint": 0.65,
        "audioWeight": 0.65,
        "variety": 1,
        "personaId": "persona_123",
        "personaModel": "style_persona"
    }
}'
Response Response Example
{
    "msg": "Text generated successfully.",
    "code": 200,
    "data": {
        "data": "[{\"id\":\"231a2348-2d4a-4ad2-a02a-dabd6ce49271\",\"stream_audio_url\":\"https://audiopipe.suno.ai/?item_id=231a2348-2d4a-4ad2-a02a-dabd6ce49271\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/73c347ebdf5740fcb64d7dbafce45751.jpeg\",\"prompt\":\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\",\"model_name\":\"chirp-fenix\",\"title\":\"Summer Vibes Cover\",\"tags\":\"Pop, Electronic, Uplifting\"},{\"id\":\"553a46f1-faea-46a3-b2c1-9865153f7ce1\",\"stream_audio_url\":\"https://audiopipe.suno.ai/?item_id=553a46f1-faea-46a3-b2c1-9865153f7ce1\",\"image_url\":\"https://tempfile.aiquickdraw.com/r/dc4ddc0f467b419ba3d22c0ef3ce7243.jpeg\",\"prompt\":\"Create an uplifting pop cover version of the uploaded audio with modern production, driving beat, and soaring vocal harmonies. Add electronic elements and build energy throughout the track.\",\"model_name\":\"chirp-fenix\",\"title\":\"Summer Vibes Cover\",\"tags\":\"Pop, Electronic, Uplifting\"}]",
        "taskId": "857d1ad2a4c9b7eeef065676e1d945c7",
        "callbackType": "text"
    }
}
Previous
上传并翻唱音乐
Next
添加伴奏生成音乐
Built with