# API DeepSeek v4 Referência completa da API para modelos LLM DeepSeek v4 desenvolvidos pela DeepSeek. ## Atualizações do modelo ### DeepSeek v4 Pro 0813 - A Flaq AI atualizou o DeepSeek v4 Pro para a versão oficial `deepseek-v4-pro-0813` da DeepSeek. - Use os IDs de modelo `0813` abaixo para acessar a versão oficial. - Os IDs originais dos modelos Pro não estão disponíveis. | Variante | ID de modelo 0813 | ID de modelo indisponível | |----------|-------------------|---------------------------| | Texto para texto | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Pesquisa na web | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - A Flaq AI atualizou o DeepSeek v4 Flash para a versão oficial `deepseek-v4-flash-0731` da DeepSeek. - Use os IDs de modelo `0731` abaixo para acessar a versão atualizada. - Os IDs originais dos modelos Flash não estão disponíveis. | Variante | ID de modelo 0731 | ID de modelo indisponível | |----------|-------------------|---------------------------| | Texto para texto | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Pesquisa na web | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## Variantes do modelo Esta API oferece suporte a quatro variantes do modelo DeepSeek v4: | Modelo | ID | Descrição | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | Raciocínio e escrita de texto de alta qualidade | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | Geração de texto mais rápida e mais acessível | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | Respostas com contexto da web usando o raciocínio do DeepSeek v4 Pro | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | Respostas com contexto da web mais rápidas usando DeepSeek v4 Flash | ## Comparação rápida | Recurso | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | Entrada de texto | Obrigatório ✅ | Obrigatório ✅ | Obrigatório ✅ | Obrigatório ✅ | | Entrada de imagem | Não suportado ❌ | Não suportado ❌ | Não suportado ❌ | Não suportado ❌ | | Entrada de arquivo | Não suportado ❌ | Não suportado ❌ | Não suportado ❌ | Não suportado ❌ | | Web search | Não suportado ❌ | Não suportado ❌ | Ativado ✅ | Ativado ✅ | | Resposta em streaming | SSE | SSE | SSE | SSE | | `max_tokens` | Opcional | Opcional | Opcional | Opcional | | `top_p` | Opcional | Opcional | Opcional | Opcional | | `top_k` | Opcional | Opcional | Opcional | Opcional | ## DeepSeek v4 Pro Text to Text ### Ponto de acesso ```http POST /api/v1/chat/completions ``` ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model` | string | Deve ser `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | Mensagens ordenadas somente de texto. Aceita os papéis `system`, `user` e `assistant`. Consulte a LLM API para a estrutura da mensagem. | | `stream` | boolean | `true` para SSE, `false` para uma única resposta JSON. | #### Suporte a mensagens | Campo | Texto | Arquivo | Imagem | |-------|------|------|-------| | `messages` | Obrigatório ✅ | Não suportado ❌ | Não suportado ❌ | #### Opcionais | Parâmetro | Tipo | Intervalo | Descrição | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Máximo de tokens de saída. | | `top_p` | number | `0.0` - `1.0` | Limita a massa de probabilidade cumulativa dos tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita o número de tokens candidatos. | ### Exemplo de requisição ```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 ### Ponto de acesso ```http POST /api/v1/chat/completions ``` ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model` | string | Deve ser `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | Mensagens ordenadas somente de texto. Aceita os papéis `system`, `user` e `assistant`. Consulte a LLM API para a estrutura da mensagem. | | `stream` | boolean | `true` para SSE, `false` para uma única resposta JSON. | #### Suporte a mensagens | Campo | Texto | Arquivo | Imagem | |-------|------|------|-------| | `messages` | Obrigatório ✅ | Não suportado ❌ | Não suportado ❌ | #### Opcionais | Parâmetro | Tipo | Intervalo | Descrição | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Máximo de tokens de saída. | | `top_p` | number | `0.0` - `1.0` | Limita a massa de probabilidade cumulativa dos tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita o número de tokens candidatos. | ### Exemplo de requisição ```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 ### Ponto de acesso ```http POST /api/v1/chat/completions ``` ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model` | string | Deve ser `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | Mensagens ordenadas somente de texto. Aceita os papéis `system`, `user` e `assistant`. Consulte a LLM API para a estrutura da mensagem. | | `stream` | boolean | `true` para SSE, `false` para uma única resposta JSON. | #### Suporte a mensagens | Campo | Texto | Arquivo | Imagem | |-------|------|------|-------| | `messages` | Obrigatório ✅ | Não suportado ❌ | Não suportado ❌ | #### Opcionais | Parâmetro | Tipo | Intervalo | Descrição | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Máximo de tokens de saída. | | `top_p` | number | `0.0` - `1.0` | Limita a massa de probabilidade cumulativa dos tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita o número de tokens candidatos. | ### Exemplo de requisição ```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 ### Ponto de acesso ```http POST /api/v1/chat/completions ``` ### Parâmetros da requisição #### Obrigatórios | Parâmetro | Tipo | Descrição | |-----------|------|-------------| | `model` | string | Deve ser `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | Mensagens ordenadas somente de texto. Aceita os papéis `system`, `user` e `assistant`. Consulte a LLM API para a estrutura da mensagem. | | `stream` | boolean | `true` para SSE, `false` para uma única resposta JSON. | #### Suporte a mensagens | Campo | Texto | Arquivo | Imagem | |-------|------|------|-------| | `messages` | Obrigatório ✅ | Não suportado ❌ | Não suportado ❌ | #### Opcionais | Parâmetro | Tipo | Intervalo | Descrição | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Máximo de tokens de saída. | | `top_p` | number | `0.0` - `1.0` | Limita a massa de probabilidade cumulativa dos tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita o número de tokens candidatos. | ### Exemplo de requisição ```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 }) }); ``` ## Formato da resposta Os modelos LLM DeepSeek V4 retornam respostas de conclusão compatíveis com a OpenAI. Com `stream: true`, a resposta é transmitida por eventos enviados pelo servidor (SSE); com `stream: false`, ela é retornada como um único objeto JSON. ### Resposta de erro ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## Boas práticas 1. **Escolha a variante certa:** Use modelos Pro para raciocínio de maior qualidade e modelos Flash para cargas de trabalho de menor latência e menor custo. 2. **Use Web Search para eventos atuais:** Escolha Pro ou Flash Web Search quando a resposta depender de informações online atualizadas. 3. **Ajuste os parâmetros de amostragem com cuidado:** `top_p` e `top_k` são compatíveis com todas as variantes DeepSeek v4 e podem alterar a diversidade da saída. 4. **Envie apenas entradas suportadas:** Não envie partes de arquivo ou imagem para nenhuma rota DeepSeek v4. 5. **Combine Accept com o modo stream:** Use `Accept: text/event-stream` para requisições de streaming e `Accept: application/json` para requisições sem streaming.