Python SDK: Messages

Methods for the content-block Messages endpoint.

from syntic import Syntic
 
client = Syntic()  # reads SYNTIC_API_KEY

Methods

messages.create

Send content blocks and receive content blocks. Maps to POST /v1/messages.

result = client.messages.create(
    model="Amara S1.2",
    max_tokens=1024,
    messages=[{"role": "user", "content": [{"type": "text", "text": "Hello"}]}],
)

messages.stream

Stream typed events (content_block_delta, message_delta…) with a final-message accumulator. Maps to POST /v1/messages.

with client.messages.stream(
    model="Amara S1.2",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
) as stream:
    for event in stream:
        print(event)

messages.count_tokens

Count tokens for a Messages request. Maps to POST /v1/messages/count_tokens.

result = client.messages.count_tokens(
    model="Amara S1.2",
    messages=[{"role": "user", "content": "Hello"}],
)

Conventions

Every method accepts extra_headers, extra_query, extra_body and timeout keyword arguments, and has an async twin on AsyncSyntic. List methods return pages that iterate across all pages automatically.

See the Python SDK overview for installation, errors and retries.