Chat

Chat completion endpoints (OpenAI-compatible).

List chat completions

get

List chat completions captured in telemetry, scoped to the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Query parameters

limitinteger · min: 1 · max: 100OptionalDefault: 20

offsetintegerOptionalDefault: 0

modelany ofOptional

stringOptional

or

nullOptional

containerany ofOptional

stringOptional

or

nullOptional

orderstring · enumOptionalDefault: descPossible values:

Body

application/json

or

nullOptional

Responses

200

Successful Response

application/json

OpenAI-style list response for chat completions.

objectconst: listOptional

Object type identifier.

Default: list

totalintegerRequired

Total number of items available for this resource.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

get

/v1/chat/completions

HTTPcURLJavaScriptPython

GET /v1/chat/completions HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

{
  "object": "list",
  "data": [
    {
      "choices": [
        {
          "finish_reason": "stop",
          "index": 0,
          "message": {
            "content": "Hello!",
            "role": "assistant"
          }
        }
      ],
      "created": 1710000000,
      "id": "chatcmpl-123",
      "model": "openai/gpt-4o",
      "object": "chat.completion"
    }
  ],
  "total": 0
}

Create a chat completion

post

Create a chat completion using the specified model.

Supports both streaming and non-streaming responses and is compatible with OpenAI's chat completions API. Use a container slug (maniac:<container>) or an external slug (e.g. openai/gpt-4o). / and : are treated equivalently on input.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

OpenAI-compatible chat completion request with Maniac extensions.

modelany ofOptional

Model slug to use. Supports global slugs and container routes; / and : are treated equivalently on input.

Example: openai/gpt-4o

stringOptional

or

nullOptional

modelsany ofOptional

Fallback models.

string[]Optional

or

nullOptional

frequency_penaltyany ofOptional

Frequency penalty.

numberOptional

or

nullOptional

logit_biasany ofOptional

Logit bias.

or

nullOptional

logprobsany ofOptional

Include logprobs.

booleanOptional

or

nullOptional

top_logprobsany ofOptional

Top logprobs.

numberOptional

or

nullOptional

max_completion_tokensany ofOptional

Max completion tokens.

numberOptional

or

nullOptional

max_tokensany ofOptional

Max tokens.

numberOptional

or

nullOptional

metadataany ofOptional

Arbitrary key/value metadata to attach to the request.

Example: {"source":"dashboard"}

or

nullOptional

presence_penaltyany ofOptional

Presence penalty.

numberOptional

or

nullOptional

reasoningany ofOptional

Reasoning config.

or

nullOptional

response_formatany ofOptional

Response format.

or

or

or

nullOptional

seedany ofOptional

Random seed.

integerOptional

or

nullOptional

stopany ofOptional

Stop sequences.

stringOptional

or

string[]Optional

or

nullOptional

streamany ofOptional

Stream response.

Default: false

booleanOptional

or

nullOptional

stream_optionsany ofOptional

Stream options.

or

nullOptional

temperatureany ofOptional

Temperature.

numberOptional

or

nullOptional

tool_choiceany ofOptional

Tool choice.

string · enumOptionalPossible values:

or

or

nullOptional

toolsany ofOptional

Tools.

or

nullOptional

top_pany ofOptional

Top p.

numberOptional

or

nullOptional

tagsstring[]Optional

Optional tags for tracking.

Example: []

storeany ofOptional

Whether to store the completion in the database.

Default: true

booleanOptional

or

nullOptional

traceany ofOptional

Optional external trace/span context used to group related requests across containers.

or

nullOptional

Responses

200

Server-Sent Events stream for streaming responses.

application/jsontext/event-stream

idstringRequired

Completion id.

creatednumberRequired

Creation timestamp (unix).

modelstringRequired

Model used.

objectconst: chat.completionOptional

Object type.

Default: chat.completion

usageany ofOptional

Token usage.

or

nullOptional

providerany ofOptional

Upstream provider name, if available.

stringOptional

or

nullOptional

containerany ofOptional

Container label used for routing, if any.

stringOptional

or

nullOptional

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

post

/v1/chat/completions

HTTPcURLJavaScriptPython

POST /v1/chat/completions HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 88

{
  "messages": [
    {
      "content": "Hello!",
      "role": "user"
    }
  ],
  "model": "openai/gpt-4o",
  "stream": false
}

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "Hello!",
        "role": "assistant"
      }
    }
  ],
  "created": 1710000000,
  "id": "chatcmpl-123",
  "model": "openai/gpt-4o",
  "object": "chat.completion"
}

Get a chat completion

get

Fetch a single chat completion by id within the authenticated project.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Path parameters

completion_idstringRequired

Responses

200

Successful Response

application/json

idany ofOptional

Completion id.

stringOptional

or

nullOptional

createdany ofOptional

Creation timestamp (unix seconds).

anyOptional

or

nullOptional

modelany ofOptional

Model slug used.

stringOptional

or

nullOptional

objectconst: chat.completionOptional

Object type.

Default: chat.completion

usageany ofOptional

Token usage.

or

nullOptional

providerany ofOptional

Upstream provider name, if available.

stringOptional

or

nullOptional

containerany ofOptional

Container label used for routing, if any.

stringOptional

or

nullOptional

model_idany ofOptional

Model ID (uuid).

stringOptional

or

nullOptional

spendany ofOptional

Estimated spend.

numberOptional

or

nullOptional

tagsany ofOptional

Tags for this completion.

string[]Optional

or

nullOptional

metadataany ofOptional

Metadata for this completion.

or

nullOptional

traceany ofOptional

Optional external trace/span context associated with this completion.

or

nullOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

get

/v1/chat/completions/{completion_id}

HTTPcURLJavaScriptPython

GET /v1/chat/completions/{completion_id} HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "Hello!",
        "role": "assistant"
      }
    }
  ],
  "created": 1710000000,
  "id": "chatcmpl-123",
  "model": "openai/gpt-4o",
  "object": "chat.completion"
}

Register chat completion examples

post

Register completed chat examples for evaluation and analytics.

This endpoint accepts input/output pairs and stores them for later analysis, while aggregating usage metrics for reporting.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

API key in Authorization header using Bearer .

Body

application/json

Register completed chat examples for evaluation or analytics.

containerstringRequired

Container label to associate these examples with.

Example: maniac:my-container

Responses

200

Successful Response

application/json

okbooleanRequired

Whether the register operation succeeded.

containerstringRequired

Container label used for registration.

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

409

Conflict

application/json

422

Validation Error

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

501

Not Implemented

application/json

503

Upstream Unavailable

application/json

post

/v1/chat/completions/register

HTTPcURLJavaScriptPython

POST /v1/chat/completions/register HTTP/1.1
Host: platform.maniac.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 410

{
  "items": [
    {
      "input": {
        "messages": [
          {
            "content": "Hello!",
            "role": "user"
          }
        ],
        "model": "openai/gpt-4o",
        "stream": false
      },
      "output": {
        "choices": [
          {
            "finish_reason": "stop",
            "index": 0,
            "message": {
              "content": "Hello!",
              "role": "assistant"
            }
          }
        ],
        "created": 1710000000,
        "id": "chatcmpl-123",
        "model": "openai/gpt-4o",
        "object": "chat.completion"
      },
      "tags": [
        "text"
      ],
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "container": "maniac:my-container"
}

{
  "container": "maniac:my-container",
  "errors": [],
  "ok": true,
  "summary": {
    "inserted": 10,
    "skipped": 0
  }
}