Create a chat completion

Creates a chat completion. Set stream: true for server-sent events.

POST /v1/chat/completions

cURL

basic

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

200

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1735958400,
  "model": "abliterated-model",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello there. How can I help?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  },
  "remaining_credits": 48,
  "estimated_credits_used": 1,
  "estimated_cost_usd": 0.000105
}

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

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

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

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

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

Authorizations

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.

messages · object[] · required

Conversation messages. content can be a string or a list of parts for multimodal requests.

Show child attributes

temperature · number

Sampling temperature.

Required range: 0 <= x <= 2

top_p · number

Required range: 0 <= x <= 1

n · integer

Required range: x >= 1

stream · boolean · default: false

max_tokens · integer

Required range: x >= 1

stop · string string[]

presence_penalty · number

Required range: -2 <= x <= 2

frequency_penalty · number

Required range: -2 <= x <= 2

user · string

End-user identifier for abuse monitoring.

flagged_categories · string[]

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

Response

200

application/json

Chat completion response

id · string · required

object · enum<string> · required

Available options: chat.completion

created · integer · required

model · string · required

choices · object[] · required

Show child attributes

usage · object

Show child attributes

remaining_credits · integer | null

estimated_credits_used · integer

estimated_cost_usd · number