Skip to main content
POST
/
v1
/
chat
/
completions
curl --request POST \
  --url https://api.caprioletech.com/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "openai/gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Hello World!"
    }
  ]
}
'
{
  "id": "<string>",
  "object": "chat.completion",
  "created": 123,
  "model": "<string>",
  "choices": [
    {}
  ],
  "usage": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.capriole.ai/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint when your application, SDK, or gateway expects the OpenAI Chat Completions request and response format. Send a standard Chat Completions payload with model and messages. Capriole AI rewrites the model value to the selected provider model ID, forwards compatible fields such as messages, tools, tool_choice, response_format, and stream, and returns the upstream JSON or SSE stream unchanged. For streaming requests, Capriole AI sets stream_options.include_usage=true before forwarding so usage can be recorded. For Capriole-native text generation, use POST /v1/chat. Use POST /v1/chat/completions when OpenAI-compatible wire behavior is required.

Authorizations

​
Authorization
string
header
required

Use an API key created in the Capriole AI page. Send it as Authorization: Bearer sk-....

Body

application/json
​
model
enum<string>
required

Public model identifier returned by GET /v1/models

Available options:
openai/gpt-5.5,
openai/gpt-5.4-mini,
anthropic/claude-opus-4-8,
anthropic/claude-opus-4-7,
google/gemini-3.1-pro-preview,
google/gemini-3.5-flash
​
messages
object[]
required

OpenAI-compatible conversation messages.

​
tools
object[]

OpenAI-compatible tool definitions.

​
tool_choice

OpenAI-compatible tool choice.

​
response_format
object

OpenAI-compatible response format.

​
stream
boolean
default:false

Stream the response as OpenAI-compatible server-sent events.

​
stream_options
object

OpenAI-compatible stream options. For streaming requests, Capriole AI sets include_usage=true before upstream dispatch for usage accounting.

Response

OpenAI-compatible Chat Completions response or SSE stream

​
id
string
required
​
object
string
required
Example:

"chat.completion"

​
created
integer
required
​
model
string
required
​
choices
object[]
required
​
usage
object