发布专辑模块 API 接口文档

Authorization: Bearer <api_key>
Content-Type: application/x-www-form-urlencoded

genre_main=0  → "另类音乐"

language=0  → "简体中文（Chinese）"
language=2  → "英语（English）"

["许嵩", "周杰伦"]

["feat_艺人1","feat_艺人2"]

[{"title":"测试繁体","language":1},{"title":"测试","language":2}]

[
    "performer":"周杰伦",
    "composer":"浩林,周杰伦",
    "lyricist":"方文山",
    "producer":"周杰伦",
    "arranger":"林迈可",
    "featuring":"",
    "harmonic_composer":"林迈可,方文山"  // 和声编写
]

{
    "code": 1,
    "msg": "",
    "data": {
        "album": {
            "id": 1,
            "user_id": 1,
            "name_cn": "测试专辑",
            "version": "",
            "cover_path": "/uploads/cover/abc.jpg",
            "dynamic_cover_1_1": "",
            "dynamic_cover_3_4": "",
            "genre_main": "pop",
            "genre_sub": "pop",
            "artists": ["许嵩", "周杰伦"],
            "featuring": ["feat_艺人1"],
            "language": "简体中文（Chinese）",
            "label_id": "某某唱片",
            "first_release_date": "2025-01-01",
            "expected_release_date": "2025-02-01",
            "release_status": "尚未发行",
            "p_line_year": "2025",
            "p_line": "2025 某某唱片公司",
            "c_line_year": "2025",
            "c_line": "2025 某某文化传媒公司",
            "message": "",
            "upc_ean": "",
            "description": "",
            "localized_languages": [
                {"title": "测试繁体", "language": "繁体中文（Traditional）"},
                {"title": "Test", "language": "英语（English）"}
            ],
            "status": "draft",
            "updated_at": "2025-01-15 10:30:00",
            "created_at": "2025-01-15 10:00:00"
        },
        "songs": [
            {
                "id": 10,
                "album_id": 1,
                "user_id": 1,
                "version": "",
                "genre_main": "pop",
                "genre_sub": "pop",
                "audio_path": "/uploads/audio/xyz.mp3",
                "language": "中文（Chinese）",
                "song_artists": {
                    "performer": "周杰伦",
                    "composer": "浩林,周杰伦",
                    "lyricist": "方文山",
                    "producer": "周杰伦",
                    "arranger": "林迈可",
                    "featuring": "",
                    ...
                },
                "song_titles": "晴天",
                "explicit_flag": "无脏标",
                "lyrics": "歌词内容...",
                "pline": "",
                "cline": "",
                "catalog_number": "",
                "isrc": "",
                "localized_languages": [],
                "sort": 0,
                "updated_at": "2025-01-15 10:30:00",
                "created_at": "2025-01-15 10:00:00"
            }
        ]
    }
}

