ccapi-ai Claude / Anthropic LLM Integration API

openapi: 3.2.0
info:
  title: CCAPI Claude / Anthropic LLM Integration API
  description: CCAPI Model Gateway — OpenAI-compatible unified API
  version: 1.0.0
servers:
- url: https://api.ccapi.ai
  description: CCAPI API Gateway
tags:
- name: Claude / Anthropic LLM Integration
  description: 'Access the Claude native Messages API via CCAPI proxy routing.


    ---


    ## Authentication


    Recommended Claude native-style request headers:


    - `x-api-key: `

    - `anthropic-version: 2023-06-01`


    The `x-api-key` value should be your CCAPI token, not the upstream official API Key.


    ---


    ## Recommended Endpoint


    - `POST /v1/messages`


    ---


    ## Capabilities


    - Streaming output supported

    - Tool use supported

    - Extended thinking / reasoning fields supported

    - Supports converting OpenAI-compatible requests to Claude native format, but this document focuses on the native API


    ---


    ## Models


    Common model examples: `claude-sonnet-4-6`, `claude-opus-4-6`, `claude-haiku-4-5`.


    Actually available models are determined by the `GET /v1/models` response and backend channel configuration.


    ---


    ## Pricing


    Visit the Pricing page to see full model pricing for this provider.'
