AIAI Gateway/API-dokumentaatio/Responses

OpenAI Responses API

Käytä OpenAI Responses API:ta keskusteluihin. Responses API on uusin OpenAI API -muoto joustavammalla syötteellä.

Päätepiste

POST/api/ai/v1/responses

Todennus

AuthorizationPakollinen

Bearer YOUR_API_KEY

Pyyntö

Parametri	Tyyppi	Pakollinen	Kuvaus
`model`	string	Pakollinen	Mallin nimi, esim. deepseek-v4.1-flash, qwen3.8-max
`input`	string	Pakollinen	Syöteteksti tai keskustelun sisältö
`max_tokens`	integer	Valinnainen	Tulostokenien enimmäismäärä
`temperature`	float	Valinnainen	Näytteenottolämpötila, ohjaa satunnaisuutta (0-2)
`stream`	boolean	Valinnainen	Ota suoratoistovastaus käyttöön, aseta true SSE:tä varten

Vastaus

Parametri	Tyyppi	Kuvaus
`id`	string	Yksilöllinen vastauksen tunniste
`model`	string	Todellinen käytetty malli
`output`	string	Luotu tekstituloste
`usage`	object	Tokenien käyttötilastot, mukaan lukien prompt_tokens, completion_tokens, total_tokens

Esimerkit

cURL

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

Python

import requests

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

Suoratoistoesimerkki

curl --location 'https://your-domain.com/api/ai/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "deepseek-v4.1-flash",
    "input": "Hello",
    "max_tokens": 1000,
    "stream": true
  }'

← Takaisin dokumentaatioon Chat Completions →

Pyyntö

Parametri	Tyyppi	Pakollinen	Kuvaus
`model`	string	Pakollinen	Mallin nimi, esim. deepseek-v4.1-flash, qwen3.8-max
`input`	string	Pakollinen	Syöteteksti tai keskustelun sisältö
`max_tokens`	integer	Valinnainen	Tulostokenien enimmäismäärä
`temperature`	float	Valinnainen	Näytteenottolämpötila, ohjaa satunnaisuutta (0-2)
`stream`	boolean	Valinnainen	Ota suoratoistovastaus käyttöön, aseta true SSE:tä varten

Parametri

Tyyppi

Kuvaus

id

string

Yksilöllinen vastauksen tunniste

model

string

Todellinen käytetty malli

output

string

Luotu tekstituloste

usage

object

Tokenien käyttötilastot, mukaan lukien prompt_tokens, completion_tokens, total_tokens

Esimerkit

cURL

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

Python

import requests

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

Suoratoistoesimerkki

curl --location 'https://your-domain.com/api/ai/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "deepseek-v4.1-flash",
    "input": "Hello",
    "max_tokens": 1000,
    "stream": true
  }'