Guia do Usuário da API DeepSeek V4

1. Registro e Autenticação

A API DeepSeek V4 é compatível com o SDK da OpenAI, o que reduz significativamente os custos de migração e permite que os desenvolvedores se integrem perfeitamente às ferramentas existentes do ecossistema de IA.

Obtendo uma Chave de API

1. Visite a Plataforma DeepSeek.
2. Clique em "API Keys" -> "Create new secret key" no canto superior direito.
3. Nota: A chave é exibida apenas uma vez após a criação, portanto, salve-a com segurança.

2. Início Rápido (Exemplo em Python)

Primeiro, instale o SDK oficial da OpenAI (sim, você leu certo, basta usar o SDK da OpenAI):

pip install openai

Em seguida, basta modificar dois parâmetros: base_url e api_key.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # Sua Chave de API DeepSeek
    base_url="https://api.deepseek.com"  # Ponto chave!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # Nome do modelo, pode diferir após o lançamento da V4
    messages=[
        {"role": "system", "content": "You are a helpful AI assistant."},
        {"role": "user", "content": "Hello, please introduce DeepSeek V4."},
    ],
    stream=False
)

print(response.choices[0].message.content)

3. Recursos Avançados

3.1 Saída de Streaming

Para melhorar a experiência do usuário, recomenda-se habilitar a saída de streaming, permitindo que os usuários vejam um efeito de geração semelhante a uma máquina de escrever.

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Write a long poem about whales"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 Chamada de Função (Function Calling)

O DeepSeek V4 suporta Function Calling poderoso, capaz de analisar parâmetros JSON com precisão, tornando-o ideal para construir Agentes.

3.3 Modo JSON

Se você precisar que o modelo produza um formato JSON válido, certifique-se de especificar json_object em response_format e solicitar explicitamente a saída JSON no prompt.

4. Preços e Otimização de Custos

O preço do DeepSeek V4 é extremamente acessível (preços específicos pendentes de anúncio oficial, consulte V3 a $0,14/M tokens). Para economizar ainda mais dinheiro:

• Prompt Caching: O V4 introduz um mecanismo de cache de contexto. Se o seu System Prompt for longo (por exemplo, base de conhecimento), as solicitações subsequentes custarão significativamente menos devido aos hits de cache.
• Simplificar o Contexto: Não coloque histórico de bate-papo irrelevante nele.

5. Melhores Práticas

• Tratamento de Erros: Certifique-se de implementar try-except, especialmente para erros rate_limit_exceeded (429), com uma estratégia de repetição de backoff exponencial.
• Configurações de Tempo Limite: Tarefas de raciocínio complexas podem exigir tempos de geração mais longos, portanto, defina o tempo limite para 60s ou mais.
• System Prompt: Dê ao V4 uma "persona" clara e ele terá um desempenho melhor.

Tendo problemas? Verifique nossa Documentação da API ou junte-se à comunidade Discord para obter ajuda.