> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aitoearn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 消息列表

> 获取指定会话已保存的消息。返回的是 AI SDK UI Message 列表。



## OpenAPI

````yaml /openapi/zh/aitoearn.openapi.json get /api/agent/sessions/{sessionId}/messages
openapi: 3.0.1
info:
  title: AiToEarn 开放平台 API
  description: AiToEarn 开放平台 API，支持在中国站与国际站之间切换调试。业务是否成功以响应体 code === 0 为准。
  version: 1.0.0
  contact: {}
servers:
  - url: https://aitoearn.cn
    description: 中国站
  - url: https://aitoearn.ai
    description: 国际站
security: []
tags:
  - name: AI 服务
  - name: AI 服务/视频生成
  - name: AI 服务/图像生成
  - name: 渠道管理
  - name: 渠道管理/账号
  - name: 渠道管理/内容发布
  - name: 渠道管理/平台
  - name: 渠道管理/作品
  - name: 渠道管理/账号分组
  - name: 渠道管理/授权
  - name: 资源管理
  - name: AI 服务/大语言模型
  - name: AI 服务/真人素材
  - name: AI 服务/Agent
paths:
  /api/agent/sessions/{sessionId}/messages:
    get:
      tags:
        - AI 服务/Agent
      summary: 消息列表
      description: 获取指定会话已保存的消息。返回的是 AI SDK UI Message 列表。
      operationId: AgentController_getSessionMessages
      parameters:
        - name: sessionId
          in: path
          required: true
          description: 会话 ID。
          schema:
            type: string
            description: 会话 ID。
      responses:
        '200':
          description: 请求已被服务处理。业务是否成功以响应体 code === 0 为准。
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: 消息 ID。
                        sessionId:
                          type: string
                          description: 所属会话 ID。
                        runId:
                          type: string
                          description: 关联的运行 ID。
                        stepNumber:
                          type: integer
                          description: 关联的步骤序号，从 0 开始。
                        message:
                          type: object
                          description: AI SDK UI Message。
                          properties:
                            id:
                              type: string
                              description: UI 消息 ID。
                            role:
                              type: string
                              enum:
                                - system
                                - user
                                - assistant
                              description: 消息角色。
                            parts:
                              type: array
                              description: 消息分段。具体字段随分段类型变化。
                              items:
                                type: object
                                additionalProperties: true
                          required:
                            - id
                            - role
                            - parts
                          additionalProperties: true
                        createdAt:
                          type: string
                          format: date-time
                          description: 创建时间。
                      required:
                        - id
                        - sessionId
                        - message
                        - createdAt
                      additionalProperties: false
                    description: 会话消息列表。
                  code:
                    type: integer
                    description: 业务状态码。0 表示成功，非 0 表示业务错误。
                  message:
                    type: string
                    description: 响应消息。
                  requestId:
                    type: string
                    description: 请求 ID。
                  timestamp:
                    type: integer
                    description: 错误响应时间戳，Unix 毫秒。
                required:
                  - code
                  - message
              examples:
                success:
                  summary: 成功
                  value:
                    code: 0
                    message: 请求成功
                    data:
                      - id: string
                        sessionId: string
                        message:
                          id: string
                          role: system
                          parts:
                            - {}
                        createdAt: '2026-07-02T12:00:00.000Z'
                        runId: string
                        stepNumber: 1
                validationFailed10002:
                  summary: ValidationFailed (10002)
                  value:
                    code: 10002
                    message: 参数验证失败
                    data: {}
                    timestamp: 1772099056662
                unauthorized401:
                  summary: 未认证或 API Key 无效
                  value:
                    code: 401
                    message: Unauthorized
                    data: {}
                    timestamp: 1772099056662
                agentSessionNotFound18104:
                  summary: AgentSessionNotFound (18104)
                  value:
                    code: 18104
                    message: Agent 会话未找到
                    data: {}
                    timestamp: 1772099056662
      security:
        - apikey-header-X-Api-Key: []
components:
  securitySchemes:
    apikey-header-X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: 需要从 AiToEarn 获取 API Key。点击前往[「API Key 获取教程」](/zh/use/api-key)。

````