Create a message

Creates a message using the Anthropic Messages API format. Set stream: true for server-sent events.

POST /v1/messages

cURL

basic

curl --request POST \
  --url https://api.abliteration.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "abliterated-model",
  "messages": [
    {
      "role": "user",
      "content": "Write one sentence about Stonehenge."
    }
  ],
  "max_tokens": 256
}
'

200

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "model": "abliterated-model",
  "content": [
    {
      "type": "text",
      "text": "Stonehenge is a prehistoric monument in Wiltshire, England, consisting of a ring of standing stones dating back to around 3000 BCE."
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 14,
    "output_tokens": 32
  },
  "remaining_credits": 487,
  "estimated_credits_used": 1,
  "estimated_cost_usd": 0.00023
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid request body."
  }
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Sign up to continue after your free request."
  }
}

{
  "type": "error",
  "error": {
    "type": "permission_error",
    "message": "Insufficient credits. Top up to keep chatting."
  }
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  }
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  }
}

Authorizations

BearerAuthAnthropicApiKeyAuth

Authorization · string · header · required

Use a JWT or abliteration.ai API key as a Bearer token.

Headers

X-Free-Tier · enum<string>

Set to true to use the single anonymous free request.

Available options: true

Body

application/json

model · string · required

Model id (e.g. abliterated-model).

messages · object[] · required

Non-empty array of message objects. Each has role (user or assistant) and content (string or content-block array).

Minimum array length: 1

Show child attributes

max_tokens · integer

Maximum number of tokens to generate.

Required range: x >= 1

temperature · number

Sampling temperature.

Required range: 0 <= x <= 2

stream · boolean · default: false

Enable Server-Sent Events streaming.

system · string object[]

System prompt. Can be a string or an array of content blocks.

flagged_categories · string[]

Optional moderation categories to block. Supported: harassment, hate, illicit, sexual. Self-harm and sexual/minors are always blocked.

Response

200

application/json

Message response

id · string · required

Unique message id (e.g. msg_01XFDUDYJgAACzvnptvVoYEL).

type · enum<string> · required

Available options: message

role · enum<string> · required

Available options: assistant

model · string · required

content · object[] · required

Option 1

Option 2

Show child attributes

stop_reason · string | null

Reason the model stopped generating (e.g. end_turn, max_tokens).

stop_sequence · string | null

usage · object

Show child attributes

remaining_credits · integer | null

User's remaining credit balance after this call.

estimated_credits_used · integer

Credits consumed by this call.

estimated_cost_usd · number

Estimated cost in USD.