TextoGPTGPT-5.1

Interfaz de chat GPT-5.1

Usar el formato del SDK de OpenAI para llamar a los modelos de la serie GPT-5.1

Modo de procesamiento síncrono, respuesta en tiempo real
Modelos disponibles: gpt-5.1 (base), gpt-5.1-chat (optimizado para conversación), gpt-5.1-thinking (con salida de razonamiento)
Conversación de texto: Diálogo de un solo turno o múltiples turnos con contexto
Prompts del sistema: Personalizar el rol y comportamiento de la IA
Entrada multimodal: Soporta entrada mixta de texto + imagen
Llamada a herramientas: Soporta Function Calling
Salida de razonamiento: gpt-5.1-thinking devuelve el campo reasoning_content mostrando el proceso de pensamiento

<Note> **BaseURL**: La BaseURL predeterminada es `https://api.starmagic.ai`, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. `https://api.starmagic.ai` es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto. </Note>

Autorización

AuthorizationstringheaderObligatorio

Todas las APIs requieren autenticación con Bearer Token **Obtener API Key:** Visita la [Página de Gestión de API Key](https://starmagic.ai/app/api-keys) para obtener tu API Key **Agregar al encabezado de solicitud:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

Cuerpo de solicitud

application/json

modelenum<gpt-5.1 | gpt-5.1-chat | gpt-5.1-thinking>Obligatorio

Nombre del modelo para completado de chat - **gpt-5.1**: Modelo base para tareas generales - **gpt-5.1-chat**: Optimizado para tareas conversacionales - **gpt-5.1-thinking**: Con capacidades de razonamiento y salida del proceso de pensamiento (devuelve reasoning_content)

"gpt-5.1"

messagesobject[]Obligatorio

Lista de mensajes para la conversación, soporta diálogo de múltiples turnos y entrada multimodal

[
  {
    "role": "user",
    "content": null
  }
]

streamboolean

Si se transmite la respuesta en streaming - `true`: Respuesta en streaming, devuelve contenido fragmento a fragmento en tiempo real - `false`: Esperar la respuesta completa y devolverla de una sola vez

false

max_tokensinteger

Número máximo de tokens a generar en la respuesta

temperaturenumber

Temperatura de muestreo, controla la aleatoriedad de la salida - Valores más bajos (por ejemplo, 0.2): Salida más determinista y enfocada - Valores más altos (por ejemplo, 1.5): Salida más aleatoria y creativa

top_pnumber

Parámetro de Nucleus sampling - Controla el muestreo de tokens con probabilidad acumulada - Por ejemplo, 0.9 significa muestrear entre tokens con el 90% superior de probabilidad acumulada

0.9

frequency_penaltynumber

Penalización de frecuencia, número entre -2.0 y 2.0 - Los valores positivos penalizan nuevos tokens según su frecuencia en el texto

presence_penaltynumber

Penalización de presencia, número entre -2.0 y 2.0 - Los valores positivos penalizan nuevos tokens según si aparecen en el texto

stopobject

Secuencias de parada, la generación se detiene cuando se encuentran estas secuencias

toolsobject[]

Lista de herramientas para Function Calling

[
  {
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Obtener el clima actual en una ubicación dada",
      "parameters": {}
    }
  }
]

Respuesta

application/json

成功

Cuerpo de respuesta

idstring

Identificador único para la completación de chat

"chatcmpl-abc123"

modelstring

El modelo utilizado para el completado

"gpt-5.1"

objectenum<chat.completion>

Tipo de respuesta

"chat.completion"

createdinteger

Marca de tiempo Unix cuando se creó el completado

1698999496

choicesobject[]

Lista de opciones de completado

[
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hi there! How can I help you?",
      "reasoning_content": "Let me think about this step by step..."
    },
    "finish_reason": "stop"
  }
]

usageobject

Estadísticas de uso de tokens

{
  "prompt_tokens": 8,
  "completion_tokens": 292,
  "total_tokens": 300
}

POST/v1/chat/completions

curl --request POST \
  --url https://api.starmagic.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.1",
  "messages": [
    {
      "role": "user",
      "content": "Please introduce yourself"
    }
  ],
  "temperature": 1
}'

Respuesta: 成功

{
  "id": "chatcmpl-abc123",
  "model": "gpt-5.1",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": null,
        "content": null,
        "reasoning_content": null
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}

Interfaz de chat GPT-5.1

Usar el formato del SDK de OpenAI para llamar a los modelos de la serie GPT-5.1

Modo de procesamiento síncrono, respuesta en tiempo real

Modelos disponibles: gpt-5.1 (base), gpt-5.1-chat (optimizado para conversación), gpt-5.1-thinking (con salida de razonamiento)

Conversación de texto: Diálogo de un solo turno o múltiples turnos con contexto

Prompts del sistema: Personalizar el rol y comportamiento de la IA

Entrada multimodal: Soporta entrada mixta de texto + imagen

Llamada a herramientas: Soporta Function Calling

Salida de razonamiento: gpt-5.1-thinking devuelve el campo reasoning_content mostrando el proceso de pensamiento

[ { "index": 0, "message": { "role": "assistant", "content": "Hi there! How can I help you?", "reasoning_content": "Let me think about this step by step..." }, "finish_reason": "stop" } ]