GET https://u.xiaogequ.com/api_v1/album/songs
POST https://u.xiaogequ.com/api_v1/album/saveBasicInfo
POST https://u.xiaogequ.com/api_v1/album/saveSong
POST https://u.xiaogequ.com/api_v1/album/submitPublish
POST https://u.xiaogequ.com/api_v1/album/deleteSong
POST https://u.xiaogequ.com/api_v1/album/updateSongSort
POST https://u.xiaogequ.com/api_v1/album/delete

 0: 另类音乐
 1: 另类音乐 : 独立流行
 2: 另类音乐 : 独立摇滚
 3: 另类音乐 : 摇滚
 4: 氛围 : 新世纪
 5: 氛围 : 新世纪/冥想
 6: 动漫
 7: 蓝调
 8: 蓝调 : 传统蓝调
 9: 儿童音乐
 10: 儿童音乐 : 经典
 11: 儿童音乐 : 节日
 12: 儿童音乐 : 故事
 13: 中文 : 中国古典
 14: 中文 : 中国笛子
 15: 中文 : 中国地方民歌
 16: 中文 : 中国弦乐
 17: 古典
 18: 古典 : 古风
 19: 古典 : 巴洛克
 20: 古典 : 室内乐
 21: 古典 : 音乐会
 22: 古典 : 现代作品
 23: 古典 : 歌剧
 24: 古典 : 管弦乐
 25: 古典 : 钢琴
 26: 古典 : 浪漫主义
 27: 喜剧
 28: 乡村
 29: 乡村 : 蓝草
 30: 乡村 : 当代
 31: 乡村 : 酒吧音乐
 32: 乡村 : 纳什维尔
 33: 乡村 : 流行
 34: 乡村 : 广场舞
 35: 轻音乐
 36: 电子
 37: 实验
 38: 民谣
 39: 放克 : R&B
 40: 嘻哈 : 说唱
 41: 节日 : 圣诞
 42: 励志
 43: 器乐
 44: 爵士
 45: 爵士 : 比波普
 46: 爵士 : 大乐队
 47: 爵士 : 经典
 48: 爵士 : 传统
 49: 爵士 : 世界
 50: 卡拉OK
 51: 拉丁
 52: 拉丁 : 流行
 53: 拉丁 : 拉丁都市
 54: 音乐剧
 55: 新世纪
 56: 流行
 57: 流行 : 粤语流行
 58: 流行 : 日本流行音乐
 59: 流行 : 韩国流行音乐
 60: 流行 : 华语流行
 61: 流行 : 唱作人
 62: 朋克
 63: 节奏布鲁斯
 64: 雷鬼
 65: 摇滚
 66: 摇滚 : 经典
 67: 摇滚 : 摇滚乐
 68: 斯卡
 69: 灵魂乐
 70: 原声带
 71: 原声带 : 动漫
 72: 原声带 : 电影
 73: 原声带 : 音乐剧
 74: 原声带 : 电视
 75: 原声带 : 游戏
 76: 灵歌
 77: 口语
 78: 口语 : 演讲
 79: 陷阱音乐
 80: 人声 : 怀旧
 81: 世界音乐
 82: 世界音乐 : 非洲
 83: 世界音乐 : 美洲
 84: 世界音乐 : 阿拉伯
 85: 世界音乐 : 阿拉伯/阿拉伯流行
 86: 世界音乐 : 阿拉伯/埃及/埃及嘻哈
 87: 世界音乐 : 阿拉伯/埃及/马赫拉加纳特
 88: 世界音乐 : 阿拉伯/伊斯兰
 89: 世界音乐 : 阿拉伯/海湾
 90: 世界音乐 : 阿拉伯/海湾/海湾贾尔萨特
 91: 世界音乐 : 阿拉伯/海湾/海湾沙拉特
 92: 世界音乐 : 阿拉伯/黎凡特
 93: 世界音乐 : 阿拉伯/黎凡特/达布克
 94: 世界音乐 : 阿拉伯/马格里布雷伊
 95: 世界音乐 : 阿拉伯/北非
 96: 世界音乐 : 亚洲/中亚
 97: 世界音乐 : 亚洲/中国
 98: 世界音乐 : 亚洲/印度
 99: 世界音乐 : 亚洲/日本
