Documentation

Messages

Updated: Nov 11, 2026

Method and Path

POST
/v1/messages

Authorization

See API Guide - Authentication.

Header Parameters

See API Guide - Common Request Headers.

HeaderRequiredDescription
anthropic-versionNoAnthropic API version. The official Anthropic SDK sends it automatically.

Request Body

application/json
  1. body
model*string

Model ID, e.g. deepseek-v4-flash.

messages*array<>

List of conversation messages; each item has role and content.

max_tokens*integer

Maximum number of tokens to generate.

Range1 <= value
system?|array<>

System prompt, passed separately from messages.

temperature?number

Sampling temperature.

Range0 <= value <= 1
top_p?number

Nucleus sampling parameter.

top_k?integer

Top-K sampling parameter.

stream?boolean

Whether to stream the response.

stop_sequences?array<string>

Stop sequences.

tools?array<>

Tool definitions.

tool_choice?

Tool choice strategy.

thinking?

Thinking / reasoning configuration.

metadata?

Metadata.

Response Body

Successful response

application/json
  1. response
id?string

Message ID.

type?string

Object type.

role?string

Message role.

content?array<>

List of content blocks.

model?string

ID of the model actually used.

stop_reason?string

Stop reason.

usage?

Token usage statistics.

Example Request
curl -X POST 'https://api.cysuo.com/v1/messages' \  -H 'Content-Type: application/json' \  -d '{  "model": "deepseek-v4-flash",  "max_tokens": 1024,  "messages": [    {      "role": "user",      "content": "Hello, please introduce yourself."    }  ]}'
Example Response200
{  "id": "string",  "type": "string",  "role": "string",  "content": [    {      "type": "string",      "text": "string"    }  ],  "model": "string",  "stop_reason": "string",  "usage": {    "input_tokens": 0,    "output_tokens": 0,    "cache_creation_input_tokens": 0,    "cache_read_input_tokens": 0  }}