Skip to main content
POST
/
openai
/
chat
/
completions
Chat Completions
import requests

url = "https://api.opper.ai/v2/openai/chat/completions"

payload = {
    "messages": [
        {
            "content": "<string>",
            "role": "<string>",
            "name": "<string>"
        }
    ],
    "stream": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
{
  "id": "<string>",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 123,
      "logprobs": {
        "content": [
          {
            "token": "<string>",
            "bytes": [
              123
            ],
            "logprob": 123,
            "top_logprobs": [
              {}
            ]
          }
        ],
        "refusal": [
          {
            "token": "<string>",
            "bytes": [
              123
            ],
            "logprob": 123,
            "top_logprobs": [
              {}
            ]
          }
        ]
      },
      "message": {
        "content": "<string>",
        "refusal": "<string>",
        "role": "<string>",
        "annotations": [
          {
            "type": "<string>",
            "url_citation": {
              "end_index": 123,
              "start_index": 123,
              "title": "<string>",
              "url": "<string>"
            }
          }
        ],
        "audio": {
          "id": "<string>",
          "data": "<string>",
          "expires_at": 123,
          "transcript": "<string>"
        },
        "function_call": {
          "arguments": "<string>",
          "name": "<string>"
        },
        "tool_calls": [
          {
            "id": "<string>",
            "function": {
              "arguments": "<string>",
              "name": "<string>"
            },
            "type": "<string>"
          }
        ]
      }
    }
  ],
  "created": 123,
  "model": "<string>",
  "object": "<string>",
  "service_tier": "auto",
  "system_fingerprint": "<string>",
  "usage": {
    "completion_tokens": 123,
    "prompt_tokens": 123,
    "total_tokens": 123,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 123,
      "audio_tokens": 123,
      "reasoning_tokens": 123,
      "rejected_prediction_tokens": 123
    },
    "prompt_tokens_details": {
      "audio_tokens": 123,
      "cached_tokens": 123
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
  • ChatCompletionNonStreaming
  • ChatCompletionStreaming
​
messages
Messages · array
required
  • ChatCompletionDeveloperMessageParam
  • ChatCompletionSystemMessageParam
  • ChatCompletionUserMessageParam
  • ChatCompletionAssistantMessageParam
  • ChatCompletionToolMessageParam
  • ChatCompletionFunctionMessageParam
​
model
​
audio
object | null
​
frequency_penalty
number | null
​
function_call
Available options:
none,
auto
​
functions
Function · object[]
​
logit_bias
object | null
​
logprobs
boolean | null
​
max_completion_tokens
integer | null
​
max_tokens
integer | null
​
metadata
object | null
​
modalities
enum<string>[] | null
​
n
integer | null
​
parallel_tool_calls
boolean
​
prediction
object | null
​
presence_penalty
number | null
​
prompt_cache_key
string
​
reasoning_effort
enum<string> | null
Available options:
minimal,
low,
medium,
high
​
response_format
object
  • ResponseFormatText
  • ResponseFormatJSONSchema
  • ResponseFormatJSONObject
​
safety_identifier
string
​
seed
integer | null
​
service_tier
enum<string> | null
Available options:
auto,
default,
flex,
scale,
priority
​
stop
​
store
boolean | null
​
stream_options
object | null
​
temperature
number | null
​
tool_choice
Available options:
none,
auto,
required
​
tools
Tools · array
  • ChatCompletionFunctionToolParam
  • ChatCompletionCustomToolParam
​
top_logprobs
integer | null
​
top_p
number | null
​
user
string
​
verbosity
enum<string> | null
Available options:
low,
medium,
high
​
web_search_options
object
​
stream
boolean | null
​
tags
object | null
​
parent_span_id
string<uuid> | null

Response

Successful Response

​
id
string
required
​
choices
Choice · object[]
required
​
created
integer
required
​
model
string
required
​
object
string
required
Allowed value: "chat.completion"
​
service_tier
enum<string> | null
Available options:
auto,
default,
flex,
scale,
priority
​
system_fingerprint
string | null
​
usage
object | null