AIAI Gateway/Documentación de la API/Responses

API Responses de OpenAI

Usa la API Responses de OpenAI para conversaciones. La API Responses es el formato más reciente de la API de OpenAI con una entrada más flexible.

Endpoint

POST/api/ai/v1/responses

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
`input`	string	Obligatorio	Texto de entrada o contenido de la conversación
`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 la respuesta
`model`	string	Modelo realmente utilizado
`output`	string	Texto de salida generado
`usage`	object	Estadísticas de uso de tokens incluyendo prompt_tokens, completion_tokens, total_tokens

Ejemplos

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

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

← Volver a Docs Chat Completions →

Solicitud

Parámetro	Tipo	Obligatorio	Descripción
`model`	string	Obligatorio	Nombre del modelo, p. ej. deepseek-v4.1-flash, qwen3.8-max
`input`	string	Obligatorio	Texto de entrada o contenido de la conversación
`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 la respuesta

model

string

Modelo realmente utilizado

output

string

Texto de salida generado

usage

object

Estadísticas de uso de tokens incluyendo prompt_tokens, completion_tokens, total_tokens

Ejemplos

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

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