100: 世界音乐 : 亚洲/南亚
101: 世界音乐 : 澳洲/太平洋
102: 世界音乐 : 民族
103: 世界音乐 : 欧洲

  专辑语言/本地化语言          |仅限歌曲语言
 0: 简体中文（Chinese）       |0: 纯音乐
 1: 繁体中文（Traditional）    |1: 中文（Chinese）
 2: 英语（English）           |2: 英语（English）
 3: 阿乔利语（Acoli）         |以下的保持不变
 4: 南非语（Afrikaans）
 5: 阿坎语（Akan）
 6: 阿姆哈拉语（Amharic）
 7: 阿拉伯语（Arabic）
 8: 亚美尼亚语（Armenian）
 9: 巴托努语（Baatonum）
 10: 班巴拉语（Bambara）
 11: 巴斯克语（Basque）
 12: 巴萨语（Bassa）
 13: 孟加拉语（Bengali）
 14: 贝宁语（Benin）
 15: 布列塔尼语（Breton）
 16: 保加利亚语（Bulgarian）
 17: 粤语（Cantonese）
 18: 加泰罗尼亚语（Catalan）
 19: 教会斯拉夫语（Church Slavic）
 20: 科西嘉语（Corsican）
 21: 奥尔语--瓜德罗普克里（Guadeloupe）
 22: 奥尔语--马提尼克克里（Martinique）
 23: 奥尔语--留尼汪克里（Reunion）
 24: 克罗地亚语（Croatian）
 25: 捷克语（Czech）
 26: 丹麦语（Danish）
 27: 迪塔马里语（Ditammari）
 28: 德曼语（dmn）
 29: 杜阿拉语（Duala）
 30: 荷兰语（Dutch）
 31: 迪尤拉语--布基纳法索（Burkina Faso）
 32: 迪尤拉语--科特迪瓦（Cote d'Ivoire）
 33: 爱沙尼亚语（Estonian）
 34: 芬兰语（Finnish）
 35: 丰语（Fon）
 36: 法语（French）
 37: 富拉语--布基纳法索（Burkina Faso）
 38: 富拉语--几内亚（Guinea）
 39: 富拉语--马里（Mali）
 40: 富拉语--尼日利亚（Nigeria）
 41: 富拉语--塞内加尔（Senegal）
 42: 富尔富尔德语（Fulfulde）
 43: 盖尔语（Gaelic）
 44: 加利西亚语（Galician）
 45: 格鲁吉亚语（Georgian）
 46: 德语（German）
 47: 加纳皮钦英语（Ghanaian Pidgin English）
 48: 希腊语（Greek）
 49: 圭亚那克里奥尔法语（Guianese Creole French）
 50: 海地语（Haitian）
 51: 客家语（Hakka）
 52: 希伯来语（Hebrew）
 53: 印地语（Hindi）
 54: 洪布里塞尼桑海语（Humburi Senni Songhay）
 55: 匈牙利语（Hungarian）
 56: 冰岛语（Icelandic）
 57: 印度尼西亚语（Indonesian）
 58: 爱尔兰语（Irish）
 59: 意大利语（Italian）
 60: 日语（Japanese）
 61: 哈萨克语（Kazakh）
 62: 金邦杜语（Kimbundu）
 63: 韩语（Korean）
 64: 科伊拉奇尼桑海语（Koyra Chiini Songhay）
 65: 老挝语（Lao）
 66: 拉丁语（Latin）
 67: 拉脱维亚语（Latvian）
 68: 林加拉语--安哥拉（Angola）
 69: 林加拉语--中非（Central African Republic）
 70: 林加拉语--刚果（金）（Democratic Republic of the Congo）
 71: 林加拉语--刚果（布）（Republic of the Congo）
 72: 立陶宛语（Lithuanian）
 73: 马达加斯加语（Malagasy）
 74: 马来语（Malay）
 75: 满语（Manchu）
 76: 毛利语（Maori）
 77: 闽南语（Minnan）
 78: 蒙古语（Mongolian）
 79: 多语言（Multilingual）
 80: 那不勒斯语（Neapolitan）
 81: 恩加齐贾科摩罗语（Ngazidja Comorian）
 82: 恩杰比语（Njebi）
 83: 北恩德贝莱语（North Ndebele）
 84: 北索托语（Northern Sotho）
 85: 挪威语（Norwegian）
 86: 奥克语（Occitan）
 87: 巴利语（Pali）
 88: 波斯语（Persian）
 89: 波兰语（Polish）
 90: 葡萄牙语（Portuguese）
 91: 旁遮普语（Punjabi）
 92: 罗马尼亚语（Romanian）
 93: 俄语（Russian）
 94: 梵语（Sanskrit）
 95: 绍纳语（Shona）
 96: 僧伽罗语（Sinhala）
 97: 斯洛伐克语（Slovak）
 98: 斯洛文尼亚语（Slovenian）
 99: 索马里语（Somali）
