Messages

Overview

Available Operations

• create - Create message (Claude native API)

create

Create a message using Anthropic Claude’s native API format, supports streaming

Example Usage

from r9s import R9S


with R9S(api_key=os.getenv("R9S_API_KEY",""),) as r9_s:

    res = r9_s.messages.create(model="claude-opus-4.5", messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Hello, Claude!",
                },
            ],
        },
    ], max_tokens=1024, stream=False)


    for event in res:
        # handle event
        print(event, flush=True)

Parameters

Parameter	Type	Required	Description
model	str	:heavy_check_mark:	Claude model name
messages	Array	:heavy_check_mark:	Messages list, first message must be a user message
max_tokens	int	:heavy_check_mark:	Maximum number of output tokens
system	str	:heavy_minus_sign:	System prompt
stop_sequences	Array	:heavy_minus_sign:	Stop sequences
stream	bool	:heavy_minus_sign:	N/A
temperature	float	:heavy_minus_sign:	N/A
top_p	float	:heavy_minus_sign:	N/A
top_k	int	:heavy_minus_sign:	N/A
tools	Array	:heavy_minus_sign:	N/A
tool_choice	object	:heavy_minus_sign:	N/A
retries	object	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

CreateMessageResponse

Errors

Error Type	Status Code	Content Type
errors.BadRequestError	400	application/json
errors.AuthenticationError	401	application/json
errors.PermissionDeniedError	403	application/json
errors.UnprocessableEntityError	422	application/json
errors.RateLimitError	429	application/json
errors.InternalServerError	500	application/json
errors.ServiceUnavailableError	503	application/json
errors.R9SDefaultError	4XX, 5XX	*/*