AIAI Gateway/API-dokumentaatio/Chat Completions

OpenAI Chat Completions API

Käytä OpenAI Chat Completions API:ta keskusteluihin. Tämä on klassinen OpenAI-keskustelu-API-muoto.

Päätepiste

POST/api/ai/v1/chat/completions

Todennus

AuthorizationPakollinen

Bearer YOUR_API_KEY

Pyyntö

Parametri	Tyyppi	Pakollinen	Kuvaus
`model`	string	Pakollinen	Mallin nimi, esim. deepseek-v4.1-flash, qwen3.8-max
`messages`	array	Pakollinen	Viestitaulukko muodossa
`max_tokens`	integer	Valinnainen	Tulostokenien enimmäismäärä
`temperature`	float	Valinnainen	Otantalämpötila, säätää satunnaisuutta (0-2)
`stream`	boolean	Valinnainen	Ota suoratoistovaste käyttöön, aseta true SSE:tä varten

Vastaus

Parametri	Tyyppi	Kuvaus
`id`	string	Yksilöllinen vastaustunniste
`model`	string	Todellinen käytetty malli
`choices`	array	Vastausvaihtoehtojen taulukko, yleensä käytä ensimmäistä
`usage`	object	Tokenien käyttötilastot

Esimerkit

cURL

curl --location 'https://your-domain.com/api/ai/v1/chat/completions' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "Hello, who are you?"}
    ],
    "max_tokens": 1000,
    "temperature": 0.7
  }'

Python

import requests

response = requests.post(
    "https://your-domain.com/api/ai/v1/chat/completions",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY"
    },
    json={
        "model": "deepseek-v4.1-flash",
        "messages": [
            {"role": "user", "content": "Hello, who are you?"}
        ],
        "max_tokens": 1000,
        "temperature": 0.7
    }
)
print(response.json())

Suoratoistoesimerkki

curl --location 'https://your-domain.com/api/ai/v1/chat/completions' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Hello"}],
    "max_tokens": 1000,
    "stream": true
  }'

← Responses Anthropic Messages →

Pyyntö

Parametri	Tyyppi	Pakollinen	Kuvaus
`model`	string	Pakollinen	Mallin nimi, esim. deepseek-v4.1-flash, qwen3.8-max
`messages`	array	Pakollinen	Viestitaulukko muodossa
`max_tokens`	integer	Valinnainen	Tulostokenien enimmäismäärä
`temperature`	float	Valinnainen	Otantalämpötila, säätää satunnaisuutta (0-2)
`stream`	boolean	Valinnainen	Ota suoratoistovaste käyttöön, aseta true SSE:tä varten

Parametri

Tyyppi

Kuvaus

id

string

Yksilöllinen vastaustunniste

model

string

Todellinen käytetty malli

choices

array

Vastausvaihtoehtojen taulukko, yleensä käytä ensimmäistä

usage

object

Tokenien käyttötilastot

Esimerkit

cURL

curl --location 'https://your-domain.com/api/ai/v1/chat/completions' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "Hello, who are you?"}
    ],
    "max_tokens": 1000,
    "temperature": 0.7
  }'

Python

import requests

response = requests.post(
    "https://your-domain.com/api/ai/v1/chat/completions",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY"
    },
    json={
        "model": "deepseek-v4.1-flash",
        "messages": [
            {"role": "user", "content": "Hello, who are you?"}
        ],
        "max_tokens": 1000,
        "temperature": 0.7
    }
)
print(response.json())

Suoratoistoesimerkki

curl --location 'https://your-domain.com/api/ai/v1/chat/completions' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Hello"}],
    "max_tokens": 1000,
    "stream": true
  }'