AIAI Gateway/Documentație API/Responses

OpenAI Responses API

Utilizați OpenAI Responses API pentru conversații. Responses API este cel mai recent format de API OpenAI, cu input mai flexibil.

Endpoint

POST/api/ai/v1/responses

Autentificare

AuthorizationObligatoriu

Bearer YOUR_API_KEY

Cerere

Parametru	Tip	Obligatoriu	Descriere
`model`	string	Obligatoriu	Numele modelului, ex. deepseek-v4.1-flash, qwen3.8-max
`input`	string	Obligatoriu	Text de input sau conținutul conversației
`max_tokens`	integer	Opțional	Numărul maxim de tokeni de output
`temperature`	float	Opțional	Temperatura de sampling, controlează aleatorietatea (0-2)
`stream`	boolean	Opțional	Activează răspunsul în streaming, setați true pentru SSE

Răspuns

Parametru	Tip	Descriere
`id`	string	Identificator unic al răspunsului
`model`	string	Modelul efectiv utilizat
`output`	string	Textul de output generat
`usage`	object	Statistici de utilizare a tokenilor, inclusiv prompt_tokens, completion_tokens, total_tokens

Exemple

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())

Exemplu streaming

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
  }'

← Înapoi la documentație Chat Completions →

Cerere

Parametru	Tip	Obligatoriu	Descriere
`model`	string	Obligatoriu	Numele modelului, ex. deepseek-v4.1-flash, qwen3.8-max
`input`	string	Obligatoriu	Text de input sau conținutul conversației
`max_tokens`	integer	Opțional	Numărul maxim de tokeni de output
`temperature`	float	Opțional	Temperatura de sampling, controlează aleatorietatea (0-2)
`stream`	boolean	Opțional	Activează răspunsul în streaming, setați true pentru SSE

Parametru

Tip

Descriere

id

string

Identificator unic al răspunsului

model

string

Modelul efectiv utilizat

output

string

Textul de output generat

usage

object

Statistici de utilizare a tokenilor, inclusiv prompt_tokens, completion_tokens, total_tokens

Exemple

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())

Exemplu streaming

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
  }'