> ## 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.

# 中转 Messages（Anthropic 规范，SSE）

> 接口说明：兼容 Anthropic /v1/messages 规范的流式中转接口；Anthropic SDK 默认携带 x-api-key 头。



## OpenAPI

````yaml /openapi/zh/aitoearn.openapi.json post /api/ai/v1/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: AI 服务/模型中转
  - name: 渠道管理
  - name: 渠道管理/账号
  - name: 渠道管理/内容发布
  - name: 渠道管理/平台
  - name: 渠道管理/互动
  - name: 渠道管理/作品
  - name: 渠道管理/账号分组
  - name: 渠道管理/授权
  - name: 资源管理
paths:
  /api/ai/v1/messages:
    post:
      tags:
        - AI 服务/模型中转
      summary: 中转 Messages（Anthropic 规范，SSE）
      description: 接口说明：兼容 Anthropic /v1/messages 规范的流式中转接口；Anthropic SDK 默认携带 x-api-key 头。
      operationId: RelayController_claudeMessages
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClaudeChatProxyDto'
            examples: {}
        required: true
      responses:
        '200':
          description: 第三方协议原生响应或 SSE 数据。不使用 AiToEarn 通用响应包裹。
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                description: 第三方协议原生响应，不使用 AiToEarn 通用响应包裹。
              examples:
                success:
                  summary: 第三方协议原生成功响应
                  value:
                    id: RelayController_claudeMessages_example
                    object: response
            text/event-stream:
              schema:
                type: string
                description: SSE 流式响应。
      deprecated: false
      security:
        - apikey-header-X-Api-Key: []
components:
  schemas:
    ClaudeChatProxyDto:
      type: object
      properties:
        messages:
          minItems: 1
          type: array
          items:
            type: object
            properties:
              role:
                type: string
                enum:
                  - user
                  - assistant
                description: 消息角色，用于区分不同消息来源
              content:
                description: 内容正文
            required:
              - role
              - content
            additionalProperties: true
          description: 消息列表
        model:
          type: string
          description: 模型 ID
        max_tokens:
          default: 32000
          type: integer
          minimum: 1
          maximum: 9007199254740991
          description: 最大token值
        billingGroupId:
          description: 计费分组 ID，相同分组的连续 Chat 调用合并扣费日志
          type: string
          minLength: 1
        source:
          description: 消费来源
          type: string
          enum:
            - ai_chat
            - plugin
      required:
        - messages
        - model
      additionalProperties: true
  securitySchemes:
    apikey-header-X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key
      description: AiToEarn Open Platform API Key。

````