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
messages
Messages · array
required
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
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
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