# 获取AI角色列表

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /get_ai_characters:
    post:
      summary: 获取AI角色列表
      deprecated: false
      description: 获取群聊中的AI角色列表
      tags:
        - 扩展接口
        - 扩展接口
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                group_id:
                  description: 群号
                  type: string
                chat_type:
                  default: 1
                  description: 聊天类型
                  anyOf:
                    - type: number
                    - type: string
              required:
                - group_id
                - chat_type
              x-apifox-orders:
                - group_id
                - chat_type
              x-apifox-ignore-properties: []
            examples:
              Default:
                value:
                  group_id: '123456'
                summary: 默认请求示例
      responses:
        '200':
          description: 业务响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/BaseResponse'
                  - type: object
                    required:
                      - data
                    properties:
                      data:
                        description: 业务数据
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              description: 角色类型
                              type: string
                            characters:
                              description: 角色列表
                              type: array
                              items:
                                type: object
                                properties:
                                  character_id:
                                    description: 角色ID
                                    type: string
                                  character_name:
                                    description: 角色名称
                                    type: string
                                  preview_url:
                                    description: 预览URL
                                    type: string
                                required:
                                  - character_id
                                  - character_name
                                  - preview_url
                                x-apifox-orders:
                                  - character_id
                                  - character_name
                                  - preview_url
                                x-apifox-ignore-properties: []
                          required:
                            - type
                            - characters
                          x-apifox-orders:
                            - type
                            - characters
                          x-apifox-ignore-properties: []
                    x-apifox-orders:
                      - data
                    x-apifox-ignore-properties: []
              examples:
                Success:
                  summary: 成功响应
                  value:
                    status: ok
                    retcode: 0
                    data:
                      - type: string
                        characters:
                          - character_id: id
                            character_name: name
                            preview_url: url
                    message: ''
                    wording: ''
                    stream: normal-action
                Error_1400:
                  summary: 请求参数错误或业务逻辑执行失败
                  value:
                    status: failed
                    retcode: 1400
                    data: null
                    message: 请求参数错误或业务逻辑执行失败
                    wording: 请求参数错误或业务逻辑执行失败
                    stream: normal-action
                Error_1401:
                  summary: 权限不足
                  value:
                    status: failed
                    retcode: 1401
                    data: null
                    message: 权限不足
                    wording: 权限不足
                    stream: normal-action
                Error_1404:
                  summary: 资源不存在
                  value:
                    status: failed
                    retcode: 1404
                    data: null
                    message: 资源不存在
                    wording: 资源不存在
                    stream: normal-action
          headers: {}
          x-apifox-name: 成功
      security: []
      x-apifox-folder: 扩展接口
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/5348325/apis/api-229485683-run
components:
  schemas:
    BaseResponse:
      type: object
      x-schema-id: BaseResponse
      properties:
        status:
          type: string
          description: 状态 (ok/failed)
        retcode:
          type: number
          description: 返回码
        data:
          type: string
        message:
          type: string
          description: 消息
        wording:
          type: string
          description: 提示
        stream:
          type: string
          description: 流式响应
          enum:
            - stream-action
            - normal-action
      required:
        - status
        - retcode
      x-apifox-orders:
        - status
        - retcode
        - data
        - message
        - wording
        - stream
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes: {}
servers: []
security: []

```