OpenAI Responses API (v1/responses)

Include your credentials in the Authorization header as a Bearer token.

• API key — keys start with ak_. Send as Authorization: Bearer ak_....
• JWT — obtained from POST /api/auth/login. Send as Authorization: Bearer <jwt>.
• Anonymous free tier — omit the token and set the X-Free-Tier: true header. Limited to 1 free request per device.

curl -X POST https://api.abliteration.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ak_YOUR_API_KEY" \
  -d '{
    "model": "abliterated-model",
    "input": "Hello, world!"
  }'

Use a plain string for simple text prompts, or send a structured array when you need multimodal inputs, prior turns, or tool-related state.

For images, use input_image parts. Video inputs are not supported.

{
  "model": "abliterated-model",
  "instructions": "Answer in two sentences.",
  "input": [
    {
      "role": "user",
      "content": [
        { "type": "input_text", "text": "What is shown in this image?" },
        { "type": "input_image", "image_url": "https://example.com/stonehenge.jpg" }
      ]
    }
  ],
  "max_output_tokens": 256
}

When stream is false (default), the full response is returned as JSON.

abliteration.ai adds the same billing fields used by the other public inference endpoints: remaining_credits, estimated_credits_used, and estimated_cost_usd.

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1735958400,
  "status": "completed",
  "model": "abliterated-model",
  "output": [
    {
      "id": "msg_abc123",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Abliteration removes refusal vectors from language models while preserving their broader capabilities.",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 31,
    "output_tokens": 18,
    "total_tokens": 49
  },
  "remaining_credits": 487,
  "estimated_credits_used": 1,
  "estimated_cost_usd": 0.000245
}

Set stream: true to receive Responses-style Server-Sent Events. Each event includes an event: line and a JSON data: payload.

Typical event types include response.created, response.output_text.delta, and response.completed.

curl -N https://api.abliteration.ai/v1/responses \
  -H "Authorization: Bearer $ABLIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "abliterated-model",
    "input": "Write a five-word greeting.",
    "stream": true
  }'

event: response.created
data: {"type":"response.created","response":{"id":"resp_abc123","object":"response","status":"in_progress","model":"abliterated-model","output":[]}}

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Hello from abliteration.ai"}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_abc123","object":"response","status":"completed","model":"abliterated-model"}}

Limits are enforced per user in a rolling 60-second window. Exceeding the limit returns 429 with a Retry-After header.

• API key callers: 120 requests per 60-second window.
• UI / JWT callers: 30 requests per 60-second window.
• Rate-limiter failures are fail-open — requests are allowed but the incident is logged.

Each call consumes credits based on total tokens (input + output). Credits are deducted after the response completes.

• Minimum charge is 1 credit per call.
• Credits per call: ceil(total_tokens / 500).
• Pricing: ~$5 per 1 M tokens. See the pricing page for current plans.
• Anonymous free-tier calls do not consume credits.
• If credits are insufficient, the endpoint returns 402.

Machine-readable specs and ready-made collections for faster integration.

• OpenAPI 3.0 spec — import into Swagger UI, Redocly, or any OpenAPI-compatible tool.
• Well-known OpenAPI discovery — /.well-known/openapi.json for automated tooling.
• Postman collection & OpenAPI guide — pre-built Postman collection with environment variables.
• OpenAI compatibility guide — migrate existing OpenAI clients with a base URL swap.