---
title: "Anthropic Claude"
method: POST
path: "/v1/messages"
---

# Anthropic Claude

`POST /v1/messages`

## Request body

- object — Use this field according to the endpoint schema.
  - `model` string, required — Use this field according to the endpoint schema.
  - `messages` object[], required — Use this field according to the endpoint schema.
    - `role` 'user' | 'assistant', required — Use this field according to the endpoint schema.
    - `content` union, required — Use this field according to the endpoint schema.
      - string
      - object[]
        - `type` string — Use this field according to the endpoint schema.
        - `text` string — Use this field according to the endpoint schema.
        - `source` object — Use this field according to the endpoint schema.
        - `tool_use_id` string — Use this field according to the endpoint schema.
        - `content` unknown
        - `cache_control` object — Use this field according to the endpoint schema.
  - `max_tokens` integer, required — Use this field according to the endpoint schema.
  - `cache_control` object — Use this field according to the endpoint schema.
    - `type` 'ephemeral' — Use this field according to the endpoint schema.
    - `ttl` integer — Use this field according to the endpoint schema.
  - `container` string — Use this field according to the endpoint schema.
  - `inference_geo` string — Use this field according to the endpoint schema.
  - `context_management` object, nullable — Use this field according to the endpoint schema.
  - `mcp_servers` object[] — Use this field according to the endpoint schema.
  - `metadata` object — Use this field according to the endpoint schema.
    - `user_id` string — Use this field according to the endpoint schema.
  - `output_config` object — Use this field according to the endpoint schema.
    - `effort` 'low' | 'medium' | 'high' — Use this field according to the endpoint schema.
    - `format` object — Use this field according to the endpoint schema.
  - `service_tier` 'auto' | 'standard_only' — Use this field according to the endpoint schema.
  - `stop_sequences` string[] — Use this field according to the endpoint schema.
  - `stream` boolean — Use this field according to the endpoint schema.
  - `system` string — Use this field according to the endpoint schema.
  - `temperature` number — Use this field according to the endpoint schema.
  - `thinking` object — Use this field according to the endpoint schema.
    - `type` 'enabled' | 'disabled' — Use this field according to the endpoint schema.
    - `budget_tokens` integer — Use this field according to the endpoint schema.
  - `tool_choice` object — Use this field according to the endpoint schema.
    - `type` 'auto' | 'any' | 'tool' | 'none' — Use this field according to the endpoint schema.
    - `name` string — Use this field according to the endpoint schema.
    - `disable_parallel_tool_use` boolean — Use this field according to the endpoint schema.
  - `tools` object[] — Use this field according to the endpoint schema.
    - `name` string — Use this field according to the endpoint schema.
    - `type` string — Use this field according to the endpoint schema.
    - `description` string — Use this field according to the endpoint schema.
    - `input_schema` object — Use this field according to the endpoint schema.
  - `top_k` integer — Use this field according to the endpoint schema.
  - `top_p` number — Use this field according to the endpoint schema.

## Response `200`

Successful Response

- object
  - `id` string, required — Use this field according to the endpoint schema.
  - `type` 'message', required — Use this field according to the endpoint schema.
  - `role` 'assistant', required — Use this field according to the endpoint schema.
  - `container` object — Use this field according to the endpoint schema.
    - `id` string — Use this field according to the endpoint schema.
    - `expires_at` string — Use this field according to the endpoint schema.
  - `model` string, required — Use this field according to the endpoint schema.
  - `content` object[], required — Use this field according to the endpoint schema.
    - `type` 'text' | 'thinking' | 'tool_use' — Use this field according to the endpoint schema.
    - `text` string — Use this field according to the endpoint schema.
    - `thinking` string — Use this field according to the endpoint schema.
    - `signature` string — Use this field according to the endpoint schema.
    - `id` string — Use this field according to the endpoint schema.
    - `name` string — Use this field according to the endpoint schema.
    - `input` object — Use this field according to the endpoint schema.
    - `citations` object[] — Use this field according to the endpoint schema.
  - `stop_reason` 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use' | 'pause_turn' | 'refusal', required — Use this field according to the endpoint schema.
  - `stop_sequence` string, nullable — Use this field according to the endpoint schema.
  - `usage` object, required — Use this field according to the endpoint schema.
    - `input_tokens` integer, required — Use this field according to the endpoint schema.
    - `output_tokens` integer, required — Use this field according to the endpoint schema.
    - `cache_creation_input_tokens` integer — Use this field according to the endpoint schema.
    - `cache_read_input_tokens` integer — Use this field according to the endpoint schema.
    - `cache_creation` object — Use this field according to the endpoint schema.
      - `ephemeral_5m_input_tokens` integer — Use this field according to the endpoint schema.
      - `ephemeral_1h_input_tokens` integer — Use this field according to the endpoint schema.
    - `inference_geo` string — Use this field according to the endpoint schema.
    - `server_tool_use` object — Use this field according to the endpoint schema.
      - `web_search_requests` integer — Use this field according to the endpoint schema.
      - `web_fetch_requests` integer — Use this field according to the endpoint schema.
    - `service_tier` string — Use this field according to the endpoint schema.

---

[API](https://skmtc.net/deerapi/apis/text-to-audio-api.md) · [All operations](https://skmtc.net/deerapi/apis/text-to-audio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deerapi/text-to-audio-api/versions/b6265ced74a1/schema)