> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # GPT-5.2 - Inicio rápido > - Usar el formato del SDK de OpenAI para llamar al modelo GPT-5.2 - Modo de procesamiento síncrono, respuesta en tiempo real - **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 - ¿Inicio rápido? Consulta la [Guía de Inicio Rápido](./gpt-5.2-quickstart) **BaseURL**: La BaseURL predeterminada es `https://direct.evolink.ai`, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. `https://api.evolink.ai` es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto. ## OpenAPI ````yaml es/api-manual/language-series/gpt-5.2/gpt-5.2-reference.json POST /v1/chat/completions openapi: 3.1.0 info: title: Chat rápido GPT-5.2 description: >- Referencia completa de la API para la interfaz de chat de GPT-5.2, incluyendo todos los parámetros y funciones avanzadas license: name: MIT version: 1.0.0 servers: - url: https://direct.evolink.ai description: Producción (recomendado) - url: https://api.evolink.ai description: URL alternativa security: - bearerAuth: [] tags: - name: Completado de chat description: Endpoints relacionados con el completado de chat de IA paths: /v1/chat/completions: post: tags: - Completado de chat summary: Interfaz de Chat GPT-5.2 description: >- - Usar el formato del SDK de OpenAI para llamar al modelo GPT-5.2 - Modo de procesamiento síncrono, respuesta en tiempo real - **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 - ¿Inicio rápido? Consulta la [Guía de Inicio Rápido](./gpt-5.2-quickstart) operationId: createChatCompletion requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ChatCompletionRequest' examples: simple_text: summary: Conversación de texto de un solo turno value: model: gpt-5.2 messages: - role: user content: Please introduce yourself multi_turn: summary: Conversación multi-turno (comprensión de contexto) value: model: gpt-5.2 messages: - role: user content: What is Python? - role: assistant content: Python is a high-level programming language... - role: user content: What are its advantages? system_prompt: summary: Uso de prompts del sistema value: model: gpt-5.2 messages: - role: system content: >- You are a professional Python programming assistant. Answer questions concisely. - role: user content: How to read a file? vision: summary: Entrada multimodal (texto + imagen) value: model: gpt-5.2 messages: - role: user content: - type: text text: >- Please describe the scene and main elements in this image in detail. - type: image_url image_url: url: https://example.com/image.png multi_image: summary: Entrada de múltiples imágenes value: model: gpt-5.2 messages: - role: user content: - type: text text: Compare the differences between these two images - type: image_url image_url: url: https://example.com/image1.png - type: image_url image_url: url: https://example.com/image2.png responses: '200': description: Completado de chat exitoso content: application/json: schema: $ref: '#/components/schemas/ChatCompletionResponse' '400': description: Parámetros de solicitud inválidos content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 400 message: Parámetros de solicitud inválidos type: invalid_request_error '401': description: No autorizado, token inválido o expirado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 401 message: Invalid or expired token type: authentication_error '402': description: Cuota insuficiente, se requiere recarga content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 402 message: Cuota insuficiente type: insufficient_quota_error fallback_suggestion: https://evolink.ai/dashboard/billing '403': description: Acceso denegado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 403 message: Access denied for this model type: permission_error param: model '404': description: Recurso no encontrado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 404 message: Specified model not found type: not_found_error param: model fallback_suggestion: gpt-5.2 '413': description: Cuerpo de solicitud demasiado grande content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 413 message: Image file too large type: request_too_large_error param: content fallback_suggestion: compress image to under 10MB '429': description: >- Semilla aleatoria, rango `[1, 2147483647]` **Nota:** - Usar el mismo valor de semilla puede mantener resultados de generación consistentes - Dejar vacío para semilla aleatoria content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 429 message: >- Semilla aleatoria, rango `[1, 2147483647]` **Nota:** - Usar el mismo valor de semilla puede mantener resultados de generación consistentes - Dejar vacío para semilla aleatoria type: rate_limit_error fallback_suggestion: retry after 60 seconds '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 500 message: Error interno del servidor type: internal_server_error fallback_suggestion: try again later '502': description: Error del servicio upstream content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 502 message: Upstream AI service unavailable type: upstream_error fallback_suggestion: try different model '503': description: Servicio temporalmente no disponible content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 503 message: Servicio temporalmente no disponible type: service_unavailable_error fallback_suggestion: retry after 30 seconds components: schemas: ChatCompletionRequest: type: object required: - model - messages properties: model: type: string description: Nombre del modelo para completado de chat enum: - gpt-5.2 default: gpt-5.2 example: gpt-5.2 messages: type: array description: >- Lista de mensajes para la conversación, soporta diálogo de múltiples turnos y entrada multimodal (texto, imágenes) items: $ref: '#/components/schemas/Message' minItems: 1 stream: type: boolean description: >- 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 example: false temperature: type: number description: >- Temperatura de muestreo, controla la aleatoriedad de la salida **Notas**: - 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 minimum: 0 maximum: 2 example: 0.7 top_p: type: number description: >- Parámetro de Nucleus sampling **Notas**: - Controla el muestreo de tokens con probabilidad acumulada - Por ejemplo, 0.9 significa muestrear entre tokens con el 90% superior de probabilidad acumulada - Valor predeterminado: 1.0 (considera todos los tokens) **Recomendación**: No ajustar temperature y top_p simultáneamente minimum: 0 maximum: 1 example: 0.9 top_k: type: integer description: >- Parámetro de muestreo Top-K **Notas**: - Por ejemplo, 10 significa considerar solo los 10 tokens más probables durante cada paso de muestreo - Valores más pequeños hacen la salida más enfocada - Valor predeterminado: ilimitado minimum: 1 example: 40 ChatCompletionResponse: type: object properties: id: type: string description: Identificador único para la completación de chat example: chatcmpl-20251010015944503180122WJNB8Eid model: type: string description: El modelo utilizado para el completado example: gpt-5.2 object: type: string enum: - chat.completion description: Tipo de respuesta example: chat.completion created: type: integer description: Marca de tiempo Unix cuando se creó el completado example: 1760032810 choices: type: array description: Lista de opciones de completado items: $ref: '#/components/schemas/Choice' usage: $ref: '#/components/schemas/Usage' ErrorResponse: type: object properties: error: type: object properties: code: type: integer description: Código de error de estado HTTP message: type: string description: Tipo de error type: type: string description: Tiempo estimado de finalización (segundos) param: type: string description: Nombre del parámetro relacionado fallback_suggestion: type: string description: Sugerencia para manejar el error Message: type: object required: - role - content properties: role: type: string description: >- Rol del mensaje - `user`: Mensaje del usuario - `assistant`: Mensaje del asistente de IA (para diálogo de múltiples turnos) - `system`: Prompt del sistema (establece el rol y comportamiento de la IA) enum: - user - assistant - system example: user content: type: array description: >- Contenido del mensaje. Soporta dos formatos: **1. Cadena de texto plano**: Pasar una cadena directamente, por ejemplo, `"content":"Por favor preséntate"` **2. Array de objetos** (soporta entrada de texto, entrada multimodal): Ver estructura a continuación items: $ref: '#/components/schemas/ContentPart' Choice: type: object properties: index: type: integer description: Índice de esta opción example: 0 message: $ref: '#/components/schemas/AssistantMessage' finish_reason: type: string description: Razón por la que finalizó el completado enum: - stop - length - content_filter example: stop Usage: type: object description: Estadísticas de uso de tokens properties: prompt_tokens: type: integer description: Número de tokens en la entrada example: 13 completion_tokens: type: integer description: Número de tokens en la salida example: 1891 total_tokens: type: integer description: Número total de tokens utilizados example: 1904 prompt_tokens_details: type: object description: Detalles de tokens de entrada properties: cached_tokens: type: integer description: Número de tokens en caché example: 0 text_tokens: type: integer description: Número de tokens de texto example: 13 audio_tokens: type: integer description: Número de tokens de audio example: 0 image_tokens: type: integer description: Número de tokens de imagen example: 0 completion_tokens_details: type: object description: Detalles de tokens de salida properties: text_tokens: type: integer description: Número de tokens de texto example: 0 audio_tokens: type: integer description: Número de tokens de audio example: 0 reasoning_tokens: type: integer description: Número de tokens de razonamiento example: 1480 input_tokens: type: integer description: Número de tokens de entrada (campo de compatibilidad) example: 0 output_tokens: type: integer description: Número de tokens de salida (campo de compatibilidad) example: 0 input_tokens_details: type: object nullable: true description: Detalles de tokens de entrada (campo de compatibilidad) example: null ContentPart: oneOf: - $ref: '#/components/schemas/TextContent' - $ref: '#/components/schemas/ImageContent' AssistantMessage: type: object properties: role: type: string description: Rol del remitente del mensaje enum: - assistant example: assistant content: type: string description: Contenido de la respuesta de la IA example: >- Hello! I'm GPT-5.2, with enhanced reasoning and understanding capabilities. I excel at handling complex problems, multi-step reasoning, and code generation.\n\nKey features include:\n- Stronger logical reasoning\n- Better context understanding\n- More accurate code generation TextContent: title: Contenido de texto type: object required: - type - text properties: type: type: string enum: - text description: Tipo de contenido text: type: string description: Contenido de texto example: Please describe this image in detail ImageContent: title: Contenido de imagen type: object required: - type - image_url properties: type: type: string enum: - image_url description: Tipo de contenido image_url: type: object required: - url properties: url: type: string format: uri description: >- URL de la imagen **Límites**: - Tamaño máximo por imagen: `10MB` - Formatos soportados: `.jpeg`, `.jpg`, `.png`, `.webp` - Requisitos de URL: Debe ser accesible públicamente, generalmente termina con extensión de imagen example: https://example.com/image.png securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Todas las APIs requieren autenticación Bearer Token ## **Obtener API Key:** Visita la [Página de gestión de API Key](https://evolink.ai/dashboard/keys) para obtener tu API Key **Agregar al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ``` ````