`POST /v1/chat/completions`

Siliqun Rotor serves a supported subset of the OpenAI chat-completions wire at this endpoint. A decided tool route returns an OpenAI-shaped tool_calls response; the accompanying siliq object reports Siliqun Rotor-specific outcome information. Check the contract with the client and features you plan to use.

Capabilities

Routes against the function names, descriptions, and parameter schemas in tools.
Returns a function call with JSON-string arguments when a tool is selected.
Leaves missing-parameter asks and refusals without a tool call by default.
Includes the Siliqun Rotor outcome and evidence under siliq.

Example cURL Request

If API-key authentication is enabled for your engine, add -H "Authorization: Bearer $SILIQUN_ROTOR_KEY" to the request.

curl -X POST http://127.0.0.1:8700/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "siliqun-rotor",
    "messages": [
      {"role": "user", "content": "What is the weather in Berlin?"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Fetch weather forecast for a city",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {"type": "string"}
            },
            "required": ["city"]
          }
        }
      }
    ]
  }'

The Response:

{
  "id": "<generated-id>",
  "object": "chat.completion",
  "model": "siliqun-rotor",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_weather_01",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"city\":\"Berlin\"}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ],
  "siliq": {"outcome": "decided"}
}

The response is abbreviated; generated IDs and timestamps vary. The consuming application remains responsible for checking authorization and executing the tool call.