Crear una finalización de chat

POST

chat

completions

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cometapi.com/v1",
    api_key=os.environ["COMETAPI_KEY"],
)

completion = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[
        {
            "role": "developer",
            "content": "You are a helpful assistant.",
        },
        {
            "role": "user",
            "content": "Hello!",
        },
    ],
    reasoning_effort="low",
)

print(completion.choices[0].message)

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null,
      "message": {
        "annotations": [],
        "content": "Hi! How can I help you today?",
        "refusal": null,
        "role": "assistant"
      }
    }
  ],
  "created": 1788763703,
  "id": "chatcmpl_example",
  "model": "gpt-6-astra",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 12,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0,
      "rejected_prediction_tokens": 0
    },
    "prompt_tokens": 18,
    "prompt_tokens_details": {
      "audio_tokens": 0,
      "cache_write_tokens": 0,
      "cached_tokens": 0
    },
    "total_tokens": 30
  }
}

{
  "error": {
    "code": "",
    "message": "model name is required (request id: <request_id>)",
    "type": "comet_api_error"
  }
}

{
  "error": {
    "code": "",
    "message": "invalid token (request id: <request_id>)",
    "type": "comet_api_error"
  }
}

{
  "error": {
    "message": "field messages is required (request id: <request_id>)",
    "type": "comet_api_error",
    "param": "",
    "code": "invalid_request"
  }
}

Envía conversaciones mediante la API Chat Completions compatible con OpenAI. Configura tu SDK con base_url="https://api.cometapi.com/v1" y tu clave de API de CometAPI. Los ejemplos básicos, de imágenes, de Streaming y de salida estructurada usan gpt-6-astra. El ejemplo de Function Calling usa gpt-5.6-sol, y el ejemplo de probabilidades logarítmicas usa gpt-4.1.

Usa la referencia de OpenAI Chat Completions para ver las definiciones de parámetros. Para las llamadas a herramientas de GPT-6 Astra, usa Responses, siguiendo la guía de modelos de OpenAI.

Roles de mensajes

Rol	Descripción
`system`	Define el comportamiento y la personalidad del asistente. Se coloca al inicio de la conversación.
`developer`	Proporciona instrucciones de la aplicación. Los ejemplos de GPT-6 Astra usan este rol.
`user`	Mensajes del usuario final.
`assistant`	Respuestas anteriores del modelo, utilizadas para mantener el historial de la conversación.
`tool`	Resultados de llamadas a herramientas o funciones. Debe incluir `tool_call_id` que coincida con la llamada a herramienta original.

Coloca las instrucciones de la aplicación en un mensaje developer antes de los mensajes de usuario al usar los ejemplos de GPT-6 Astra.

Enviar entrada Multimodal

Usa un arreglo de partes de contenido para enviar una imagen con texto:

{
  "model": "gpt-6-astra",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Describe the road and surrounding landscape in this image."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://images.unsplash.com/photo-1500530855697-b586d89ba3ee?w=1200",
            "detail": "high"
          }
        }
      ]
    }
  ],
  "reasoning_effort": "low",
  "max_completion_tokens": 4096
}

Usa image_url.detail para seleccionar el nivel de detalle del procesamiento de imágenes. Este ejemplo usa high.

Transmitir respuestas

Para recibir resultados incrementales, establece stream en true. La respuesta se entrega como Eventos enviados por el servidor (SSE). El texto llega en objetos chat.completion.chunk; este ejemplo abreviado incluye el fragmento de uso final:

data: {"choices":[{"delta":{"content":"","refusal":null,"role":"assistant"},"finish_reason":null,"index":0,"logprobs":null}],"created":1788765075,"id":"chatcmpl_example","model":"gpt-6-astra-2026-09-03","object":"chat.completion.chunk"}

data: {"choices":[{"delta":{"content":"Hi"},"finish_reason":null,"index":0,"logprobs":null}],"created":1788765075,"id":"chatcmpl_example","model":"gpt-6-astra-2026-09-03","object":"chat.completion.chunk"}

: Additional text deltas omitted

