URL e Base URL da API DeepSeek: Como Alternar
A URL da API deepseek que você copia da documentação oficial da DeepSeek é uma base URL e funciona apenas com a chave da DeepSeek e os modelos da DeepSeek. Se quiser um endpoint estilo OpenAI diferente, altere essa URL, a chave e o ID do modelo.
Atualizado
Pontos principais
- Uma base URL é o prefixo; o SDK adiciona /chat/completions a ela.
- Este serviço usa https://api.getdeepseekapi.com/v1 com o ID do modelo uncensored.
- Não é a API da DeepSeek, então uma chave DeepSeek não funcionará aqui e o inverso também.
- A maioria dos clientes também aceita a URL e a chave por OPENAI_BASE_URL e OPENAI_API_KEY.

Base URL, endpoint e caminho: as três partes
As pessoas costumam colar um endereço completo em um campo que espera um prefixo e acabam recebendo 404. Três termos ajudam a manter isso claro.
- Base URL: o prefixo compartilhado de todas as chamadas, por exemplo
https://api.getdeepseekapi.com/v1. É isso que você insere na configuração "API base" ou "Base URL" de um cliente. - Caminho do endpoint: a parte adicionada pelo SDK, como
/chat/completions,/responsesou/models. - URL completa: base mais caminho, como
https://api.getdeepseekapi.com/v1/chat/completions. Clientes HTTP brutos como curl precisam disso.
A regra que atinge a maioria das pessoas: SDKs e apps pedem a base URL, curl e nós HTTP pedem a URL completa. Se uma ferramenta retornar 404, verifique primeiro se você colocou uma URL completa onde era esperada uma base, ou o contrário. Um caminho duplicado como /v1/chat/completions/chat/completions no erro é a pista.
O que é a URL base da DeepSeek e o que não é
A DeepSeek publica seu próprio endereço de API na documentação, junto com os nomes de modelo que sua chave pode usar. Consulte lá o valor atual em vez de confiar em um post de blog, incluindo este. Uma chave DeepSeek funciona contra o endpoint da DeepSeek e em nenhum outro lugar.
O serviço neste site é um produto separado. Não é a API oficial da DeepSeek, não encaminha para a DeepSeek e não serve modelos DeepSeek. É uma API hospedada e compatível com OpenAI para um único modelo de pesos abertos, executada por um provedor independente e ajustada para responder sem recusas de conteúdo para uso adulto lícito. Seu endereço é:
https://api.getdeepseekapi.com/v1 # model: uncensored
O ID do modelo é uncensored e a autenticação é Authorization: Bearer <key>. As chaves são emitidas na página de chave de API. Se você está comparando o que uma chave significa para cada serviço, a página sobre a chave de API DeepSeek tem mais detalhes.
Alterando endpoints nos SDKs OpenAI
Qualquer SDK da OpenAI funciona assim que você altera a URL base e a chave. Em Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
No Node.js o campo é escrito como baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
Observe a diferença: Python usa base_url, Node usa baseURL. Misturá-los silenciosamente retorna ao padrão para o endereço OpenAI, que então rejeita sua chave.
Alternando sem tocar no código
Os SDKs oficiais da OpenAI leem duas variáveis de ambiente, então um aplicativo existente pode ser redirecionado sem alteração de código:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
O nome do modelo é a parte que você não pode pular. Se o app codificar outro ID de modelo, ele pedirá esse e falhará, então altere-o para uncensored nas configurações ou no arquivo de configuração do app. Muitas ferramentas expõem os três valores em uma única tela de configurações, geralmente rotulados como API base, chave de API e modelo.
A mesma troca de três valores funciona em frameworks. Com LangChain em Python, por exemplo, ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored") é suficiente. Ferramentas de programação que aceitam um endpoint compatível com OpenAI funcionam da mesma maneira; veja o tutorial em usando uma API para codificação.
HTTP bruto: os caminhos exatos
Para curl, scripts e nós HTTP você constrói a URL completa manualmente. Estes são os caminhos neste serviço:
| Finalidade | Método e URL |
|---|---|
| Chat | POST https://api.getdeepseekapi.com/v1/chat/completions |
| API de Respostas | POST https://api.getdeepseekapi.com/v1/responses |
| Lista de modelos | GET https://api.getdeepseekapi.com/v1/models |
| Saldo | GET https://api.getdeepseekapi.com/v1/balance |
| Saldo, estilo OpenAI | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Use apenas HTTPS. O streaming funciona com "stream": true via Server-Sent Events, e a mesma URL atende ambos os modos.
Inserindo a URL em aplicativos com tela de configurações
Muitas interfaces de chat, editores e ferramentas de automação têm uma opção "endpoint compatível com OpenAI personalizado". Os rótulos diferem, mas os campos mapeiam um para um:
| Campo no app | Valor |
|---|---|
| API base, URL base, Endpoint, URL do servidor | https://api.getdeepseekapi.com/v1 |
| Chave de API, Token, Segredo | Sua chave para este serviço |
| Modelo, Nome do modelo, ID do modelo | uncensored |
Alguns apps querem uma URL de chat completa em vez de uma base. Nesse caso, use https://api.getdeepseekapi.com/v1/chat/completions. Se o app tiver um botão "testar conexão", ele geralmente chama a lista de modelos, que é GET /v1/models. Se o botão falhar mas um chat manual funcionar, a verificação do app é mais rigorosa que a API e você pode ignorá-la.
Um teste rápido de sanidade apenas da URL
Antes de depurar um app, prove a URL com a lista de modelos. Ela não precisa de corpo e não custa nada:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
Você deve receber JSON de volta com um array de dados. Uma página HTML de erro indica host ou caminho incorretos, como um subdomínio ausente: o host começa com api., não www..
Corrigindo os erros comuns
- 404 Não Encontrado. A base URL está faltando
/v1, tem duas vezes, ou inclui o caminho do endpoint. - 401 ou um erro de autenticação. Você usou uma chave de outro serviço, ou o cabeçalho não contém
Bearer. Chaves não são intercambiáveis entre provedores. - Modelo não encontrado. A solicitação ainda nomeia um modelo do provedor antigo. Defina
uncensored. - O app ainda fala com o serviço antigo. Algumas ferramentas armazenam configurações em cache ou leem uma variável diferente. Reinicie o processo e verifique a tela de configurações.
- Problema com barra final. A maioria dos clientes lida bem, mas se um não lidar, remova a barra final da base URL.
Se você não tem certeza de qual lado está falhando, envie o comando curl acima. Uma resposta 200 prova a URL, a chave e o modelo; qualquer outra falha está no seu app. A documentação lista limites e cabeçalhos como X-Request-Id, o que ajuda ao entrar em contato com o suporte.
O que permanece igual após a troca
As formas de solicitação e resposta seguem o formato da OpenAI, então arrays de mensagens, temperature, top_p, stop, seed, penalidades, chamada de funções e modo JSON funcionam como de costume. A janela de contexto é de 100.000 tokens para prompt mais conclusão, e o corpo máximo da requisição é de 8 MB. O serviço é apenas de texto: sem imagens, áudio, embeddings ou ajuste fino, então recursos baseados nesses recursos precisam de um provedor diferente.
A cobrança também é separada do provedor antigo: $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída a partir de crédito pré-pago, conforme mostrado na página de preços. Novos usuários podem reivindicar $0,50 de crédito de teste para verificar se a troca funciona antes de pagar qualquer coisa.
Mais guias
Perguntas e respostas
Qual é a URL base da API DeepSeek?
A DeepSeek publica isso em sua própria documentação, então verifique lá o valor atual. O endpoint neste site é um serviço diferente em https://api.getdeepseekapi.com/v1.
Posso usar uma chave DeepSeek neste endpoint?
Não. Chaves são emitidas por serviço. Obtenha uma chave para esta API na página de chaves e defina o modelo como uncensored.
A base URL deve terminar com /v1?
Sim para este serviço: https://api.getdeepseekapi.com/v1. SDKs adicionam o caminho do endpoint depois disso, então não adicione /chat/completions você mesmo.
Por que recebo 404 após alterar a URL?
Geralmente o caminho está duplicado ou falta /v1. Compare sua URL base com o valor exato acima.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.