教父音乐 API 服务迁移通知
旧版 API 将迁移至新版开发者平台，请于 2026年10月12日前完成迁移。迁移期间，现有 API Key 和接口仍可正常使用。
🎵 教父音乐 API
🔑 你的 API Key
hh_****************（登录后查看）
登录查看 Key
💰 API 计价表
| 接口 | 费用 |
|---|---|
| 生成歌曲 | 1 次 |
| 本人声音生成歌曲 | 1 次 |
| AI 生成歌词 | 0.1 次/次 |
| 录制本人声音 | 0.2 次/次 |
| 声音验证、验证录音、生成前检查 | 0 次（免费） |
| WAV 导出 | 0.1 次/首 |
| 分轨 | 1～6 次，按轨道数和输出格式计费；首次体验或 SVIP 免费额度内为 0 次 |
| 查询、下载、歌曲管理 | 0 次（免费） |
⚡ 快速开始
所有请求都要在 Header 携带 API Key，POST/PUT 用 JSON：
# 公共请求头
Authorization: Bearer hh_你的Key
Content-Type: application/json # POST / PUT 必带
Base URL：https://ai6666.com ，所有音乐端点前缀 /ai6api/music/
三步生成一首歌（描述模式最简调用，每次消耗 1 次 创作次数、产出 2 首 歌）：
# 1) 提交生成，拿到 generation_id
curl -X POST https://ai6666.com/ai6api/music/generate \
-H "Authorization: Bearer hh_你的Key" \
-H "Content-Type: application/json" \
-d '{"prompt": "写一首关于夏天海边的流行歌", "title": "夏日海风"}'
# 2) 轮询进度（间隔 ≥ 3 秒），直到 status=success
curl https://ai6666.com/ai6api/music/generation/{generation_id}/status \
-H "Authorization: Bearer hh_你的Key"
# 可选：第一首完成就返回 songs[]，仍要继续轮询第二首
curl "https://ai6666.com/ai6api/music/generation/{generation_id}/status?include_partial=true" \
-H "Authorization: Bearer hh_你的Key"
# 3) success 后，响应里的 songs[] 即含 playable_url / lyrics
📖 教父音乐 API 文档
点击每个分组展开。请求示例可直接替换 Key 后运行；每个接口的创作次数消耗已直接标注在接口说明中。
🎼 生成歌曲（描述 / 专业模式）›
POST/ai6api/music/generate
提交一次音乐生成，异步返回
generation_id。每次消耗 1 次创作次数、产出 2 首 歌曲；需轮询「查询生成进度」获取成品。① 描述模式（默认）
custom_mode=false 且 is_free_mode=false。prompt 传描述（≤ 3000 字）。curl -X POST https://ai6666.com/ai6api/music/generate \
-H "Authorization: Bearer hh_你的Key" \
-H "Content-Type: application/json" \
-d '{
"prompt": "失恋后深夜一个人走在街上，想起再也回不去的人",
"title": "深夜街角", // 选填
"lang": "中文",
"style": "emotional pop ballad, soft piano" // 选填
}'
② 专业模式
custom_mode=true。prompt 传完整歌词（≤ 5000 字），配 style。curl -X POST https://ai6666.com/ai6api/music/generate \
-H "Authorization: Bearer hh_你的Key" \
-H "Content-Type: application/json" \
-d '{
"custom_mode": true,
"prompt": "[Verse]\n月光下思念如潮\n你的身影在脑海\n[Chorus]\n想你想到天亮\n心在你身旁",
"title": "月光思念",
"style": "Pop ballad, emotional vocal, warm arrangement, polished mix",
"lang": "中文",
"boost_vocal": true
}'
公共参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt | string | 必填 | 核心输入。描述模式 = 创作描述（≤ 3000 字）；专业模式 = 完整歌词（≤ 5000 字）。 |
custom_mode | bool | 选填 | 默认 false。true = 专业模式（自写歌词）。 |
is_free_mode | bool | 兼容 | 历史兼容字段。true（或 mode:"free"）仍可调用，但官网已不再展示自由模式；新调用请使用默认描述模式。 |
style | string | 选填 | 曲风英文描述（≤ 1000 字）。留空自动建议；描述模式和专业模式均可使用。 |
title | string | 选填 | 歌名（≤ 200 字）。留空由平台自动生成。 |
lang | string | 选填 | 演唱语言，默认 中文。可选：中文 English 日本語 한국어 Español Русский 粤语。 |
model | int | 选填 | 0 教父音乐；1 suno V6 Pro；2 suno V6 Wild；3 suno V6 Mini；4 makebestmusic。 |
instrumental | bool | 选填 | 默认 false。true = 纯音乐（无人声），跳过歌词处理。 |
shorten_intro | bool | 选填 | 默认 false。true = 缩短前奏（剥掉歌词开头的 Intro 段）。 |
boost_vocal | bool | 选填 | 默认 false。true = 人声更突出（混音时人声靠前）。 |
platform_model | string | 兼容 | 旧版兼容字段，新调用无需传。 |
返回
{
"generation_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "pending", // 后续轮询会变为 generating → success / failed
"credits_remaining": 23 // 扣费后剩余次数
}
错误码（均为 HTTP 400，除注明外）
| code | 含义 |
|---|---|
empty_prompt | prompt 为空 |
prompt_too_long | 描述超 3000 字（描述模式） |
lyrics_too_long | 歌词超 5000 字（专业模式） |
moderation_blocked | 歌词 / 描述未通过内容审核 |
no_credits | 创作次数不足，需先购买套餐 |
generation_paused | 生成服务维护中（HTTP 503） |
| — | 生成过于频繁：60 秒内超 30 次（HTTP 429） |
⏳ 查询生成进度›
GET/ai6api/music/generation/{generation_id}/status
轮询生成进度。消耗 0 次同一任务轮询间隔需 ≥ 3 秒，过快返回
429 + retry_after（秒）。默认保持旧行为：status=success 后 songs[] 才含播放地址与歌词。传 include_partial=true 后，stage=first_success 时即返回已完成的第一首，此时任务尚未终止，调用方仍需继续轮询到 success 或失败终态。{
"status": "success", // pending|submitted|generating|success|failed|rejected
"stage": "success",
"percent": 100,
"label": "🎉 创作完成！",
"error_msg": "",
"songs": [
{
"id": "...uuid...",
"title": "星光之城",
"tags": "流行,城市,梦幻",
"duration": 195.5,
"playable_url": "https://.../song.mp3",
"image_url": "https://.../cover.jpg",
"lyrics": "[Verse 1]\n走在夜晚的街角...",
"is_archived": true
}
// 共 2 首
]
}
轮询建议：
generating 时每 3–5 秒查一次；success / failed / rejected 为终态即停。开启 include_partial 后，第一首会始终保持在 songs[0]，第二首完成后追加到数组。失败时 credits_remaining 会回填（多数失败已退次数）。🎤 用自己的声音唱歌›
费用：录制本人声音每次扣 0.2 次；声音验证、验证录音和生成前检查均为 0 次（免费）；使用本人声音生成歌曲每次扣 1 次创作次数。账号必须先完成手机号验证和实名认证；接口只接受当前 API Key 所属账号自己的声音。
推荐流程：上传声音 →（可选）提交说话声纹验证 → preflight → 自动验证或提交朗读录音 → voice-generate。下面的
voice_id 和 verification_id 都替换成上一步返回的 UUID。
GET/ai6api/music/voices
列出当前账号已录制的声音。消耗 0 次返回的
id 用于后续生成，audio_url 是 10 分钟有效的私有试听地址。curl https://ai6666.com/ai6api/music/voices \
-H "Authorization: Bearer hh_你的Key"
# 返回
{ "voices": [{ "id": "...uuid...", "name": "我的声音", "speech_verified": true }],
"can_record": true, "record_cost": 0.2 }
POST/ai6api/music/voices
上传本人录音并创建声音。消耗 0.2 次使用
multipart/form-data，字段：file（MP3/音频，≤15MB）、duration（1–30 秒）、consent=1、name（选填）。curl -X POST https://ai6666.com/ai6api/music/voices \
-H "Authorization: Bearer hh_你的Key" \
-F "file=@/path/to/my-voice.mp3" \
-F "duration=12.5" \
-F "consent=1" \
-F "name=我的声音"
# 返回（记下 voice.id）
{ "ok": true,
"voice": { "id": "voice-uuid", "name": "我的声音", "speech_verified": false },
"verify_phrase": "请朗读这句话……",
"requires_speech_verification": true }
POST/ai6api/music/voices/{voice_id}/speech-verification
提交固定短语录音，建立可供自动验证使用的说话声纹。消耗 0 次（免费）字段名可用
audio 或 file，duration 为 1–15 秒。curl -X POST https://ai6666.com/ai6api/music/voices/{voice_id}/speech-verification \
-H "Authorization: Bearer hh_你的Key" \
-F "audio=@/path/to/reading.mp3" \
-F "duration=8"
# 验证成功
{ "ok": true, "verified": true, "speech_verified": true }
GET/ai6api/music/voices/{voice_id}/audio
下载/试听自己的声音。消耗 0 次请直接使用
GET /voices 返回的 audio_url，签名地址有效 10 分钟，URL 自带 token。curl -L "复制 voices 返回的 audio_url" \
-o my-voice-preview.mp3
POST/ai6api/music/voices/{voice_id}/rename
重命名自己的声音。消耗 0 次body：
{"name":"我的女声"}。curl -X POST https://ai6666.com/ai6api/music/voices/{voice_id}/rename \
-H "Authorization: Bearer hh_你的Key" \
-H "Content-Type: application/json" \
-d '{"name":"我的女声"}'
# 返回
{ "ok": true, "name": "我的女声" }
DELETE/ai6api/music/voices/{voice_id}
软删除自己的声音（不会物理删除原始文件）。消耗 0 次
curl -X DELETE https://ai6666.com/ai6api/music/voices/{voice_id} \
-H "Authorization: Bearer hh_你的Key"
# 返回
{ "ok": true }
POST/ai6api/music/voices/{voice_id}/preflight
生成前检查声音是否可用。消耗 0 次（免费）返回
status=ready 可直接生成；如果返回验证任务，则按 verification_id 轮询，并在需要时提交朗读录音。curl -X POST https://ai6666.com/ai6api/music/voices/{voice_id}/preflight \
-H "Authorization: Bearer hh_你的Key" -H "Content-Type: application/json"
# 可直接生成
{ "status": "ready", "usable": true, "voice_id": "...uuid..." }
# 需要朗读验证时
{ "status": "record_required", "verification_id": "verification-uuid",
"phrase": "请朗读这句话……", "requires_recording": true }
GET/ai6api/music/voice-verifications/{verification_id}
轮询声音验证状态。消耗 0 次（免费）
usable=true 后才可调用生成；验证录音提交接口为 POST /ai6api/music/voice-verifications/{verification_id}/recording，提交验证录音同样不扣次数，multipart 字段为 file 和 duration（1–15 秒）。curl https://ai6666.com/ai6api/music/voice-verifications/{verification_id} \
-H "Authorization: Bearer hh_你的Key"
# 已通过
{ "verification_id": "verification-uuid", "status": "passed",
"usable": true, "requires_recording": false }
POST/ai6api/music/voice-verifications/{verification_id}/auto
已有
speech_verified=true 时，用已保存的说话声纹自动完成朗读验证。消耗 0 次（免费）没有可用说话声纹时返回 status=need_manual，改走下面的 recording 接口。curl -X POST https://ai6666.com/ai6api/music/voice-verifications/{verification_id}/auto \
-H "Authorization: Bearer hh_你的Key"
# 返回 202，之后继续 GET verification 轮询
{ "status": "processing", "usable": false }
POST/ai6api/music/voice-verifications/{verification_id}/recording
没有可用说话声纹时，提交验证任务要求的朗读录音。消耗 0 次（免费）使用
multipart/form-data，字段：file、duration（1–15 秒）。curl -X POST https://ai6666.com/ai6api/music/voice-verifications/{verification_id}/recording \
-H "Authorization: Bearer hh_你的Key" \
-F "file=@/path/to/phrase-reading.mp3" \
-F "duration=6"
# 返回 202，之后继续 GET verification 轮询
{ "status": "processing", "usable": false }
POST/ai6api/music/voice-generate
使用已验证的本人声音生成歌曲。消耗 1 次默认是描述模式：AI 写词并用你的声音演唱；传
custom_mode=true 时，prompt 改为完整歌词。curl -X POST https://ai6666.com/ai6api/music/voice-generate \
-H "Authorization: Bearer hh_你的Key" \
-H "Content-Type: application/json" \
-d '{
"voice_id": "你的声音 UUID",
"prompt": "写一首关于夏夜海风的中文流行歌",
"custom_mode": false,
"style": "warm pop ballad"
}'
# 返回
{ "ok": true, "generation_id": "...uuid...",
"status": "pending", "credits_remaining": 23 }
生成完成仍使用「查询生成进度」接口。声音验证失效时返回
409 voice_verification_required，请重新执行 preflight；次数不足返回 402 no_credits。✍️ AI 作词（配合专业模式）›
POST/ai6api/music/generate-lyrics
用平台 AI 根据主题写歌词，异步返回
task_id。消耗 0.1 次拿到歌词后可丢进专业模式（custom_mode=true）生成。| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
theme | string | 必填 | 主题 / 想写什么（≤ 700 字）。 |
style | string | 选填 | 风格倾向（≤ 200 字）。 |
lang | string | 选填 | 语言，默认 中文。 |
curl -X POST https://ai6666.com/ai6api/music/generate-lyrics \
-H "Authorization: Bearer hh_你的Key" -H "Content-Type: application/json" \
-d '{"theme": "写给十年后的自己", "style": "民谣", "lang": "中文"}'
# 返回
{ "task_id": "...uuid...", "status": "pending" }
GET/ai6api/music/generate-lyrics/{task_id}/status
轮询作词进度。消耗 0 次
done 时返回 lyrics。{ "status": "done", "lyrics": "走过年少轻狂的路口..." }
// status: pending | generating | done | failed（failed 时带 error）
🎧 歌曲管理›
GET/ai6api/music/my-songs
我的歌曲库，分页。消耗 0 次查询参数：
tab=mine|favorites（默认 mine）、page（默认 1）、page_size（默认 20，上限 50）、q（按歌名搜索）。curl "https://ai6666.com/ai6api/music/my-songs?page=1&page_size=20" \
-H "Authorization: Bearer hh_你的Key"
# 返回
{ "songs": [ ... ], "total": 42, "page": 1,
"page_size": 20, "tab": "mine", "favorite_count": 7 }
GET/ai6api/music/song/{song_id}
歌曲详情。消耗 0 次公开歌任何人可看，私有歌仅作者本人。含播放地址、歌词、LRC 时间轴、评分、打赏、分轨与 WAV 状态。
{
"id": "...uuid...", "title": "星光之城", "tags": "流行,城市",
"lyrics": "...", "lrc_lines": [ ... ], "duration": 195.5,
"playable_url": "https://.../song.mp3", "image_url": "https://.../cover.jpg",
"is_public": true, "avg_rating": 4.8, "rating_count": 12,
"tip_total": 30, "play_count": 318, "is_owner": true,
"author": { "id": 42, "nickname": "...", "avatar": "..." },
"wav_status": "success", "wav_url": "...", "wav_ready": true,
"stem_basic": { ... }, "stem_pro": { ... } // 分轨槽位，仅作者可见
}
GET/ai6api/music/song/{song_id}/download-mp3
获取 MP3 临时下载地址（仅作者）。消耗 0 次有每日下载次数上限。
{ "ready": true, "url": "https://.../song.mp3?sign=...",
"expires_in": 600, "filename": "夏日海风.mp3" }
// 还在准备中：409 { "ready": false, "error": "MP3 正在准备中，请稍等" }
POST/ai6api/music/song/{song_id}/export-wav
导出无损 WAV（仅作者）。消耗 0.1 次/首账户需至少剩 0.1 次创作次数。提交后异步转换，轮询「查询 WAV 状态」取下载地址。WAV 文件保留 7 天，请及时下载。
curl -X POST https://ai6666.com/ai6api/music/song/{song_id}/export-wav \
-H "Authorization: Bearer hh_xxx"
// → { "wav_status": "generating", "credits": 123,
// "message": "WAV 转换已开始…本次扣 0.1 次创作次数，文件保留 7 天，请及时下载" }
// 创作次数不足：402 { "error": "创作次数不足，无法导出 WAV（每首 WAV 约 0.1 次创作次数）", "insufficient": true }
GET/ai6api/music/song/{song_id}/wav-status
轮询 WAV 导出状态（仅作者）。消耗 0 次success 时
wav_url 为可直接下载的临时地址（保留 7 天）。{ "wav_status": "success", "wav_ready": true,
"wav_url": "https://.../song.wav?sign=...", "wav_error": "" }
// 转换中：{ "wav_status": "generating", "wav_ready": false, "wav_url": "" }
POST/ai6api/music/song/{song_id}/rename
重命名歌曲（仅作者）。消耗 0 次body: {title}（≤200 字）→ {ok, title}
POST/ai6api/music/song/{song_id}/delete
软删除歌曲（仅作者，可恢复）。消耗 0 次→ {ok}
POST/ai6api/music/song/{song_id}/favorite
收藏 / 取消收藏（切换）。消耗 0 次→ {ok, user_favorited, favorite_count}
GET/ai6api/music/song/{song_id}/download-cover
获取封面临时下载地址（仅作者）。消耗 0 次→ {ready, url, expires_in, filename}
GET/ai6api/music/song/{song_id}/download-lrc
下载歌词文本（LRC）。消耗 0 次
POST/ai6api/music/song/{song_id}/copyright
生成商业授权 PDF（仅作者，3 次/天）。消耗 0 次body: {name, company?, song_title?} → {ready, url, expires_in, filename}
GET/ai6api/music/song/{song_id}/remake-preset
做同款 — 取原歌生成参数（风格/歌词/语言）用于预填重做。消耗 0 次→ {ok, preset, source_song}
🎚 GPU 分轨工作台（stem-lab）›
GET/ai6api/music/stem-lab/options
取分轨选项与费用矩阵。消耗 0 次→ {cost_matrix:{2stem:{mp3:1,wav:2}, 4stem:{mp3:2,wav:4}, 6stem:{mp3:4,wav:6}}, is_svip, svip_free_remaining, first_free_available, credits, modes}
GET/ai6api/music/stem-lab/songs
取可分轨的平台歌曲列表（自己已归档音频，最多 100 首）。消耗 0 次→ {songs:[{id,title,source_kind,format,duration,created_at}]}
POST/ai6api/music/stem-lab/submit
提交分轨 — 按模式和格式消耗：2stem/伴奏 MP3 1 次、WAV 2 次；4stem MP3 2 次、WAV 4 次；6stem MP3 4 次、WAV 6 次。首次体验或 SVIP 当月免费额度内为 0 次。body: {song_id, mode:"2stem"|"4stem"|"6stem"|"inst", output_format:"mp3"|"wav"} → {job_id, status, credits_used, is_free}
GET/ai6api/music/stem-lab/jobs/{job_id}/status
轮询分轨进度。消耗 0 次done 时 outputs[] 含各轨 play_url / download_urls(mp3/wav)，及 archive_download_urls
GET/ai6api/music/stem-lab/jobs/{job_id}/output/{stem}
流式下载/试听单轨。消耗 0 次参数 fmt=mp3|wav（WAV 需满足对应下载权限）
GET/ai6api/music/stem-lab/jobs/{job_id}/archive
下载全部分轨打包 zip。消耗 0 次参数 fmt=mp3|wav
💿 无损 WAV 与分轨›
POST/ai6api/music/song/{song_id}/export-wav
导出无损 WAV（异步）。消耗 0.1 次/首需账号满足 WAV 导出权限。
{ "wav_status": "generating", "cost_nothing": 0 // 历史兼容字段，不代表 API WAV 实际扣费,
"message": "WAV 转换已开始，通常 30-90 秒内完成" }
GET/ai6api/music/song/{song_id}/wav-status
轮询 WAV 进度（间隔 ≥ 3 秒）。消耗 0 次完成后
wav_url 为临时签名地址（有效约 5 分钟）。{ "wav_status": "success", "wav_ready": true,
"wav_url": "https://.../song.wav?sign=...", "wav_error": "" }
POST/ai6api/music/song/{song_id}/stem
歌曲分轨（异步，仅作者）。
body: {type}：separate_vocal = 人声 + 伴奏分离（消耗 2 次）；split_stem = 多轨拆分（消耗 10 次）。返回 sep_id。curl -X POST https://ai6666.com/ai6api/music/song/{song_id}/stem \
-H "Authorization: Bearer hh_你的Key" -H "Content-Type: application/json" \
-d '{"type": "separate_vocal"}'
# 返回
{ "ok": true, "sep_id": "...uuid...", "type": "separate_vocal" }
# 若已分过轨：409 { ok:false, already_done:true, sep_id, stems, credits_cost }
# 想重分：再带 {"type":"...","confirm_redo":true}
GET/ai6api/music/stem/{sep_id}/status
轮询分轨进度（间隔 ≥ 3 秒）。消耗 0 次完成后
stems 为各轨地址、zip_ready 表示打包是否就绪。{ "status": "done", "type": "separate_vocal",
"stems": { "vocal": "...", "accompaniment": "..." }, "zip_ready": true }
// status: pending | processing | done | failed
GET/ai6api/music/stem/{sep_id}/zip-url
分轨打包 zip 的临时下载地址。消耗 0 次
{ "ready": true, "url": "https://.../分轨.zip?sign=...",
"expires_in": 600, "filename": "星光之城_分轨.zip" }
// 尚未就绪：{ "ready": false, "status": "packaging" }
💳 次数与套餐›
GET/ai6api/music/credits
查询剩余创作次数。消耗 0 次返回
{credits}。
GET/ai6api/music/packages
套餐列表（公开）。消耗 0 次每项含
code / name / price_cents / credits / expire_days / is_new_user_only / description。[ { "code": "create", "name": "创作套餐", "price_cents": 3500,
"credits": 25, "expire_days": 365, "is_new_user_only": false } ]
// price_cents 为分；企业套餐金额自定义、仅 web 购买，不在此列表
遇到问题？在碳基圈 @Claude AI 或联系管理员