Chat

Developing

POST

/v1/messages

Basic text conversation, only supports Claude series models

Supports thinking mode, the thinking parameter needs to be set. Example:
“thinking”:
{
"type": "enabled",
"budget_tokens": 2048
}

Request

Header Params

Body Params application/json

Example

{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Hello, world"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/messages' \
--header 'Authorization: {{Authorization}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Hello, world"
        }
    ]
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
    "id": "chatcmpl-0f8b6c6e-6f17-4dec-a6fd-aba277e7119b",
    "type": "message",
    "role": "assistant",
    "content": [
        {
            "type": "text",
            "text": "Hello! I'm here to help you with your coding tasks. How can I assist you today? Whether you need help with creating new code, debugging existing code, or have any programming-related questions, I'm ready to help!"
        }
    ],
    "stop_reason": "end_turn",
    "model": "claude-3.5-sonnet",
    "usage": {
        "input_tokens": 10,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "output_tokens": 46
    }
}

Modified at 2026-10-19 10:10:04

Text embeddings

Chat(prompt cache)