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

# Claude Messages



## OpenAPI

````yaml /openapi/claude.json post /v1/messages
openapi: 3.0.0
info:
  title: Claude AI
  version: 1.0.0
  description: API reference for Claude AI on Ace Data Cloud.
servers:
  - url: https://api.acedata.cloud
    description: Ace Data Cloud API
security:
  - bearerAuth: []
paths:
  /v1/messages:
    post:
      summary: Claude Messages
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - messages
                - max_tokens
              properties:
                model:
                  type: string
                  description: V1 Messages Model
                  example: claude-opus-4-8
                messages:
                  type: array
                  description: V1 Messages Messages
                  items:
                    type: object
                    required:
                      - role
                      - content
                    properties:
                      role:
                        type: string
                        enum:
                          - user
                          - assistant
                      content:
                        oneOf:
                          - type: string
                          - type: array
                            items:
                              type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - text
                                    - image
                                text:
                                  type: string
                                source:
                                  type: object
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - base64
                                    media_type:
                                      type: string
                                    data:
                                      type: string
                max_tokens:
                  type: integer
                  description: V1 Messages Max Tokens
                  example: 1024
                metadata:
                  type: object
                  properties:
                    user_id:
                      type: string
                stop_sequences:
                  type: array
                  items:
                    type: string
                  description: V1 Messages Stop Sequences
                stream:
                  type: boolean
                  description: V1 Messages Stream
                  default: false
                system:
                  type: string
                  description: V1 Messages System
                temperature:
                  type: number
                  description: V1 Messages Temperature
                  minimum: 0
                  maximum: 1
                  example: 1
                tool_choice:
                  type: object
                  description: V1 Messages Tool Choice
                tools:
                  type: array
                  items:
                    type: object
                  description: V1 Messages Tools
                top_k:
                  type: integer
                  description: V1 Messages Top K
                top_p:
                  type: number
                  description: V1 Messages Top P
            example:
              model: claude-opus-4-8
              messages:
                - role: user
                  content: Hello!
              max_tokens: 1024
              temperature: 1
      responses:
        '200':
          description: V1 Messages Response 200
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - type
                  - role
                  - content
                  - model
                  - stop_reason
                  - stop_sequence
                  - usage
                properties:
                  id:
                    type: string
                    description: V1 Messages Response 200 Id
                  type:
                    type: string
                    enum:
                      - message
                  role:
                    type: string
                    enum:
                      - assistant
                  content:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                          enum:
                            - text
                            - tool_use
                        text:
                          type: string
                        id:
                          type: string
                        name:
                          type: string
                        input:
                          type: object
                  model:
                    type: string
                    description: V1 Messages Response 200 Model
                  stop_reason:
                    type: string
                    enum:
                      - end_turn
                      - max_tokens
                      - stop_sequence
                      - tool_use
                    nullable: true
                  stop_sequence:
                    type: string
                    nullable: true
                  usage:
                    type: object
                    properties:
                      input_tokens:
                        type: integer
                      output_tokens:
                        type: integer
        '400':
          description: V1 Messages Response 400
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - error
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                      message:
                        type: string
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token from https://platform.acedata.cloud

````