OneMux/Documentación/Generación de conversaciones

Generación de conversaciones

Endpoint estándar de generación de conversaciones, compatible con los principales modelos de OpenAI, Anthropic, Google y otros. Admite conversaciones de varios turnos, prompts del sistema, respuestas en streaming y ajuste de parámetros. En esta página se describen el formato de la solicitud, la estructura de la respuesta, los parámetros más comunes y la gestión de errores.

Información de la API

  • Endpoint: POST /v1/chat/completions
  • Autenticación: Authorization: Bearer sk-xxx
  • Protocolo: formato compatible con OpenAI

Llamada básica

curl https://api.onemux.net/v1/chat/completions \
  -H "Authorization: Bearer $ONEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role": "user", "content": "Hola, OneMux"}]
  }'

Ejemplo de respuesta

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gpt-6.1-sol",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "¡Hola! Soy el asistente de IA de OneMux..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

Conversaciones de varios turnos

El array messages guarda el historial en orden cronológico:

response = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[
        {"role": "user", "content": "Me llamo Xiao Ming"},
        {"role": "assistant", "content": "¡Hola, Xiao Ming!"},
        {"role": "user", "content": "¿Cómo me llamo?"}
    ]
)
# La IA responderá: Te llamas Xiao Ming

Prompt del sistema

Usa el rol system para definir las reglas de comportamiento de la IA:

messages = [
    {"role": "system", "content": "Eres un ingeniero profesional de Python. Responde de forma concisa y profesional."},
    {"role": "user", "content": "¿Cómo se lee un archivo?"}
]

Parámetros comunes

ParámetroDescripciónValor recomendado
temperatureCreatividad (0-2)0.7 (predeterminado); 1.2 para escritura creativa y 0.3 para generar código
max_tokensLongitud máxima de salidaConfigúrala según sea necesario para evitar que el modelo "se extienda demasiado"
top_pMuestreo top-p (0-1)0.9 (predeterminado)
streamSalida en streamingtrue (recomendado, ofrece una mejor experiencia)

Errores comunes