data: {"choices":[{"delta":{},"finish_reason":"stop","index":0,"logprobs":null}],"created":1788765075,"id":"chatcmpl_example","model":"gpt-6-astra-2026-09-03","object":"chat.completion.chunk"}

data: {"choices":[],"created":1788765075,"id":"chatcmpl_example","model":"gpt-6-astra-2026-09-03","object":"chat.completion.chunk","usage":{"completion_tokens":12,"completion_tokens_details":{"accepted_prediction_tokens":0,"audio_tokens":0,"reasoning_tokens":0,"rejected_prediction_tokens":0},"prompt_tokens":18,"prompt_tokens_details":{"audio_tokens":0,"cache_write_tokens":0,"cached_tokens":0},"total_tokens":30}}

data: [DONE]

Para incluir estadísticas de uso de tokens en las respuestas de Streaming, establece stream_options.include_usage en true. Los datos de uso aparecen en un fragmento final antes de [DONE]. Los fragmentos pueden tener una matriz choices vacía; compruébala antes de acceder a choices[0].

Solicitar resultados estructurados

Usa response_format para solicitar resultados estructurados:

{
  "model": "gpt-6-astra",
  "messages": [
    {
      "role": "user",
      "content": "What is the capital of France? Return the answer and your confidence as a number from 0 to 1."
    }
  ],
  "reasoning_effort": "low",
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "result",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "answer": {
            "type": "string",
            "description": "The answer to the question."
          },
          "confidence": {
            "type": "number",
            "description": "Confidence between zero and one."
          }
        },
        "required": [
          "answer",
          "confidence"
        ],
        "additionalProperties": false
      }
    }
  }
}

{
  "model": "gpt-6-astra",
  "messages": [
    {
      "role": "user",
      "content": "Return a JSON object with the key answer and the capital of France as its value."
    }
  ],
  "reasoning_effort": "low",
  "response_format": {
    "type": "json_object"
  }
}

El modo JSON Schema especifica la estructura requerida. El modo JSON Object solicita JSON válido sin aplicar tu esquema. Comprueba si hay un rechazo o una respuesta limitada por longitud antes de consumir el resultado.

Llamar a herramientas y funciones

Usa gpt-5.6-sol con una definición de función:

{
  "model": "gpt-5.6-sol",
  "messages": [
    {
      "role": "user",
      "content": "What is the weather in Boston, MA, in celsius? Use the weather tool."
    }
  ],
  "reasoning_effort": "none",
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_current_weather",
        "description": "Get the current weather for a city.",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "City and state, for example Boston, MA."
            },
            "unit": {
              "type": "string",
              "enum": [
                "celsius",
                "fahrenheit"
              ],
              "description": "Temperature unit."
            }
          },
          "required": [
            "location",
            "unit"
          ],
          "additionalProperties": false
        },
        "strict": true
      }
    }
  ],
  "tool_choice": "auto"
}

Una llamada a función devuelve finish_reason: "tool_calls" y un array message.tool_calls. Analiza los arguments codificados en JSON de la función, ejecuta tu función y, a continuación, añade el mensaje del asistente y un mensaje de resultado tool con su tool_call_id correspondiente.

Elegir parámetros de solicitud

Parámetros específicos del modelo

Usa reasoning_effort y max_completion_tokens con GPT-6 Astra. Los ejemplos de Functions y Logprobs muestran las opciones de solicitud para gpt-5.6-sol y gpt-4.1, respectivamente.Para formatos de solicitud específicos de Claude o Gemini, consulta Anthropic Messages y Gemini Generate content.

max_tokens y max_completion_tokens

Usa max_completion_tokens para limitar los tokens generados en los ejemplos de GPT-6 Astra. Esto incluye el razonamiento y la salida visible, así que deja espacio para ambos. max_tokens es un parámetro heredado.

Roles de instrucciones

Usa developer para las instrucciones de la aplicación en los ejemplos de GPT-6 Astra. Mantén el contenido del usuario final en mensajes user y conserva las respuestas anteriores del asistente al continuar una conversación.

Preguntas frecuentes

