AIAI Gateway/Documentație API/Chat Completions

OpenAI Chat Completions API

Utilizați OpenAI Chat Completions API pentru conversații. Acesta este formatul clasic de API chat OpenAI.

Endpoint

POST/api/ai/v1/chat/completions

Autentificare

AuthorizationObligatoriu

Bearer YOUR_API_KEY

Cerere

Parametru	Tip	Obligatoriu	Descriere
`model`	string	Obligatoriu	Numele modelului, ex. deepseek-v4.1-flash, qwen3.8-max
`messages`	array	Obligatoriu	Array de mesaje în formatul
`max_tokens`	integer	Opțional	Număr maxim de tokeni de ieșire
`temperature`	float	Opțional	Temperatura de sampling, controlează aleatorietatea (0-2)
`stream`	boolean	Opțional	Activează răspunsul în streaming, setează la true pentru SSE

Răspuns

Parametru	Tip	Descriere
`id`	string	Identificator unic al răspunsului
`model`	string	Modelul efectiv utilizat
`choices`	array	Array de opțiuni de răspuns, de obicei se ia prima
`usage`	object	Statistici de utilizare a tokenilor

Exemple

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

Exemplu streaming

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 →

Cerere

Parametru	Tip	Obligatoriu	Descriere
`model`	string	Obligatoriu	Numele modelului, ex. deepseek-v4.1-flash, qwen3.8-max
`messages`	array	Obligatoriu	Array de mesaje în formatul
`max_tokens`	integer	Opțional	Număr maxim de tokeni de ieșire
`temperature`	float	Opțional	Temperatura de sampling, controlează aleatorietatea (0-2)
`stream`	boolean	Opțional	Activează răspunsul în streaming, setează la true pentru SSE

Parametru

Tip

Descriere

id

string

Identificator unic al răspunsului

model

string

Modelul efectiv utilizat

choices

array

Array de opțiuni de răspuns, de obicei se ia prima

usage

object

Statistici de utilizare a tokenilor

Exemple

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

Exemplu streaming

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