> ## 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 - Référence API complète > - Utiliser le format OpenAI SDK pour appeler le modèle GPT-5.2 - Mode de traitement synchrone, réponse en temps réel - **Conversation textuelle** : Dialogue contextuel à un ou plusieurs tours - **Prompts système** : Personnaliser le rôle et le comportement de l'IA - **Entrée multimodale** : Prend en charge l'entrée mixte texte + image - Démarrage rapide ? Consultez le [Guide de démarrage rapide](./gpt-5.2-quickstart) **BaseURL** : La BaseURL par défaut est `https://direct.evolink.ai`, qui offre une meilleure prise en charge des modèles de texte et des connexions persistantes. `https://api.evolink.ai` est le point d'accès principal pour les services multimodaux et sert d'adresse de secours pour les modèles de texte. ## OpenAPI ````yaml fr/api-manual/language-series/gpt-5.2/gpt-5.2-reference.json POST /v1/chat/completions openapi: 3.1.0 info: title: GPT-5.2 Référence API complète description: >- Référence API complète pour l'interface de chat GPT-5.2, incluant tous les paramètres et fonctionnalités avancées license: name: MIT version: 1.0.0 servers: - url: https://direct.evolink.ai description: Production (recommandée) - url: https://api.evolink.ai description: URL alternative security: - bearerAuth: [] tags: - name: Complétion de chat description: Points de terminaison liés à la complétion de chat IA paths: /v1/chat/completions: post: tags: - Complétion de chat summary: Interface de chat GPT-5.2 description: >- - Utiliser le format OpenAI SDK pour appeler le modèle GPT-5.2 - Mode de traitement synchrone, réponse en temps réel - **Conversation textuelle** : Dialogue contextuel à un ou plusieurs tours - **Prompts système** : Personnaliser le rôle et le comportement de l'IA - **Entrée multimodale** : Prend en charge l'entrée mixte texte + image - Démarrage rapide ? Consultez le [Guide de démarrage rapide](./gpt-5.2-quickstart) operationId: createChatCompletion requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ChatCompletionRequest' examples: simple_text: summary: Conversation textuelle à tour unique value: model: gpt-5.2 messages: - role: user content: Please introduce yourself multi_turn: summary: Conversation multi-tours (compréhension du contexte) 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: Utilisation des prompts système 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: Entrée multimodale (texte + image) 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: Entrée d'images multiples 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: Complétion de chat réussie content: application/json: schema: $ref: '#/components/schemas/ChatCompletionResponse' '400': description: Paramètres de requête invalides content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 400 message: Paramètres de requête invalides type: invalid_request_error '401': description: Non autorisé, jeton invalide ou expiré content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 401 message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, recharge requise content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 402 message: Quota insuffisant type: insufficient_quota_error fallback_suggestion: https://evolink.ai/dashboard/billing '403': description: Accès refusé 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: Ressource introuvable 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: Corps de la requête trop volumineux 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: Limite de débit dépassée content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 429 message: Limite de débit dépassée type: rate_limit_error fallback_suggestion: retry after 60 seconds '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 500 message: Erreur interne du serveur type: internal_server_error fallback_suggestion: try again later '502': description: Erreur du service en amont 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: Service temporairement indisponible content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: 503 message: Service temporairement indisponible type: service_unavailable_error fallback_suggestion: retry after 30 seconds components: schemas: ChatCompletionRequest: type: object required: - model - messages properties: model: type: string description: Nom du modèle pour la complétion de chat enum: - gpt-5.2 default: gpt-5.2 example: gpt-5.2 messages: type: array description: >- Liste des messages pour la conversation, prend en charge le dialogue multi-tours et l'entrée multimodale (texte, images) items: $ref: '#/components/schemas/Message' minItems: 1 stream: type: boolean description: >- Indique si la réponse doit être en streaming - `true` : Réponse en streaming, retourne le contenu fragment par fragment en temps réel - `false` : Attendre la réponse complète et la retourner en une seule fois example: false temperature: type: number description: >- Température d'échantillonnage, contrôle le caractère aléatoire de la sortie **Remarques** : - Valeurs basses (par ex., 0.2) : Sortie plus déterministe et ciblée - Valeurs élevées (par ex., 1.5) : Sortie plus aléatoire et créative minimum: 0 maximum: 2 example: 0.7 top_p: type: number description: >- Paramètre d'échantillonnage Nucleus **Remarques** : - Contrôle l'échantillonnage à partir des tokens avec une probabilité cumulative - Par exemple, 0.9 signifie échantillonner parmi les tokens dont la probabilité cumulative atteint 90 % - Par défaut : 1.0 (considère tous les tokens) **Recommandation** : Ne pas ajuster temperature et top_p simultanément minimum: 0 maximum: 1 example: 0.9 top_k: type: integer description: >- Paramètre d'échantillonnage Top-K **Remarques** : - Par exemple, 10 signifie ne considérer que les 10 tokens les plus probables à chaque étape d'échantillonnage - Des valeurs plus petites rendent la sortie plus ciblée - Par défaut : illimité minimum: 1 example: 40 ChatCompletionResponse: type: object properties: id: type: string description: Identifiant unique pour la complétion de chat example: chatcmpl-20251010015944503180122WJNB8Eid model: type: string description: Le modèle utilisé pour la complétion example: gpt-5.2 object: type: string enum: - chat.completion description: Type de réponse example: chat.completion created: type: integer description: Horodatage Unix de la création de la complétion example: 1760032810 choices: type: array description: Liste des choix de complétion items: $ref: '#/components/schemas/Choice' usage: $ref: '#/components/schemas/Usage' ErrorResponse: type: object properties: error: type: object properties: code: type: integer description: Code d'erreur de statut HTTP message: type: string description: Message d'erreur type: type: string description: Type d'erreur param: type: string description: Nom du paramètre concerné fallback_suggestion: type: string description: Suggestion pour gérer l'erreur Message: type: object required: - role - content properties: role: type: string description: >- Rôle du message - `user` : Message de l'utilisateur - `assistant` : Message de l'assistant IA (pour le dialogue multi-tours) - `system` : Prompt système (définit le rôle et le comportement de l'IA) enum: - user - assistant - system example: user content: type: array description: >- Contenu du message. Prend en charge deux formats : **1. Chaîne de texte brut** : Passer directement une chaîne, par ex., `"content":"Veuillez vous présenter"` **2. Tableau d'objets** (prend en charge l'entrée texte, l'entrée multimodale) : Voir la structure ci-dessous items: $ref: '#/components/schemas/ContentPart' Choice: type: object properties: index: type: integer description: Index de ce choix example: 0 message: $ref: '#/components/schemas/AssistantMessage' finish_reason: type: string description: Raison pour laquelle la complétion s'est terminée enum: - stop - length - content_filter example: stop Usage: type: object description: Statistiques d'utilisation des jetons properties: prompt_tokens: type: integer description: Nombre de tokens dans l'entrée example: 13 completion_tokens: type: integer description: Nombre de tokens dans la sortie example: 1891 total_tokens: type: integer description: Nombre total de tokens utilisés example: 1904 prompt_tokens_details: type: object description: Détails des tokens d'entrée properties: cached_tokens: type: integer description: Nombre de tokens en cache example: 0 text_tokens: type: integer description: Nombre de tokens de texte example: 13 audio_tokens: type: integer description: Nombre de tokens audio example: 0 image_tokens: type: integer description: Nombre de tokens d'image example: 0 completion_tokens_details: type: object description: Détails des tokens de sortie properties: text_tokens: type: integer description: Nombre de tokens de texte example: 0 audio_tokens: type: integer description: Nombre de tokens audio example: 0 reasoning_tokens: type: integer description: Nombre de tokens de raisonnement example: 1480 input_tokens: type: integer description: Nombre de tokens d'entrée (champ de compatibilité) example: 0 output_tokens: type: integer description: Nombre de tokens de sortie (champ de compatibilité) example: 0 input_tokens_details: type: object nullable: true description: Détails des tokens d'entrée (champ de compatibilité) example: null ContentPart: oneOf: - $ref: '#/components/schemas/TextContent' - $ref: '#/components/schemas/ImageContent' AssistantMessage: type: object properties: role: type: string description: Rôle de l'expéditeur du message enum: - assistant example: assistant content: type: string description: Contenu de la réponse de l'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: Contenu texte type: object required: - type - text properties: type: type: string enum: - text description: Type de contenu text: type: string description: Contenu texte example: Please describe this image in detail ImageContent: title: Contenu d'image type: object required: - type - image_url properties: type: type: string enum: - image_url description: Type de contenu image_url: type: object required: - url properties: url: type: string format: uri description: >- URL de l'image **Limites** : - Taille maximale par image : `10MB` - Formats pris en charge : `.jpeg`, `.jpg`, `.png`, `.webp` - Exigences URL : Doit être accessible publiquement, se termine généralement par une extension d'image example: https://example.com/image.png securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Toutes les API nécessitent une authentification Bearer Token ## **Obtenir une clé API :** Visitez la [Page de gestion des clés API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API **Ajouter à l'en-tête de requête :** ``` Authorization: Bearer YOUR_API_KEY ``` ````