> ## 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 Count Tokens



## OpenAPI

````yaml /openapi/claude.json post /v1/messages/count_tokens
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/count_tokens:
    post:
      summary: Claude Messages Count Tokens
      operationId: countMessageTokens
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClaudeMessageCountTokensRequest'
            example:
              model: claude-opus-4-8
              messages:
                - role: user
                  content: Hello!
      responses:
        '200':
          description: V1 Messages Count Tokens Response 200
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClaudeMessageCountTokensResponse'
        '400':
          description: V1 Messages Count Tokens Response 400
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '401':
          description: V1 Messages Count Tokens Response 401
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '403':
          description: V1 Messages Count Tokens Response 403
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '404':
          description: V1 Messages Count Tokens Response 404
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '413':
          description: V1 Messages Count Tokens Response 413
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '429':
          description: V1 Messages Count Tokens Response 429
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '500':
          description: V1 Messages Count Tokens Response 500
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '503':
          description: V1 Messages Count Tokens Response 503
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
        '504':
          description: V1 Messages Count Tokens Response 504
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AceDataCloudErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    ClaudeMessageCountTokensRequest:
      type: object
      required:
        - model
        - messages
      properties:
        model:
          type: string
          description: V1 Messages Count Tokens 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
        system:
          $ref: '#/components/schemas/ClaudeSystemPrompt'
        thinking:
          $ref: '#/components/schemas/ClaudeThinkingConfig'
        tool_choice:
          $ref: '#/components/schemas/ClaudeToolChoice'
        tools:
          type: array
          items:
            $ref: '#/components/schemas/ClaudeTool'
          description: V1 Messages Count Tokens Tools
        cache_control:
          $ref: '#/components/schemas/ClaudeCacheControlEphemeral'
    ClaudeMessageCountTokensResponse:
      type: object
      required:
        - input_tokens
      properties:
        input_tokens:
          type: integer
          description: V1 Messages Count Tokens Response 200 Input Tokens
    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'
    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
    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'
    ClaudeCacheControlEphemeral:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - ephemeral
        ttl:
          type: string
          enum:
            - 5m
            - 1h
          default: 5m
      additionalProperties: false
    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'
    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
    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
    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

````