Fix DeepSeek API authentication error
DeepSeek API authentication error occurs when the api_key is missing, incorrect, or the base_url is not set properly in the OpenAI client. Fix this by passing api_key=os.environ["DEEPSEEK_API_KEY"] and base_url="https://api.deepseek.com" when initializing the client.api_error OpenAI client with both api_key=os.environ["DEEPSEEK_API_KEY"] and base_url="https://api.deepseek.com" parameters.Why this happens
This error happens because the OpenAI SDK defaults to OpenAI's API endpoint and does not automatically use DeepSeek's API URL. If you only provide api_key without specifying base_url, the client tries to authenticate against OpenAI's servers, causing authentication failure.
Typical broken code example:
from openai import OpenAI
import os
client = OpenAI(api_key=os.environ["DEEPSEEK_API_KEY"])
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)openai.error.AuthenticationError: Incorrect API key provided: sk-... (HTTP status code 401)
The fix
Specify the base_url parameter pointing to DeepSeek's API endpoint https://api.deepseek.com when creating the OpenAI client. This directs requests to DeepSeek's servers, allowing the provided API key to authenticate correctly.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com"
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Hello"}]
)
print(response.choices[0].message.content)Hello
Preventing it in production
Always validate environment variables at startup to ensure DEEPSEEK_API_KEY is set. Implement retry logic with exponential backoff for transient errors. Use centralized configuration management to avoid missing or incorrect base_url settings. Logging authentication failures early helps diagnose misconfiguration quickly.
Key Takeaways
- Always specify
base_url="https://api.deepseek.com"when using DeepSeek with the OpenAI SDK. - Use environment variables for API keys and validate them before making requests.
- Implement retry and error handling to maintain robust AI integrations.