¿Cómo gestionar los límites de frecuencia?

Al encontrarte con 429 Too Many Requests, implementa una espera exponencial:

import os
import time
import random
from openai import OpenAI, RateLimitError

client = OpenAI(
    base_url="https://api.cometapi.com/v1",
    api_key=os.environ["COMETAPI_KEY"],
)

def chat_with_retry(messages, max_retries=3):
    for i in range(max_retries):
        try:
            return client.chat.completions.create(
                model="gpt-6-astra",
                messages=messages,
                reasoning_effort="low",
            )
        except RateLimitError:
            if i < max_retries - 1:
                wait_time = (2 ** i) + random.random()
                time.sleep(wait_time)
            else:
                raise

¿Cómo mantener el contexto de la conversación?

Incluye el historial completo de la conversación en el array messages:

messages = [
    {"role": "developer", "content": "You are a helpful assistant."},
    {"role": "user", "content": "What is Python?"},
    {"role": "assistant", "content": "Python is a high-level programming language..."},
    {"role": "user", "content": "What are its main advantages?"},
]

¿Qué significa `finish_reason` ?

Valor	Significado
`stop`	Finalización natural o se alcanzó una secuencia de detención.
`length`	Se alcanzó el límite de `max_tokens` o `max_completion_tokens`.
`tool_calls`	El modelo invocó una o más llamadas a herramientas o funciones.
`content_filter`	La salida se filtró debido a la política de contenido.

¿Cómo controlar los costos?

Usa max_completion_tokens para limitar la longitud de la salida.
Compara los precios de los modelos y elige uno que cumpla los requisitos de tu carga de trabajo.
Mantén los prompts concisos; evita el contexto redundante.
Supervisa el uso de tokens en el campo de respuesta usage.

Autorizaciones

Authorization

string

header

requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json

model

string

predeterminado:gpt-6-astra

requerido

Model ID to use for this request. See the Models page for current options.

Ejemplo:

"gpt-6-astra"

messages

object[]

requerido

Conversation messages, including instructions, user input, assistant replies, and tool results.

Show child attributes

stream

boolean

If true, partial response tokens are delivered incrementally via server-sent events (SSE). The stream ends with a data: [DONE] message.

temperature

number

Sampling temperature. Omit this field for GPT-6 Astra.

Rango requerido: 0 <= x <= 2

top_p

number

Nucleus sampling threshold. Omit this field for GPT-6 Astra. For sampling overrides, adjust either top_p or temperature.

Rango requerido: 0 <= x <= 1

integer

Number of completion choices to generate for each input message. Defaults to 1.

stop

Stop string or list of up to four strings, for models that support stop sequences.

max_tokens

integer

obsoleto

Legacy output-token limit. Use max_completion_tokens for the GPT-6 Astra examples.

presence_penalty

number

Number between -2.0 and 2.0. Positive values penalize tokens based on whether they have already appeared, encouraging the model to explore new topics.

Rango requerido: -2 <= x <= 2

frequency_penalty

number

Number between -2.0 and 2.0. Positive values penalize tokens proportionally to how often they have appeared, reducing verbatim repetition.

Rango requerido: -2 <= x <= 2

logit_bias

object

A JSON object mapping token IDs to bias values from -100 to 100. The bias is added to the model's logits before sampling. Values between -1 and 1 subtly adjust likelihood; -100 or 100 effectively ban or force selection of a token.

user

string

A unique identifier for your end-user. Helps with abuse detection and monitoring.

max_completion_tokens

integer

Maximum generated tokens, including visible output and reasoning. Leave enough room for both, as in the image-input example.

response_format

object

Specifies the output format. Use {"type": "json_object"} for JSON mode, or {"type": "json_schema", "json_schema": {...}} for strict structured output.

Show child attributes

tools

object[]

Function definitions for a model that supports tool calling on Chat Completions. The function example uses GPT-5.6 Sol; use Responses for GPT-6 Astra tool calls.

Show child attributes

tool_choice

Controls how the model selects tools. auto (default): model decides. none: no tools. required: must call a tool.

