Create an Anthropic message

POST

messages

curl --request POST \
  --url https://api.aixy-gateway.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <anthropic-version>' \
  --data '
{
  "model": "anthropic/claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Explain this code."
    }
  ]
}
'

import requests

url = "https://api.aixy-gateway.com/v1/messages"

payload = {
    "model": "anthropic/claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Explain this code."
        }
    ]
}
headers = {
    "anthropic-version": "<anthropic-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'anthropic-version': '<anthropic-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'anthropic/claude-sonnet-4-5',
    max_tokens: 1024,
    messages: [{role: 'user', content: 'Explain this code.'}]
  })
};

fetch('https://api.aixy-gateway.com/v1/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "<string>"
    }
  ],
  "model": "<string>",
  "usage": {},
  "stop_reason": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

Authorizations

Authorization

string

header

required

A project-scoped Aixy API key. Create keys in the dashboard and send the secret as a Bearer token.

Headers

X-Request-ID

string

Optional caller-generated request identifier for end-to-end tracing.

Maximum string length: 255

X-Aixy-Client

string

Optional application[/version] for Activity attribution. Overrides User-Agent detection. Use a product name, not personal data or credentials. Names are 1-64 ASCII letters, digits, spaces, dots, underscores or hyphens, starting with a letter or digit. Optional versions start with a digit and use up to 32 letters, digits, dots, underscores, plus signs or hyphens. Invalid values are ignored. This self-declared label grants no permissions and is not forwarded.

Maximum string length: 97

Example:

"Acme Support/1.2.3"

X-Aixy-Session

string

Optional opaque session identifier for virtual routes with session affinity. Scoped to the authenticated caller and alias; never forwarded or recorded. Send full conversation history. Invalid values return 400 when affinity is enabled. Omission retains the route's normal strategy.

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9._:-]+$

Example:

"conversation-82"

X-Aixy-Session-ID

string

Optional opaque conversation identifier recorded in Activity metadata. Reuse it for every call in a conversation. Sessions are isolated by organization, project, user and API key. Use no personal data or secrets. Invalid values are ignored. The header is not forwarded, grants no permissions and does not change routing affinity.

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9._:-]+$

Example:

"conversation-82"

anthropic-version

string

required

Anthropic client contract version; forwarded unchanged on native requests. Reviewed Bedrock InvokeModel routes use the required upstream envelope version.

Example:

"2023-06-01"

anthropic-beta

string

Comma-separated Anthropic beta features, forwarded on matching native requests. Reviewed destination compatibility rules may omit unused beta announcements; unsupported features in use fail explicitly. Repeated headers are additive. Preserved Bedrock InvokeModel routes carry beta features in the upstream envelope. Translated routes reject unsupported beta features.

Body

application/json

model

string

required

Provider-qualified Anthropic model identifier.

Example:

"anthropic/claude-sonnet-4-5"

max_tokens

integer

required

Required range: x >= 1

messages

object[]

required

Show child attributes

system

stream

boolean

default:false

temperature

number

tools

object[]

Response

Successful Anthropic response.

string

required

type

enum<string>

required

Available options:

message

role

enum<string>

required

Available options:

assistant

content

object[]

required

Show child attributes

model

string

required

usage

object

required

stop_reason

string | null

Create an Anthropic message

curl --request POST \
  --url https://api.aixy-gateway.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <anthropic-version>' \
  --data '
{
  "model": "anthropic/claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Explain this code."
    }
  ]
}
'

import requests

url = "https://api.aixy-gateway.com/v1/messages"

payload = {
    "model": "anthropic/claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [
        {
            "role": "user",
            "content": "Explain this code."
        }
    ]
}
headers = {
    "anthropic-version": "<anthropic-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'anthropic-version': '<anthropic-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'anthropic/claude-sonnet-4-5',
    max_tokens: 1024,
    messages: [{role: 'user', content: 'Explain this code.'}]
  })
};

fetch('https://api.aixy-gateway.com/v1/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "<string>"
    }
  ],
  "model": "<string>",
  "usage": {},
  "stop_reason": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Gateway API key is invalid or revoked"
  },
  "request_id": "req_01H..."
}

users

authentication

privacy

activity

api-keys

audit

identity connections

billing

cost-optimization

cost-control

custom domains

data processing

feature flags

system

guardrails

operations

MCP beta

metrics

monitors

organizations

playground

pricing

projects

provider-catalog

provider-credentials

provider-models

roles

routing

teams

telemetry exports

inference

models

Create an Anthropic message

Authorizations

Headers

Body

Response