POST /v1/chat/completions: OpenAI-compatible chat inference

Send chat completion requests to the Aria Compute ROUTER using the standard OpenAI API shape. The router matches the model field to a configured entrypoint, then routes the request through the semantic or agent engine.

Endpoint

POST /v1/chat/completions Data plane endpoint. Authenticate with Authorization: Bearer <router-key>.

Request body

string

required

The entrypoint name to route through (for example, ariacompute/semantic-auto). Must match a configured entrypoint.

array

required

Array of message objects with role and content fields, following the OpenAI chat format.

boolean

default:"false"

If true, the response is streamed as server-sent events (SSE).

number

Sampling temperature between 0 and 2.

integer

Maximum number of tokens to generate.

array

Array of tool definitions for function calling.

Response

array

Generated completion choices. Exact shape follows the standard OpenAI chat completions format.

Example (non-streaming)

curl -H 'Authorization: Bearer $ARIA_ROUTER_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ariacompute/semantic-auto",
    "messages": [{"role": "user", "content": "Hello"}],
    "temperature": 0.7
  }' \
  http://<router-host>:8080/v1/chat/completions

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "ariacompute/semantic-auto",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ]
}

Example (streaming)

curl -H 'Authorization: Bearer $ARIA_ROUTER_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "ariacompute/semantic-auto",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }' \
  http://<router-host>:8080/v1/chat/completions

data: {"id":"chatcmpl-...","object":"chat.completion.chunk", ... }

data: [DONE]

PIN API

ROUTER API

AGENT API

POST /v1/chat/completions: OpenAI-compatible chat inference

Endpoint

Request body

Response

Example (non-streaming)

Example (streaming)

​Endpoint

​Request body

​Response

​Example (non-streaming)

​Example (streaming)

Endpoint

Request body

Response

Example (non-streaming)

Example (streaming)