AIAI Gateway/Documentación de la API/Chat Completions

API Chat Completions de OpenAI

Usa la API Chat Completions de OpenAI para conversaciones. Este es el formato clásico de la API de chat de OpenAI.

Endpoint

POST/api/ai/v1/chat/completions

Autenticación

AuthorizationObligatorio

Bearer YOUR_API_KEY

Solicitud

Parámetro	Tipo	Obligatorio	Descripción
`model`	string	Obligatorio	Nombre del modelo, p. ej. deepseek-v4.1-flash, qwen3.8-max
`messages`	array	Obligatorio	Array de mensajes en el siguiente formato
`max_tokens`	integer	Opcional	Número máximo de tokens de salida
`temperature`	float	Opcional	Temperatura de muestreo, controla la aleatoriedad (0-2)
`stream`	boolean	Opcional	Habilitar respuesta en streaming, establecer en true para SSE

Respuesta

Parámetro	Tipo	Descripción
`id`	string	Identificador único de respuesta
`model`	string	Modelo utilizado
`choices`	array	Array de opciones de respuesta, generalmente tomar la primera
`usage`	object	Estadísticas de uso de tokens

Ejemplos

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

Ejemplo de 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 →

Solicitud

Parámetro	Tipo	Obligatorio	Descripción
`model`	string	Obligatorio	Nombre del modelo, p. ej. deepseek-v4.1-flash, qwen3.8-max
`messages`	array	Obligatorio	Array de mensajes en el siguiente formato
`max_tokens`	integer	Opcional	Número máximo de tokens de salida
`temperature`	float	Opcional	Temperatura de muestreo, controla la aleatoriedad (0-2)
`stream`	boolean	Opcional	Habilitar respuesta en streaming, establecer en true para SSE

Parámetro

Tipo

Descripción

id

string

Identificador único de respuesta

model

string

Modelo utilizado

choices

array

Array de opciones de respuesta, generalmente tomar la primera

usage

object

Estadísticas de uso de tokens

Ejemplos

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

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