# API DeepSeek v4 Référence API complète pour les modèles LLM DeepSeek v4 alimentés par DeepSeek. ## Mises à jour du modèle ### DeepSeek v4 Pro 0813 - Flaq AI a mis à jour DeepSeek v4 Pro vers la version officielle `deepseek-v4-pro-0813` de DeepSeek. - Utilisez les identifiants de modèle `0813` ci-dessous pour accéder à la version officielle. - Les identifiants de modèle Pro d'origine ne sont pas disponibles. | Variante | Identifiant de modèle 0813 | Identifiant de modèle indisponible | |----------|----------------------------|------------------------------------| | Texte vers texte | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Recherche web | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI a mis à jour DeepSeek v4 Flash vers la version officielle de DeepSeek `deepseek-v4-flash-0731`. - Utilisez les identifiants de modèle `0731` ci-dessous pour accéder à la version mise à jour. - Les identifiants de modèle Flash d'origine ne sont pas disponibles. | Variante | Identifiant de modèle 0731 | Identifiant de modèle indisponible | |----------|----------------------------|------------------------------------| | Texte vers texte | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Recherche web | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## Variantes de modèle Cette API prend en charge quatre variantes du modèle DeepSeek v4 : | Modèle | ID | Description | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | Raisonnement et écriture textuels de haute qualité | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | Génération de texte plus rapide et plus abordable | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | Réponses conscientes du web avec le raisonnement DeepSeek v4 Pro | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | Réponses conscientes du web plus rapides avec DeepSeek v4 Flash | ## Comparaison rapide | Fonctionnalité | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | Entrée texte | Requise ✅ | Requise ✅ | Requise ✅ | Requise ✅ | | Entrée image | Non prise en charge ❌ | Non prise en charge ❌ | Non prise en charge ❌ | Non prise en charge ❌ | | Entrée fichier | Non prise en charge ❌ | Non prise en charge ❌ | Non prise en charge ❌ | Non prise en charge ❌ | | Web search | Non pris en charge ❌ | Non pris en charge ❌ | Activé ✅ | Activé ✅ | | Réponse en streaming | SSE | SSE | SSE | SSE | | `max_tokens` | Facultatif | Facultatif | Facultatif | Facultatif | | `top_p` | Facultatif | Facultatif | Facultatif | Facultatif | | `top_k` | Facultatif | Facultatif | Facultatif | Facultatif | ## DeepSeek v4 Pro Text to Text ### Point de terminaison ```http POST /api/v1/chat/completions ``` ### Paramètres de requête #### Requis | Paramètre | Type | Description | |-----------|------|-------------| | `model` | string | Doit être `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | Messages ordonnés uniquement textuels. Prend en charge les rôles `system`, `user` et `assistant`. Consultez l'API LLM pour la structure des messages. | | `stream` | boolean | `true` pour SSE, `false` pour une réponse JSON unique. | #### Prise en charge des messages | Champ | Texte | Fichier | Image | |-------|------|------|-------| | `messages` | Requis ✅ | Non pris en charge ❌ | Non pris en charge ❌ | #### Facultatifs | Paramètre | Type | Plage | Description | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens de sortie maximum. | | `top_p` | number | `0.0` - `1.0` | Limite la masse de probabilité cumulée pour les tokens candidats. | | `top_k` | integer | `0` - `100` | Limite le nombre de tokens candidats. | ### Exemple de requête ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-text-to-text-0813', messages: [ { role: 'user', content: 'Hello' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Text to Text ### Point de terminaison ```http POST /api/v1/chat/completions ``` ### Paramètres de requête #### Requis | Paramètre | Type | Description | |-----------|------|-------------| | `model` | string | Doit être `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | Messages ordonnés uniquement textuels. Prend en charge les rôles `system`, `user` et `assistant`. Consultez l'API LLM pour la structure des messages. | | `stream` | boolean | `true` pour SSE, `false` pour une réponse JSON unique. | #### Prise en charge des messages | Champ | Texte | Fichier | Image | |-------|------|------|-------| | `messages` | Requis ✅ | Non pris en charge ❌ | Non pris en charge ❌ | #### Facultatifs | Paramètre | Type | Plage | Description | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens de sortie maximum. | | `top_p` | number | `0.0` - `1.0` | Limite la masse de probabilité cumulée pour les tokens candidats. | | `top_k` | integer | `0` - `100` | Limite le nombre de tokens candidats. | ### Exemple de requête ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-text-to-text-0731', messages: [ { role: 'user', content: 'Write a four-line modern poem about a programmer drinking coffee.' } ], stream: false, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Pro Web Search ### Point de terminaison ```http POST /api/v1/chat/completions ``` ### Paramètres de requête #### Requis | Paramètre | Type | Description | |-----------|------|-------------| | `model` | string | Doit être `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | Messages ordonnés uniquement textuels. Prend en charge les rôles `system`, `user` et `assistant`. Consultez l'API LLM pour la structure des messages. | | `stream` | boolean | `true` pour SSE, `false` pour une réponse JSON unique. | #### Prise en charge des messages | Champ | Texte | Fichier | Image | |-------|------|------|-------| | `messages` | Requis ✅ | Non pris en charge ❌ | Non pris en charge ❌ | #### Facultatifs | Paramètre | Type | Plage | Description | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens de sortie maximum. | | `top_p` | number | `0.0` - `1.0` | Limite la masse de probabilité cumulée pour les tokens candidats. | | `top_k` | integer | `0` - `100` | Limite le nombre de tokens candidats. | ### Exemple de requête ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-web-search-0813', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Web Search ### Point de terminaison ```http POST /api/v1/chat/completions ``` ### Paramètres de requête #### Requis | Paramètre | Type | Description | |-----------|------|-------------| | `model` | string | Doit être `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | Messages ordonnés uniquement textuels. Prend en charge les rôles `system`, `user` et `assistant`. Consultez l'API LLM pour la structure des messages. | | `stream` | boolean | `true` pour SSE, `false` pour une réponse JSON unique. | #### Prise en charge des messages | Champ | Texte | Fichier | Image | |-------|------|------|-------| | `messages` | Requis ✅ | Non pris en charge ❌ | Non pris en charge ❌ | #### Facultatifs | Paramètre | Type | Plage | Description | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens de sortie maximum. | | `top_p` | number | `0.0` - `1.0` | Limite la masse de probabilité cumulée pour les tokens candidats. | | `top_k` | integer | `0` - `100` | Limite le nombre de tokens candidats. | ### Exemple de requête ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-web-search-0731', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## Format de réponse Les modèles LLM DeepSeek V4 renvoient des réponses de complétion compatibles avec OpenAI. Avec `stream: true`, la réponse est transmise sous forme d’événements envoyés par le serveur (SSE) ; avec `stream: false`, elle prend la forme d’un objet JSON unique. ### Réponse d'erreur ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## Bonnes pratiques 1. **Choisissez la bonne variante :** Utilisez les modèles Pro pour un raisonnement de meilleure qualité et les modèles Flash pour les workloads à latence et coût réduits. 2. **Utilisez Web Search pour les événements actuels :** Choisissez Pro ou Flash Web Search lorsque la réponse dépend d'informations en ligne à jour. 3. **Réglez soigneusement les paramètres d'échantillonnage :** `top_p` et `top_k` sont pris en charge sur toutes les variantes DeepSeek v4 et peuvent modifier la diversité de sortie. 4. **Envoyez uniquement des entrées prises en charge :** N'envoyez pas de parties fichier ou image à une route DeepSeek v4. 5. **Faites correspondre Accept au mode stream :** Utilisez `Accept: text/event-stream` pour les requêtes streaming et `Accept: application/json` pour les requêtes non streaming.