Messages

POST /v1/messages serves the Anthropic Messages shape over the same memory wrapper as Chat, so an application built on the Anthropic SDK gets memory by changing its base URL.

curl https://api.anonalabs.com/v1/messages \
  -H "x-api-key: anona_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Anona-Space-Id: support-bot" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "What plan am I on?"}]
  }'

from anthropic import Anthropic

client = Anthropic(
    api_key="anona_live_YOUR_KEY",
    base_url="https://api.anonalabs.com",
    default_headers={"X-Anona-Space-Id": "support-bot"},
)

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=512,
    messages=[{"role": "user", "content": "What plan am I on?"}],
)
print(msg.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: "anona_live_YOUR_KEY",
  baseURL: "https://api.anonalabs.com",
  defaultHeaders: { "X-Anona-Space-Id": "support-bot" },
});

const msg = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 512,
  messages: [{ role: "user", content: "What plan am I on?" }],
});
console.log(msg.content[0].type === "text" ? msg.content[0].text : "");

The key can be sent as x-api-key (what the Anthropic SDK does) or as Authorization: Bearer, the same Anona key either way.

The shape is a wire format, not a provider: an Anthropic-shaped request does not mean Anthropic inference, and you never supply a provider key. model chooses from what this deployment serves. Omit it for the default, or name one from model selection; a model this deployment does not serve returns 400 unsupported_model.

Request

POST https://api.anonalabs.com/v1/messages
x-api-key: anona_live_...
Content-Type: application/json

{
  "model": "claude-sonnet-4-6",
  "space_id": "support-bot",
  "max_tokens": 512,
  "system": "Answer in one sentence.",
  "messages": [
    { "role": "user", "content": "What plan am I on?" }
  ]
}

Field	Type	Default	Description
`messages`	array	required	Each `content` is a string or a list of typed blocks; text blocks are used, others are skipped.
`max_tokens`	integer	required	Required by this API shape, and forwarded to the model.
`system`	string or array	none	Becomes the system prompt. The memory block is prepended to it.
`model`	string	deployment default	Optional.
`stream`	boolean	`false`	Emit the Anthropic event stream.
`temperature`	float	none	Optional.

All memory tunables apply here, in the body or as X-Anona-* headers.

Response

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "You're on the Scale plan." }],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": { "input_tokens": 42, "output_tokens": 9 },
  "memories_injected": 3,
  "space_id": "support-bot"
}

memories_injected and space_id are the Anona additions, and also arrive as the X-Anona-Memories-Injected and X-Anona-Space-Id response headers.

Streaming

"stream": true emits the Anthropic named-event sequence:

message_start
content_block_start
content_block_delta      ← one per token, {"type": "text_delta", "text": "..."}
content_block_stop
message_delta            ← stop_reason and output token count
message_stop

curl -N https://api.anonalabs.com/v1/messages \
  -H "x-api-key: anona_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Anona-Space-Id: support-bot" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "What plan am I on?"}],
    "stream": true
  }'

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=512,
    messages=[{"role": "user", "content": "What plan am I on?"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="")

const stream = client.messages.stream({
  model: "claude-sonnet-4-6",
  max_tokens: 512,
  messages: [{ role: "user", content: "What plan am I on?" }],
});
stream.on("text", (text) => process.stdout.write(text));
await stream.finalMessage();

As on Chat, a failure before the first token is a normal JSON error with a real status code; the turn is recorded and billed after the stream ends.

Getting Started

For Agents

API Essentials

Memory (data plane)

LLM Proxy (drop-in)

Account (control plane)

SDKs & MCP

Integrations

Guides

Use Cases

Legal

Changelog

Request

Response

Streaming

​Request

​Response

​Streaming

Request

Response

Streaming