logprobs

boolean

Return token log probabilities. Use gpt-4.1 as shown in the Logprobs example.

top_logprobs

integer

Number of most likely tokens to return at each position (0-20). Requires logprobs to be true.

Rango requerido: 0 <= x <= 20

reasoning_effort

string

Reasoning effort supported by the selected model. The GPT-6 Astra examples use low; the GPT-5.6 Sol function example uses none. See the model reference for other supported levels.

stream_options

object

Options for streaming. Only valid when stream is true.

Show child attributes

service_tier

enum<string>

Specifies the processing tier.

Opciones disponibles:

auto,

default,

flex,

priority

Respuesta

Successful chat completion response.

string

Unique completion identifier.

Ejemplo:

"chatcmpl_example"

object

enum<string>

Object type. Non-streaming responses use chat.completion.

Opciones disponibles:

chat.completion

Ejemplo:

"chat.completion"

created

integer

Unix timestamp of creation.

Ejemplo:

1788763703

model

string

The model used (may include version suffix).

Ejemplo:

"gpt-6-astra"

choices

object[]

Array of completion choices.

Show child attributes

usage

object

Token accounting for this request. Billing uses these counts.

Show child attributes

service_tier

string

Service tier that processed the request, when returned.

system_fingerprint

string | null

Model configuration fingerprint, when returned.

Última modificación el 8 de septiembre de 2026

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cometapi.com/v1",
    api_key=os.environ["COMETAPI_KEY"],
)

completion = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[
        {
            "role": "developer",
            "content": "You are a helpful assistant.",
        },
        {
            "role": "user",
            "content": "Hello!",
        },
    ],
    reasoning_effort="low",
)

print(completion.choices[0].message)

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null,
      "message": {
        "annotations": [],
        "content": "Hi! How can I help you today?",
        "refusal": null,
        "role": "assistant"
      }
    }
  ],
  "created": 1788763703,
  "id": "chatcmpl_example",
  "model": "gpt-6-astra",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 12,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 0,
      "rejected_prediction_tokens": 0
    },
    "prompt_tokens": 18,
    "prompt_tokens_details": {
      "audio_tokens": 0,
      "cache_write_tokens": 0,
      "cached_tokens": 0
    },
    "total_tokens": 30
  }
}

{
  "error": {
    "code": "",
    "message": "model name is required (request id: <request_id>)",
    "type": "comet_api_error"
  }
}

{
  "error": {
    "code": "",
    "message": "invalid token (request id: <request_id>)",
    "type": "comet_api_error"
  }
}

{
  "error": {
    "message": "field messages is required (request id: <request_id>)",
    "type": "comet_api_error",
    "param": "",
    "code": "invalid_request"
  }
}

Moderación de contenido

Claves API

Roles de mensajes

Enviar entrada Multimodal

Transmitir respuestas

Solicitar resultados estructurados

Llamar a herramientas y funciones

Elegir parámetros de solicitud

Preguntas frecuentes

¿Cómo gestionar los límites de frecuencia?

¿Cómo mantener el contexto de la conversación?

¿Qué significa `finish_reason` ?

¿Cómo controlar los costos?

Autorizaciones

Cuerpo

Respuesta

​Roles de mensajes

​Enviar entrada Multimodal

​Transmitir respuestas

​Solicitar resultados estructurados

​Llamar a herramientas y funciones

​Elegir parámetros de solicitud

​Preguntas frecuentes

​¿Cómo gestionar los límites de frecuencia?

​¿Cómo mantener el contexto de la conversación?

​¿Qué significa finish_reason ?

​¿Cómo controlar los costos?

Autorizaciones

Cuerpo

Respuesta

Roles de mensajes

Enviar entrada Multimodal

Transmitir respuestas

Solicitar resultados estructurados

Llamar a herramientas y funciones

Elegir parámetros de solicitud

Preguntas frecuentes

¿Cómo gestionar los límites de frecuencia?

¿Cómo mantener el contexto de la conversación?

¿Qué significa `finish_reason` ?

¿Cómo controlar los costos?