> ## 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
      operationId: createMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClaudeMessageCreateRequest'
            example:
              model: claude-opus-5
              messages:
                - role: user
                  content: Hello!
              max_tokens: 1024
      responses:
        '200':
          description: V1 Messages Response 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClaudeMessage'
        '400':
          description: V1 Messages Response 400
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '401':
          description: V1 Messages Response 401
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '403':
          description: V1 Messages Response 403
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '404':
          description: V1 Messages Response 404
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '413':
          description: V1 Messages Response 413
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '429':
          description: V1 Messages Response 429
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '500':
          description: V1 Messages Response 500
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '503':
          description: V1 Messages Response 503
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '504':
          description: V1 Messages Response 504
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    ClaudeMessageCreateRequest:
      type: object
      required:
        - model
        - messages
        - max_tokens
      properties:
        model:
          type: string
          description: V1 Messages Model
          enum:
            - claude-fable-5-1
            - claude-fable-5
            - claude-opus-5
            - claude-opus-4-8
            - claude-sonnet-5
            - claude-sonnet-4-6
            - claude-opus-4-7
            - claude-opus-4-6
            - claude-opus-4-5-20251101
            - claude-haiku-4-5-20251001
            - claude-sonnet-4-5-20250929
            - claude-opus-4-1-20250805
            - claude-sonnet-4-20250514
            - claude-opus-4-20250514
            - claude-3-7-sonnet-20250219
            - claude-3-5-sonnet-20241022
            - claude-3-5-haiku-20241022
            - claude-3-5-sonnet-20240620
            - claude-3-haiku-20240307
            - claude-3-sonnet-20240229
          example: claude-opus-4-8
        messages:
          type: array
          items:
            $ref: '#/components/schemas/ClaudeMessageParam'
          minItems: 1
          maxItems: 100000
        max_tokens:
          type: integer
          minimum: 1
          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:
          $ref: '#/components/schemas/ClaudeSystemPrompt'
        temperature:
          type: number
          description: V1 Messages Temperature
          minimum: 0
          maximum: 1
          example: 1
        tool_choice:
          $ref: '#/components/schemas/ClaudeToolChoice'
        tools:
          type: array
          items:
            $ref: '#/components/schemas/ClaudeTool'
          description: V1 Messages Tools
        top_k:
          type: integer
          description: V1 Messages Top K
        top_p:
          type: number
          description: V1 Messages Top P
        thinking:
          $ref: '#/components/schemas/ClaudeThinkingConfig'
        output_config:
          type: object
          description: V1 Messages Output Config
          properties:
            effort:
              type: string
              enum:
                - low
                - medium
                - high
                - xhigh
                - max
              description: V1 Messages Output Config Effort
          additionalProperties: true
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
    ClaudeMessage:
      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:
            $ref: '#/components/schemas/ClaudeContentBlock'
        model:
          type: string
          description: V1 Messages Response 200 Model
        stop_reason:
          type: string
          enum:
            - end_turn
            - max_tokens
            - stop_sequence
            - tool_use
            - pause_turn
            - refusal
            - model_context_window_exceeded
          nullable: true
        stop_sequence:
          type: string
          nullable: true
        stop_details:
          $ref: '#/components/schemas/ClaudeRefusalStopDetails'
        usage:
          $ref: '#/components/schemas/ClaudeUsage'
    AceDataCloudErrorResponse:
      type: object
      required:
        - error
        - trace_id
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
        trace_id:
          type: string
    ClaudeMessageParam:
      type: object
      required:
        - role
        - content
      properties:
        role:
          type: string
          enum:
            - user
            - assistant
        content:
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ClaudeContentBlockParam'
    ClaudeSystemPrompt:
      oneOf:
        - type: string
        - type: array
          items:
            $ref: '#/components/schemas/ClaudeTextBlockParam'
    ClaudeToolChoice:
      oneOf:
        - type: object
          required:
            - type
          properties:
            type:
              type: string
              enum:
                - auto
            disable_parallel_tool_use:
              type: boolean
          additionalProperties: false
        - type: object
          required:
            - type
          properties:
            type:
              type: string
              enum:
                - any
            disable_parallel_tool_use:
              type: boolean
          additionalProperties: false
        - type: object
          required:
            - type
            - name
          properties:
            type:
              type: string
              enum:
                - tool
            name:
              type: string
            disable_parallel_tool_use:
              type: boolean
          additionalProperties: false
        - type: object
          required:
            - type
          properties:
            type:
              type: string
              enum:
                - none
            disable_parallel_tool_use:
              type: boolean
          additionalProperties: false
      discriminator:
        propertyName: type
    ClaudeTool:
      type: object
      required:
        - name
        - input_schema
      properties:
        name:
          type: string
        description:
          type: string
        input_schema:
          type: object
          additionalProperties: true
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
    ClaudeThinkingConfig:
      oneOf:
        - type: object
          required:
            - type
            - budget_tokens
          properties:
            type:
              type: string
              enum:
                - enabled
            budget_tokens:
              type: integer
              minimum: 1024
            display:
              type: string
              enum:
                - summarized
                - omitted
          additionalProperties: false
        - type: object
          required:
            - type
          properties:
            type:
              type: string
              enum:
                - disabled
          additionalProperties: false
        - type: object
          required:
            - type
          properties:
            type:
              type: string
              enum:
                - adaptive
            display:
              type: string
              enum:
                - summarized
                - omitted
          additionalProperties: false
      discriminator:
        propertyName: type
    ClaudeCacheControlEphemeral:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - ephemeral
        ttl:
          type: string
          enum:
            - 5m
            - 1h
          default: 5m
      additionalProperties: false
    ClaudeContentBlock:
      oneOf:
        - $ref: '#/components/schemas/ClaudeTextBlock'
        - $ref: '#/components/schemas/ClaudeThinkingBlockParam'
        - $ref: '#/components/schemas/ClaudeRedactedThinkingBlockParam'
        - $ref: '#/components/schemas/ClaudeToolUseBlock'
      discriminator:
        propertyName: type
    ClaudeRefusalStopDetails:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - refusal
        category:
          type: string
          enum:
            - cyber
            - bio
            - frontier_llm
            - reasoning_extraction
            - general_harms
          nullable: true
        explanation:
          type: string
          nullable: true
      nullable: true
    ClaudeUsage:
      type: object
      required:
        - input_tokens
        - output_tokens
      properties:
        input_tokens:
          type: integer
          minimum: 0
        output_tokens:
          type: integer
          minimum: 0
        cache_creation_input_tokens:
          type: integer
          nullable: true
          minimum: 0
        cache_read_input_tokens:
          type: integer
          nullable: true
          minimum: 0
        cache_creation:
          type: object
          required:
            - ephemeral_1h_input_tokens
            - ephemeral_5m_input_tokens
          properties:
            ephemeral_1h_input_tokens:
              type: integer
              minimum: 0
            ephemeral_5m_input_tokens:
              type: integer
              minimum: 0
          nullable: true
        service_tier:
          type: string
          enum:
            - standard
            - priority
            - batch
          nullable: true
        cost:
          type: object
          required:
            - amount
            - currency
          properties:
            amount:
              type: number
              minimum: 0
              description: V1 Messages Response 200 Usage Cost Amount
            currency:
              type: string
              description: V1 Messages Response 200 Usage Cost Currency
            list_amount:
              type: number
              minimum: 0
              nullable: true
              description: V1 Messages Response 200 Usage Cost List Amount
          nullable: true
          description: V1 Messages Response 200 Usage Cost
        output_tokens_details:
          type: object
          required:
            - thinking_tokens
          properties:
            thinking_tokens:
              type: integer
              minimum: 0
              description: >-
                V1 Messages Response 200 Usage Output Tokens Details Thinking
                Tokens
          nullable: true
          description: V1 Messages Response 200 Usage Output Tokens Details
    ClaudeContentBlockParam:
      oneOf:
        - $ref: '#/components/schemas/ClaudeTextBlockParam'
        - $ref: '#/components/schemas/ClaudeImageBlockParam'
        - $ref: '#/components/schemas/ClaudeDocumentBlockParam'
        - $ref: '#/components/schemas/ClaudeThinkingBlockParam'
        - $ref: '#/components/schemas/ClaudeRedactedThinkingBlockParam'
        - $ref: '#/components/schemas/ClaudeToolUseBlockParam'
        - $ref: '#/components/schemas/ClaudeToolResultBlockParam'
      discriminator:
        propertyName: type
    ClaudeTextBlockParam:
      type: object
      required:
        - type
        - text
      properties:
        type:
          type: string
          enum:
            - text
        text:
          type: string
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
    ClaudeTextBlock:
      type: object
      required:
        - type
        - text
      properties:
        type:
          type: string
          enum:
            - text
        text:
          type: string
        citations:
          type: array
          items:
            type: object
            additionalProperties: true
          nullable: true
    ClaudeThinkingBlockParam:
      type: object
      required:
        - type
        - thinking
        - signature
      properties:
        type:
          type: string
          enum:
            - thinking
        thinking:
          type: string
        signature:
          type: string
      additionalProperties: false
    ClaudeRedactedThinkingBlockParam:
      type: object
      required:
        - type
        - data
      properties:
        type:
          type: string
          enum:
            - redacted_thinking
        data:
          type: string
      additionalProperties: false
    ClaudeToolUseBlock:
      type: object
      required:
        - type
        - id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - tool_use
        id:
          type: string
        name:
          type: string
        input:
          type: object
          additionalProperties: true
    ClaudeImageBlockParam:
      type: object
      required:
        - type
        - source
      properties:
        type:
          type: string
          enum:
            - image
        source:
          oneOf:
            - $ref: '#/components/schemas/ClaudeBase64ImageSource'
            - $ref: '#/components/schemas/ClaudeURLImageSource'
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
    ClaudeDocumentBlockParam:
      type: object
      required:
        - type
        - source
      properties:
        type:
          type: string
          enum:
            - document
        source:
          oneOf:
            - $ref: '#/components/schemas/ClaudeBase64PDFSource'
            - $ref: '#/components/schemas/ClaudeURLPDFSource'
            - $ref: '#/components/schemas/ClaudePlainTextSource'
            - $ref: '#/components/schemas/ClaudeContentBlockSource'
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
        citations:
          type: object
          required:
            - enabled
          properties:
            enabled:
              type: boolean
          additionalProperties: false
        context:
          type: string
        title:
          type: string
    ClaudeToolUseBlockParam:
      type: object
      required:
        - type
        - id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - tool_use
        id:
          type: string
        name:
          type: string
        input:
          type: object
          additionalProperties: true
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
    ClaudeToolResultBlockParam:
      type: object
      required:
        - type
        - tool_use_id
      properties:
        type:
          type: string
          enum:
            - tool_result
        tool_use_id:
          type: string
        content:
          oneOf:
            - type: string
            - type: array
              items:
                oneOf:
                  - $ref: '#/components/schemas/ClaudeTextBlockParam'
                  - $ref: '#/components/schemas/ClaudeImageBlockParam'
                  - $ref: '#/components/schemas/ClaudeDocumentBlockParam'
        is_error:
          type: boolean
          default: false
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
    ClaudeBase64ImageSource:
      type: object
      required:
        - type
        - media_type
        - data
      properties:
        type:
          type: string
          enum:
            - base64
        media_type:
          type: string
          enum:
            - image/jpeg
            - image/png
            - image/gif
            - image/webp
        data:
          type: string
          format: byte
      additionalProperties: false
    ClaudeURLImageSource:
      type: object
      required:
        - type
        - url
      properties:
        type:
          type: string
          enum:
            - url
        url:
          type: string
          format: uri
      additionalProperties: false
    ClaudeBase64PDFSource:
      type: object
      required:
        - type
        - media_type
        - data
      properties:
        type:
          type: string
          enum:
            - base64
        media_type:
          type: string
          enum:
            - application/pdf
        data:
          type: string
          format: byte
      additionalProperties: false
    ClaudeURLPDFSource:
      type: object
      required:
        - type
        - url
      properties:
        type:
          type: string
          enum:
            - url
        url:
          type: string
          format: uri
      additionalProperties: false
    ClaudePlainTextSource:
      type: object
      required:
        - type
        - media_type
        - data
      properties:
        type:
          type: string
          enum:
            - text
        media_type:
          type: string
          enum:
            - text/plain
        data:
          type: string
      additionalProperties: false
    ClaudeContentBlockSource:
      type: object
      required:
        - type
        - content
      properties:
        type:
          type: string
          enum:
            - content
        content:
          oneOf:
            - type: string
            - type: array
              items:
                oneOf:
                  - $ref: '#/components/schemas/ClaudeTextBlockParam'
                  - $ref: '#/components/schemas/ClaudeImageBlockParam'
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token from https://platform.acedata.cloud

````