8. 偶像端 API 8.6 更新偶像资料【未授权拦截通过，待登录态联调】

Table of Contents

8.6 更新偶像资料【未授权拦截通过，待登录态联调】

PATCH /tieup/api/v1/artist/profile

鉴权：需要 Authorization: Bearer <access_token>，且当前账号必须已开通偶像端。

请求体：

{
  "avatar": "https://cdn.example.com/artist/avatar.png",
  "artist_name": "王心凌",
  "album_media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/a.png"
    },
    {
      "type": "video",
      "url": "https://cdn.example.com/v.mp4",
      "cover_url": "https://cdn.example.com/v-cover.png",
      "duration": 58
    }
  ],
  "intro_type": "audio",
  "intro_text": "",
  "intro_audio_url": "https://cdn.example.com/intro.m4a",
  "intro_audio_duration": 58,
  "personal_intro": "大家好，我是王心凌。"
}

请求参数：

参数 类型 必填 说明
avatar string 否 艺人头像 URL，最大 500 字符；仅更新 tieup_artist.avatar，不反写 tieup_user.avatar
artist_name string 否 艺人对外展示名称，最大 100 字符
album_media array 否 艺人相册素材，图片/视频合计数量受后台艺人设置 album_photo_limit 控制，0 表示不限制
album_media[].type string 是 素材类型：image 或 video
album_media[].url string 是 素材 URL，最大 500 字符
album_media[].cover_url string 否 视频封面 URL，最大 500 字符，仅视频素材使用
album_media[].duration integer 否 视频时长，单位秒，最小 0，仅视频素材使用
intro_type string 否 短介绍类型：text、audio 或空字符串
intro_text string 否 一句话文字介绍，最大 255 字符；intro_type=text 时保存并清空语音字段
intro_audio_url string 否 一句话语音介绍 URL，最大 500 字符；intro_type=audio 时保存并清空文字短介绍
intro_audio_duration integer 否 语音介绍时长，单位秒，最小 0
personal_intro string 否 自我介绍，最大 5000 字符

响应字段：

字段 类型 说明
id integer 艺人 ID
user_id integer 绑定的 APP 用户 ID
artist_name string 艺人对外展示名称
avatar string 艺人头像 URL，来源 tieup_artist.avatar
album_media array 艺人相册素材，图片/视频列表
intro_type string 短介绍类型：text、audio 或空字符串
intro_text string 一句话文字介绍
intro_audio_url string 一句话语音介绍 URL
intro_audio_duration integer 语音介绍时长，单位秒
artist_type integer 艺人类型
artist_category_id integer/null 艺人分类 ID
personal_intro string 自我介绍
related_experience string 相关经历或代表作品，当前资料编辑接口不支持修改
phone string 联系手机号，当前资料编辑接口不支持修改
settled_at string/null 入驻时间
withdrawable_amount string 可提现金额

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "id": 20001,
    "user_id": 10001,
    "artist_name": "王心凌",
    "avatar": "https://cdn.example.com/artist/avatar.png",
    "album_media": [
      {
        "type": "image",
        "url": "https://cdn.example.com/a.png"
      },
      {
        "type": "video",
        "url": "https://cdn.example.com/v.mp4",
        "cover_url": "https://cdn.example.com/v-cover.png",
        "duration": 58
      }
    ],
    "intro_type": "audio",
    "intro_text": "",
    "intro_audio_url": "https://cdn.example.com/intro.m4a",
    "intro_audio_duration": 58,
    "artist_type": 1,
    "artist_category_id": 10,
    "personal_intro": "大家好，我是王心凌。",
    "related_experience": "相关经历",
    "phone": "13800138000",
    "settled_at": "2026-06-22 10:00:00",
    "withdrawable_amount": "0.00"
  }
}

说明：

  • 文件本身仍通过 POST /tieup/api/v1/files 上传，本接口只保存上传后得到的 URL。
  • album_media 数量限制读取后台系统配置 tieup/business-config 的艺人设置 album_photo_limit；渠道存在覆盖配置时按渠道运行时配置生效，0 表示不限制。
  • 短介绍按文字和语音二选一保存：intro_type=text 时清空语音字段，intro_type=audio 时清空文字短介绍，空字符串表示清空短介绍。
  • 云上曲率内容审核配置开启时，艺名、头像、相册图片/视频、短介绍和个人介绍必须先通过机审；机审未明确通过时不保存资料。
  • 偶像分类、星探、经纪公司归属由平台配置维护，APP 端不可直接修改；related_experience、phone 保留为响应字段，当前资料编辑接口不支持修改。