GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
全部教程与指南

· reAPI Team

Mureka api tutorial

reAPI 的 Mureka API 接收歌词和可选风格提示词，先返回任务 ID，完成后返回歌曲链接。本文按文档说明请求字段、状态轮询、文件保存和计费维度。

Mureka api tutorial

在 reAPI 上请求 Mureka API，需要模型 ID mureka-v9-song 和书面歌词 lyrics。 文档规定先返回任务 ID，完成后再返回歌曲链接。每次请求最多生成 3 首歌曲，输出支持 mp3、wav 和 flac。[1]

本文只讲这一套 reAPI 接口，依据 2026 年 10 月 22 日核对的公开文档和实现编写。下方示例没有实际提交生成音频，只用于说明请求构造和结果处理，不代表已经验证生成速度、音乐质量、参考一致性，也不声称这是最新 Mureka 型号。封面是概念插画，不是音频生成结果。

快速要点

  • 要唱的文字放入 lyrics；音乐方向放入可选的 prompt。[1]
  • 从 number_of_songs: 1 开始；文档范围为 1–3，数量影响费用。[1]
  • 提交后保存返回的 id，持续查询这个任务直到结束。[2]
  • 在 completed 后读取 output.audio_urls；需要长期保留时复制到自己的存储。[2]

mureka api key

下方请求发送至 reapi.ai，需要 reAPI API 密钥。在 reAPI 控制台打开 API Keys，创建密钥并在显示时保存，随后通过 Authorization: Bearer ... 发送。认证文档介绍了创建流程与认证错误。[3]

把密钥放在服务器或密钥管理服务中。下方 shell 变量 REAPI_API_KEY 代表这个秘密值，并不是本文提供的密钥。不要把真实密钥放进浏览器端 JavaScript、截图或公开仓库。其他服务的账号或密钥不能代替 reAPI 签发的凭证。

mureka api docs

Mureka V9 Song 接口文档将演唱文字和音乐要求分开。lyrics 必填，最多 3000 个字符；prompt 可选，最多 1024 个字符，可描述曲风、情绪、乐器、人声质感或速度。[1]

例如，把主歌和副歌文字放进 lyrics，把“柔和钢琴流行曲，克制的打击乐”放进 prompt。这是输入示意，不是经过实测的配方。需要演唱的文字不能只写在风格提示词里，否则仍然缺少必填的歌词。

字段文档规定首次请求建议
modelmureka-v9-song使用完整准确的标识符。
lyrics必填；最多 3000 个字符填写自己的歌词。
prompt可选；最多 1024 个字符描述期望的音乐风格。
number_of_songs整数 1–3；默认 1使用 1 请求一首歌。
output_formatmp3、wav、flac；默认 mp3按应用需求选择格式。
reference_id、vocal_id、melody_id可选的已有参考 ID没有有效 ID 时省略。

参考字段接收 ID，不接收本地文件名、音频 URL 或自由文字描述。本文不提供上传端点，也不编造创建这些 ID 的流程。基础的歌词加风格流程可以完全省略它们；只有已经持有对应字段的有效参考 ID 时才添加。存在参考控制项，也不等于已经验证生成歌曲会多大程度遵循参考。[1]

Mureka api tutorial

这是依据文档构造的请求示例，其中的短歌词仅为演示。决定运行前，替换为自己的内容，并在服务器环境设置密钥。提交生成请求可能产生费用。

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-v9-song",
    "lyrics": "Morning light across the floor\nI leave a note beside the door",
    "prompt": "Soft piano pop with restrained percussion",
    "number_of_songs": 1,
    "output_format": "mp3"
  }'

把 POST 返回的 id 和本次参数一起保存，赋值给 TASK_ID，然后使用相同的认证方式查询状态：

curl "https://reapi.ai/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

应用下一步该做什么，由轮询响应决定。[2]

status应用处理方式
processing保持等待；任务 ID 不是已经完成的音频文件。
completed读取 output.audio_urls，把返回的文件提供给用户。
failed读取 error 和 usage.credits，停止等待成功结果。

应用自己的轮询超时，不能证明生成失败。保留任务 ID 以便再次查询，不要自动发起另一笔生成请求。任务文档说明了轮询和错误处理。遇到 HTTP 429 时遵守 Retry-After，不要在紧密循环中立即重复请求。

mureka api pricing

文档规定按生成的歌曲计费。number_of_songs 控制数量；在该型号的文档合同里，prompt、输出格式和可选参考字段不是独立的计价维度。[1] 请在 Mureka V9 Song 模型页按计划请求的歌曲数量查看当前估价。

轮询本身不消耗积分。usage.credits 是任务结算后的整数积分摘要，应结合 status 阅读：processing 时为零不代表免费生成。失败任务可能显示零，也可能保留部分费用，不能认定每次失败都会全额退款。[2] 为另一版本重新发送 POST，是新的生成请求，不是状态查询。

Mureka api download

任务到达 completed 后，按数组处理 output.audio_urls，即使只请求了一首歌。文档规定每首生成歌曲对应一个 URL，格式由本次参数决定。应用支持多首时，不要悄悄只保存第一项。[1]

需要归档时，下载返回的文件并按自己的保留策略存储。任务合同不保证结果 URL 永久保存。[2] 将任务 ID、请求参数、状态和文件存储位置关联起来，方便区分仍在等待的任务与已经完成但尚未复制的歌曲。

首次接入 Mureka API，可以从上方最小请求开始，实现三种任务状态，再检查实际音频是否适合业务流程。模型页提供当前估价，API 文档提供完整字段合同。

相关 API 查询

mureka v9 api

本文覆盖 reAPI 上的 mureka-v9-song。这个标识符限定了示例范围，不代表 V9 是最新 Mureka 版本。

mureka api documentation

文中链接的 reAPI 文档说明了这里的端点与字段。其他接口可能使用不同的认证方式、路径或参数。

mureka api cost

按歌曲数量查看模型页，并通过任务结算了解最终费用。

mureka api platform

示例使用的平台是 reAPI。配置客户端时，应把基础 URL、凭证签发方和请求结构作为一组核对。

参考资料

[1] Mureka V9 Song API. 核对日期：2026 年 10 月 22 日.

[2] 任务. 核对日期：2026 年 10 月 22 日.

[3] 认证. 核对日期：2026 年 10 月 22 日.

全部教程与指南