API Docs
  1. Udio文生歌
API Docs
  • 指南
  • 获取 Base URL 和 API Key
  • 通知设置-WebHook参数介绍
  • 配置方式
  • 列出模型
    • Models(列出模型)
      GET
  • 聊天(Chat)
    • 所有对话模型均兼容 OpenAI 格式
    • Realtime (实时语音、对话
    • 聊天完成对象
    • 聊天完成块对象
    • 视觉语言模型介绍
    • Claude 官方格式
      • Messages(官方Anthropic格式)
      • Messages(识图)
      • Messages(思考)
      • Messages(函数调用)
    • GPTs
      • 简介
      • 通过关键词搜索 GPTs
      • 通过ID搜索 GPTs
      • 通过关键词搜索 GPTs V2
      • 通过ID搜索 GPTs V2
    • Chat(聊天)
      POST
    • Chat(流式返回)
      POST
    • Chat(分析图片)
      POST
    • Chat(结构化输出)
      POST
    • Chat(工具tools调用)
      POST
    • Chat(指定GPTs)
      POST
    • Chat(修改图片)
      POST
    • Chat(生成图片)
      POST
    • Chat(分析视频)
      POST
    • Chat(Claude Thinking)
      POST
    • gpt-3.5-turbo-instruct
      POST
  • RAG(嵌入、重排序
    • 嵌入(Embeddings)
      • 嵌入对象
      • 多模态向量嵌入
      • 创建嵌入
    • 重排序(Reranker)
      • 介绍
      • rerank
  • 视频模型
    • 视频生成模型简介
    • pixverse
      • 通用版
        • 接入文档
        • 生成任务
        • 查询任务(免费
        • 创建角色
      • 简单版
        • 接入文档
        • Generate(图生视频
        • Generate(文生视频
        • 获取进度(免费
    • 快手可灵(官方格式)
      • 对接教程
      • Callback协议
      • 绘图、虚拟试穿请看绘图模型-可灵
      • 文生视频
      • 图生视频
      • 视频延长
      • 对口型
      • 视频特效
      • 查询任务(免费
    • Luma 文生视频
      • 官方接口格式
        • 任务查询
          • 查询单个任务(免费
          • 批量获取任务(免费
        • 提交生成视频任务
        • 扩展视频
        • 提交生成视频任务-异步
        • 获取视频无水印链接(VIP版才支持)(废弃,查询接口有返回
      • GoAmzAI格式(兼容版,开发接入请勿对接
        • 生成视频 (兼容版,开发接入请勿对接
        • 获取视频(免费
    • 智谱清影 文生视频
      • 生成(generations)
      • 查询(async-result)(免费
      • 查询(async-result) 批量(免费
    • Runway
      • 官方格式
        • 接入介绍
        • 提交视频生成任务
        • 查询视频任务(免费
      • 简单版(goamz/rocket
        • style 列表
        • generate(文生视频
        • generate(参考图片)
        • 查询视频任务(免费
        • video2video(视频转视频 风格重绘
        • Act-one 表情迁移
    • Viggle 舞蹈合成
      • 介绍
      • Pro 无水印
        • 上传舞蹈视频
        • 创建舞蹈视频任务
        • 上传角色图片
        • 获取任务进度、结果(免费
        • 获取官方舞蹈视频模版-获取tag
        • 获取官方舞蹈视频模版-获取tag下的模版
      • 普通版 有水印
        • 上传舞蹈视频
        • 创建舞蹈视频任务
        • 上传角色图片
        • 获取任务进度、结果
        • 获取官方舞蹈视频模版-获取tag
        • 获取官方舞蹈视频模版-获取tag下的模版
    • Pika
      • 通用版
        • 接入介绍
        • generate (文生视频\图生视频\视频生视频)
        • 获取pika affect列表(免费
        • 查询视频任务(免费
  • 数字人
    • 简介
    • 生成数字人视频
    • 获取任务详情(免费
    • 查询默认 voice 列表(免费
  • 绘图模型
    • 生图模型简介
    • OpenAI Dall-e 格式
      • Flux
      • Recraftv3
      • 生图
      • 图像编辑(gpt-image-1)
    • OpenAI 聊天格式
      • Chat(兼容Flux)
      • Chat(兼容Recraftv3)
      • Chat(兼容Dalle3\Dalle2)
    • Mid journey 文生图
      • Midjourney接入向导
      • 补充 其他参数以及回调
      • 换脸任务提交
        • 提交swap_face任务
      • 任务提交
        • 绘图变化(UPSCALE; VARIATION; REROLL)
        • 执行动作(所有的关联按钮动作UPSCALE; VARIATION; REROLL; ZOOM等)
        • 绘图变化-simple(UPSCALE; VARIATION; REROLL)
        • 提交Blend任务(图生图)
        • 提交Describe任务(图生文)
        • 提交Imagine任务(文生图、文图生图)
        • 提交Modal(提交局部重绘、ZOOM)
        • 提交Shorten任务(prompt分析)
        • 上传图片获得url
      • 任务查询(免费
        • 根据ID列表查询任务(免费
        • 指定ID获取任务(免费
        • 获取任务图片的seed(免费
    • Flux 文生图
      • Openai Dalle3 格式
      • Replicate 格式
      • Openai Chat 格式
    • Ideogram(官方格式
      • Generate 3.0(文生图)
      • Edit 3.0(编辑)
      • Remix 3.0(混合图)
      • Reframe 3.0(重构)
      • Replace Background 3.0(背景替换)
      • ideogram(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
      • Edit(编辑)
    • recraft 官方格式
      • 附录
      • Generate Image(生成图片)
      • Vectorize Image(矢量化图片)
      • Remove Background(删除背景)
      • Clarity Upscale(清晰度提升)
      • Generative Upscale(生成高清)
      • Create style(创建样式)
    • 快手可灵(官方格式)
      • Callback协议
      • 简介
      • 视频、对口型请看视频模型-可灵
      • 虚拟试穿
      • 图像生成
      • 查询任务(免费
    • SeedEdit(图片编辑
      • Dall-e 格式
      • OpenAI 聊天格式
    • Replicate
      • 接入教程
      • 获取任务进度(predictions (免费
      • 创建任务-通过模型version(predictions)
      • 创建任务-通过url路径
      • 创建任务-stability-ai/stable-diffusion
      • 创建任务-stability-ai/sdxl
      • 创建任务-stability-ai/stable-diffusion-inpainting
      • 创建任务-stability-ai/stable-diffusion-img2img
      • 创建任务-lucataco/flux-schnell-lora
      • 创建任务-lucataco/flux-dev-lora
      • 创建任务-andreasjansson/stable-diffusion-animation
      • 创建任务-lucataco/animate-diff
      • 创建任务-sujaykhandekar/object-removal
      • 创建任务-cjwbw/rembg
      • 创建任务-black-forest-labs/flux-1.1-pro
      • 创建任务-black-forest-labs/flux-1.1-pro-ultra
      • 创建任务-black-forest-labs/flux-dev
      • 创建任务-black-forest-labs/flux-pro
      • 创建任务-black-forest-labs/flux-schnell
      • 创建任务-minimax/video-01-live
      • 创建任务-minimax/video-01
      • 创建任务-recraft-ai/recraft-v3
      • 创建任务-recraft-ai/recraft-v3-svg
      • 创建任务-ideogram-ai/ideogram-v2-turbo
    • 豆包智能绘图
      • 能力介绍&计费说明
      • 同步请求例子: SeedEdit
      • 异步请求提交例子: SeedEdit
      • 异步请求查询例子: SeedEdit
      • 即梦3.0
      • 通用2.1-文生图
      • 通用2.0Pro-指令编辑(SeedEdit)
      • 通用2.0Pro-文生图
      • 通用2.0-角色特征保持
      • 通用2.0-文生图
      • 通用2.0Pro-图生图
      • 通用1.4-角色特征保持
      • 通用1.4-文生图
      • 动漫1.3.X-文生图/图生图
      • 通用XL pro-图生图
      • 通用XL pro-文生图
      • AI营销商品图
      • 单图写真(pv版
      • inpainting涂抹消除
      • inpainting涂抹编辑
      • outpainting智能扩图
      • 实时生图-图生图
  • 音频接口
    • Suno文生歌
      • 补充
      • 音乐生成参数介绍
      • 场景一: 灵感模式
      • 场景二: 自定义.歌词歌名
      • 场景三: 纯音乐.自定义
      • 场景四: 纯音乐.灵感模式
      • 场景五: 续写自定义音频
      • 场景六: 续写音乐并获取完整音乐
      • 场景七: Cover 音乐翻版\修改风格
      • 场景八: Replace Section.替换片段
      • 场景九: Persona.歌手风格
      • 场景十: 上传续写
      • 生成歌曲(灵感模式)
      • 生成歌曲(自定义模式)
      • 生成歌曲(续写模式)
      • 生成歌曲(歌手风格)
      • 生成歌曲(上传歌曲二次创作)
      • 生成歌曲(拼接歌曲)
      • 生成歌词
      • 上传请求
      • 报告上传完毕
      • 查询上传处理状态
      • 初始化音频文件
      • Persona:创建歌手风格
      • 查询歌词
      • 查询歌曲
      • 批量获取任务
      • 声曲分离
      • Timing:歌词、音频时间线
      • wav:获取 wav 格式文件
      • mp4:生成 mp4 mv 视频
      • 上传音乐通过 url
      • 生成歌曲 (v1 版本)
      • 拼接歌曲 (v1 版本)
      • 生成歌词 (v1 版本)
      • 查询歌曲 (v1 版本)
      • 查询歌词 (v1 版本)
    • OpenAI(TTS\Wishper
      • 创建语音(tts
      • 创建转录(whisper
      • 创建翻译(whisper
  • 文件上传(Files)
    • README
    • 文件对象
    • 上传文件
  • PPT接口
    • 文多多(官方格式)
      • 介绍
      • 分页查询 PPT 模板(免费
      • 更换 PPT 模板(免费
      • 修改大纲(免费
      • 解析文件内容(免费
      • 生成大纲(免费
      • 生成大纲内容(免费
      • 随机 PPT 模板(免费
      • 获取 PPT 列表(免费
      • 加载 PPT 数据(免费
      • 下载 PPT(免费
      • 更新 PPT 属性(免费
      • 保存 PPT(免费
      • 删除PPT(免费
      • 生成大纲内容同时异步生成PPT(免费
      • 查询异步生成PPT信息(免费
      • ppt转json(免费
      • json转ppt
  • 帮助中心
    • 常见问题及解决办法
  • 平台API
    • 获取用户信息(余额
  • 废弃、未开放
    • Vidu(官方格式)
      • 普通
        • 创建视频(tasks)
        • 高清视频(tasks)
        • 视频状态(state)
        • 视频查询(tasks-get)
    • Udio文生歌
      • 接入流程
      • 根据描述创建音乐
        POST
      • 根据歌词创建音乐
        POST
      • 音乐续写
        POST
      • 获取任务进度(免费
        GET
    • Sora
      • 创建视频
      • 查询视频任务(免费
  1. Udio文生歌

接入流程

计费规则#

一次请求,返回两首歌曲。不同模型价格不同:
使用生成 32 秒音频的模型 udio32-v1.5
使用生成 130 秒音频的模型 udio130-v1.5

基本配置#

Base URL
headers 参数

提交生成音乐任务参数介绍#

基础参数#

参数名类型描述备注
promptstring音乐生成的提示词例如: "pop, happy"
lyricsstring歌词内容支持多段式歌词格式
lyrics_typestring歌词类型可选 "user", "instrumental", "generate"
model_typestring模型类型分为 "udio32-v1.5", "udio130-v1.5"
config.modestring配置模式默认为 "regular"
negative_promptstring负面提示词用于指定不想要的特征

高级参数#

这些参数也必须带上,即便是用默认值

详细说明:#

model_type = "udio130-v1.5" 时,歌曲时长固定位 130 秒;为 "udio32-v1.5" 时,歌曲时长固定位 32 秒。
lyrics_type = user,表示使用用户提供的歌词生成音乐,此时 prompt 的作用类似于 tags,填写风格。
lyrics_type = instrumental,用于创建纯音乐,prompt 用于相关提示词。
lyrics_type = generate 时,表示自动生成歌词,prompt 用于描述需要生成什么样的歌曲。
config.mode = regular,表示生成音乐。
参数名类型描述备注
song_section_startnumber歌曲片段开始位置范围 0-1, 默认 0
song_section_endnumber歌曲片段结束位置范围 0-1, 默认 1
lyrics_placement_startnumber歌词放置开始位置范围 0-1
lyrics_placement_endnumber歌词放置结束位置范围 0-1
prompt_strengthnumber提示词强度范围 0-1,默认 0.5
clarity_strengthnumber清晰度强度范围 0-1,默认 0.25
lyrics_strengthnumber歌词强度范围 0-1,默认 0.5
generation_qualitynumber生成质量可选 0.25, 0.5, 0.75, 1。默认 0.75,数字越大,质量越高,速度越慢。
seednumber随机种子默认 -1 表示随机
bypass_prompt_optimizationboolean是否跳过提示词优化默认为 false

详细说明:#

song_section
用于指定在完整歌曲中生成片段的起始和结束位置。0% (0) 对应歌曲开头,50% (0.5) 对应歌曲中间,100% (1) 对应歌曲结尾。点击数值指示器可切换为自动模式,让模型自行决定最佳位置。这个功能在使用歌曲扩展特性时特别有用。
lyrics_placement
用于指定在完整歌曲中放置歌词的位置。8% 对应歌曲开头,50% 对应歌曲中间,90% 将在歌曲结尾处生成片段。这个功能在使用歌曲扩展特性时特别有用。
prompt_strength
控制提示词对生成内容的影响程度。较高的值可以提高对提示词的遵循度,但可能会导致生成的声音不够自然。
lyrics_strength
控制歌词对生成内容的影响程度。较低的值可能会产生更自然的声音,但可能会忽略部分歌词内容。
clarity_strength
控制模型在生成音频时对清晰度和乐器分离度的优先级。较高的值可能会产生更清晰的音频,但声音可能不够自然。
generation_quality
实验性功能。用于在生成质量和生成速度之间进行权衡。

warning#

以上所有参数都由我抓包分析得来,参数全部转发至 Udio, 没有任何处理。 因此,你也可以自己到 Udio 网站抓包分析。
上一页
视频查询(tasks-get)
下一页
根据描述创建音乐
Built with