Skip to content

Crear reconocimiento de imagen en chat (streaming)

POST
/v1/chat/completions
  • Endpoint de chat de reconocimiento de imágenes compatible con la API OpenAI Chat Completions (mensajes multimodales)
  • Pase imágenes mediante image_url en messages; el modelo devuelve descripción o respuesta sobre la imagen
  • Establezca stream: true en el cuerpo de la solicitud para habilitar salida SSE en streaming
  • Documentación oficial: Chat Completions

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object

ID del modelo a usar. En reconocimiento de imágenes se usan habitualmente gpt-4o y otros modelos de visión.

object[]
Required

Lista de mensajes. En reconocimiento de imágenes, el content del mensaje user es un array multimodal (text + image_url).
Los mensajes system también pueden usar content como cadena (igual que OpenAI).

Temperatura de muestreo entre 0 y 2. Valores más altos (p. ej. 0,8) hacen la salida más aleatoria; más bajos (p. ej. 0,2) más enfocada. Suele recomendarse cambiar esto o top_p, no ambos.

Muestreo nucleus alternativo a la temperatura. El modelo considera tokens con masa de probabilidad top_p (p. ej. 0,1 = 10 % superior). Suele recomendarse cambiar esto o temperature, no ambos.

Por defecto 1. Cuántas opciones de finalización de chat generar por mensaje de entrada.

Para reconocimiento de imágenes establezca true. Los tokens se envían como server-sent events; fin con data: [DONE].

Por defecto null. Hasta 4 secuencias donde la API deja de generar tokens.

Por defecto inf. Máximo de tokens a generar en la finalización.

La longitud total de tokens de entrada y salida está limitada por el contexto del modelo.

Número entre -2,0 y 2,0. Valores positivos penalizan tokens nuevos según si aparecieron en el texto, aumentando temas nuevos.

Por defecto 0. Número entre -2,0 y 2,0. Valores positivos penalizan por frecuencia en el texto, reduciendo repeticiones.

Modificar la probabilidad de tokens especificados. Acepta JSON que mapea IDs de token a sesgos de -100 a 100.

Identificador único del usuario final. Ayuda a OpenAI a monitorear abusos. Más información.

Objeto que especifica el formato de salida. { "type": "json_object" } activa el modo JSON.

Función beta. Si se establece, el sistema intenta muestreo determinista; supervise system_fingerprint en la respuesta.

Lista de herramientas que el modelo puede invocar. Actualmente solo funciones como herramientas.

Controla qué función invoca el modelo, si alguna. none / auto / especificar nombre de función.

Responses

application/json
object
object[]
Required
object
Required

Playground

Authorization
Body

Samples