100: 索宁克语--冈比亚（Gambia）
101: 索宁克语--马里（Mali）
102: 索宁克语--毛里塔尼亚（Mauritania）
103: 索宁克语--塞内加尔（Senegal）
104: 南索托语（Southern Sotho）
105: 西班牙语（Spanish）
106: 拉丁美洲西班牙语（Spanish (Latin America)*）
107: 苏苏语--几内亚（Guinea）
108: 苏苏语--塞拉利昂（Sierra Leone）
109: 斯瓦希里语--刚果（金）（Democratic Republic of the Congo）
110: 斯瓦希里语--肯尼亚（Kenya）
111: 斯瓦希里语--乌干达（Uganda）
112: 瑞典语（Swedish）
113: 他加禄语（Tagalog）
114: 塔马谢克语（Tamasheq）
115: 泰米尔语（Tamil）
116: 泰卢固语（Telugu）
117: 泰语（Thai）
118: 藏语（Tibetan）
119: 聪加语（Tsonga）
120: 茨瓦纳语（Tswana）
121: 土耳其语（Turkish）
122: 维吾尔语（Uighur）
123: 乌克兰语（Ukrainian）
124: 未定义（Undefined）
125: 乌尔都语（Urdu）
126: 越南语（Vietnamese）
127: 瓦马语（Waama）
128: 威尔士语（Welsh）
129: 沃洛夫语--冈比亚（Gambia）
130: 沃洛夫语--毛里塔尼亚（Mauritania）
131: 沃洛夫语--塞内加尔（Senegal）
132: 科萨语（Xhosa）
133: 约鲁巴语（Yoruba）
134: 祖鲁语（Zulu）
135: 其他语言（Other）

  harmonic_composer          : Harmony Arranging（和声编写）
  adapter                    : Adapter（改编者）
  author                     : Author（作者）
  librettist                 : Librettist（编剧）
  licensed_verse             : Licensed Verse（授权主歌）
  orchestrator               : Orchestrator（配器师）
  vocal_adaptation           : Vocal Adaptation（声乐改编）

  recording_engineer         : Recording Engineer（录音师）
  mixing_engineer            : Mixing Engineer（混音师）
  mastering_engineer         : Mastering Engineer（母带工程师）
  cover_art_designer         : Cover Art Designer（封面设计师）
  audio_editing_engineer     : Audio Editing Engineer（音频编辑）
  cover_photography          : Cover Photography（封面摄影）
  assistant_engineer         : Assistant Engineer（助理工程师）
  atmos_mastering_engineer   : Atmos Mastering Engineer（全景声母带工程师）
  atmos_mixing_engineer      : Atmos Mixing Engineer（全景声混音师）
  co_producer                : Co-Producer（联合制作人）
  guitar_technician          : Guitar Technician（吉他技师）
  licensed_beat              : Licensed Beat（授权 Beat）
  production_assistant       : Production Assistant（制作助理）
  sound_engineer             : Sound Engineer（音响工程师）
  transcriber                : Transcriber（转录员）
  vocal_editing_engineer     : Vocal Editing Engineer（人声编辑）
  vocal_engineer             : Vocal Engineer（声乐工程师）
  vocal_producer             : Vocal Producer（配唱制作人）

  accordion                  : Accordion（手风琴）
  harmonic                   : Harmonic（和声）
  band                       : Band（乐队）
  bass                       : Bass（贝斯）
  bassoon                    : Bassoon（巴松管）
  bell                       : Bell（铃铛）
  cello                      : Cello（大提琴）
  choir                      : Choir（合唱团）
  drums                      : Drums（鼓）
  flute                      : Flute（竖笛/长笛）
  guitar                     : Guitar（吉他）
  harmonica                  : Harmonica（圆号）
  keyboard                   : Keyboard（键盘）
  piano                      : Piano（钢琴）
  rap                        : Rap（说唱）
  sampling                   : Sampling（采样）
  saxophone                  : Saxophone（萨克斯）
  synthesizer                : Synthesizer（合成器）
  ring_drums                 : Ring Drums（铃鼓）
  long_horn                  : Long Horn（长号）
  short_horn                 : Short Horn（小号）
  violin                     : Violin（小提琴/竖琴/中提琴）
  old_style_cello            : Old Style Cello（古大提琴）
  whistle                    : Whistle（口哨）
  woodwind                   : Woodwind（木琴）
  vocalist                   : Vocalist（主唱）
  mixed_performer            : Mixed Performer（混合表演者）
  arrangement_programming    : Arrangement Programming（编曲编程）
  pipe_organ                 : Pipe Organ（管风琴）
  hits                       : Hits（打击乐）
      
  project_planning           : Project Planning（企划/策划）
  coordinator                : Coordinator（统筹）
  supervisor                 : Supervisor（监制）
  executive_producer         : Executive Producer（出品/出品人）
  music_director             : Music Director（音乐总监）
  promotion                  : Promotion（宣发）
  responsible_editor         : Responsible Editor（责任编辑）