paths:
  /v1/messages:
    post:
      deprecated: false
      description: Unified Anthropic Messages endpoint. Select the matching oneOf request schema branch by `model`; provider-specific parameters, examples, and response fields remain available in their corresponding branches.
      operationId: anthropic-compatible-messages
      parameters:
      - description: CCAPI token. For the Claude native API, CCAPI supports direct authentication via this header.
        example: sk-xxxx
        in: header
        name: x-api-key
        required: true
        schema:
          type: string
      - description: Anthropic API version. If omitted, the project defaults to `2023-06-01`.
        example: '2023-06-01'
        in: header
        name: anthropic-version
        required: false
        schema:
          type: string
      - description: Optional beta capability header, passed through to the upstream provider.
        in: header
        name: anthropic-beta
        required: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            examples:
              basic_message:
                summary: Basic message request
                value:
                  max_tokens: 1024
                  messages:
                  - content: Explain why idempotent design is important for payment callbacks.
                    role: user
                  model: claude-opus-4-6
                  system: You are a rigorous technical assistant.
              deepseek-llm-integration_deepseek_message:
                summary: DeepSeek V4 Pro via Anthropic Messages
                value:
                  max_tokens: 1000
                  messages:
                  - content: Review this design for concurrency risks.
                    role: user
                  model: deepseek-v4-pro
                  system: You are a helpful assistant.
              thinking_and_tools:
                summary: Request with thinking and tools
                value:
                  max_tokens: 2048
                  messages:
                  - content: Query today's weather in Hangzhou and provide travel suggestions.
                    role: user
                  model: claude-sonnet-4-6
                  thinking:
                    budget_tokens: 1024
                    type: enabled
                  tools:
                  - description: Query weather
                    input_schema:
                      properties:
                        city:
                          type: string
                      required:
                      - city
                      type: object
                    name: get_weather
            schema:
              oneOf:
              - properties:
                  max_tokens:
                    description: Maximum number of output tokens.
                    type: integer
                  messages:
                    description: Claude native message list.
                    items:
                      properties:
                        content:
                          description: Content can be a string or an array of content blocks.
                          oneOf:
                          - type: string
                          - items:
                              properties:
                                id:
                                  type: string
                                input:
                                  type: object
                                name:
                                  type: string
                                text:
                                  type: string
                                type:
                                  enum:
                                  - text
                                  - tool_result
                                  - tool_use
                                  - image
                                  type: string
                              type: object
                            type: array
                        role:
                          enum:
                          - user
                          - assistant
                          type: string
                      required:
                      - role
                      - content
                      type: object
                    type: array
                  model:
                    description: Model name, e.g. `claude-opus-4-6`, `claude-sonnet-4-6`.
                    type: string
                  stop_sequences:
                    items:
                      type: string
                    type: array
                  stream:
                    default: false
                    type: boolean
                  system:
                    description: System prompt.
                    oneOf:
                    - type: string
                    - items:
                        type: object
                      type: array
                  temperature:
                    type: number
                  thinking:
                    description: Reasoning/thinking mode settings.
                    properties:
                      budget_tokens:
                        type: integer
                      type:
                        enum:
                        - enabled
                        type: string
                    type: object
                  tool_choice:
                    properties:
                      name:
                        type: string
                      type:
                        enum:
                        - auto
                        - any
                        - tool
                        type: string
                    type: object
                  tools:
                    description: Claude native tool definitions.
                    items:
                      properties:
                        description:
                          type: string
                        input_schema:
                          type: object
                        name:
                          type: string
                      required:
                      - name
                      - input_schema
                      type: object
                    type: array
                required:
                - model
                - max_tokens
                - messages
                title: Claude / Anthropic LLM Integration
                type: object
              - properties:
                  max_tokens:
                    type: integer
                  messages:
                    items:
                      properties:
                        content:
                          type: string
                        role:
                          enum:
                          - user
                          - assistant
                          type: string
                      required:
                      - role
                      - content
                      type: object
                    type: array
                  model:
                    enum:
                    - deepseek-v4-flash
                    - deepseek-v4-pro
                    type: string
                  stream:
                    default: false
                    type: boolean
                  system:
                    type: string
                  thinking:
                    description: Anthropic thinking configuration. DeepSeek supports the mode but ignores budget_tokens.
                    properties:
                      budget_tokens:
                        description: Accepted for compatibility but ignored by DeepSeek.
                        type: integer
                      type:
                        enum:
                        - enabled
                        - disabled
                        type: string
                    type: object
                required:
                - model
                - max_tokens
                - messages
                title: DeepSeek LLM Integration
                type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                content:
                - text: Idempotency prevents duplicate charges, duplicate shipments, or duplicate accounting when payment platforms send repeated notifications.
                  type: text
                id: msg_01ABC
                model: claude-opus-4-6
                role: assistant
                stop_reason: end_turn
                type: message
                usage:
                  input_tokens: 58
                  output_tokens: 36
              schema:
                oneOf:
                - properties:
                    content:
                      items:
                        type: object
                      type: array
                    id:
                      type: string
                    model:
                      type: string
                    role:
                      enum:
                      - assistant
                      type: string
                    stop_reason:
                      type: string
                    type:
                      enum:
                      - message
                      type: string
                    usage:
                      properties:
                        input_tokens:
                          type: integer
                        output_tokens:
                          type: integer
                      type: object
                  title: Claude / Anthropic LLM Integration
                  type: object
                - properties:
                    content:
                      items:
                        properties:
                          text:
                            type: string
                          thinking:
                            type: string
                          type:
                            type: string
                        type: object
                      type: array
                    id:
                      type: string
                    model:
                      type: string
                    role:
                      enum:
                      - assistant
                      type: string
                    stop_reason:
                      type: string
                    type:
                      enum:
                      - message
                      type: string
                    usage:
                      properties:
                        input_tokens:
                          type: integer
                        output_tokens:
                          type: integer
                      type: object
                  title: DeepSeek LLM Integration
                  type: object
            text/event-stream:
              schema:
                description: Returns an SSE data stream when `stream=true`.
                type: string
          description: Success
        '401':
          description: Authentication failed
      summary: Create Anthropic Message
      tags:
      - Claude / Anthropic LLM Integration
      x-apifox-folder: Anthropic
components:
  securitySchemes:
    bearer:
      description: 'CCAPI API Key. Format: `Bearer sk-xxx`'
      scheme: bearer
      type: http
x-tagGroups:
- name: Integration Guides
  tags:
  - OpenClaw Integration
  - Hermes Integration
  - Claude Code Integration
  - Codex CLI Integration
  - Gemini CLI Integration
- name: Chat
  tags:
  - Claude / Anthropic LLM Integration
  - OpenAI LLM Integration
  - Google Gemini LLM Integration
  - DeepSeek LLM Integration
  - MiniMax LLM Integration
- name: Image
  tags:
  - GPT Image 2 Per-Call Image Generation
  - Midjourney Imagine API
  - Gemini Per-Call Image Generation
  - CCAPI Image Upscale
  - Z-Image Turbo
  - Doubao Seedream Official Image API
- name: Video
  tags:
  - Gemini Video (Veo 3.1 / Omni Flash)
  - Grok Imagine Video
  - MiniMax H3 Family Video Generation
  - Seedance Trusted Asset Library
  - Seedance 2.5 / 2.0 Video Generation
  - Vidu Video Generation API
- name: Audio
  tags:
  - Producer Task API
  - Suno Task API