DeepSeek 설정
이 가이드에는 API 키가 필요합니다
계정을 만들고 약 1분 안에 키를 발급한 뒤, 아래 단계에서 키가 필요한 자리에 사용하세요.
가입 시 카드 불필요 · API 사용에는 충전이 필요합니다
DeepSeek 모델은 Code By AI의 OpenAI 호환 Chat Completions 엔드포인트로 사용할 수 있습니다. OpenAI SDK 또는 호환 클라이언트의 base URL을 이 사이트로 지정하고, Code By AI API 키를 사용하며, 요청마다 DeepSeek 모델 ID를 명시하세요.
모델과 가격
deepseek-v4.1-flashdeepseek-v4-pro
두 모델 모두 채널 기본값이 아니므로 요청마다 정확한 ID를 지정하세요. 현재 입력, 캐시 적중, 출력 요금은 DeepSeek 가격 페이지에서 확인하세요. 비첨두(계곡) 요금은 하루 종일 적용되며 첨두 할증은 없습니다.
환경 변수 설정
아래 두 변수는 OpenAI 호환 클라이언트가 읽습니다. API 키는 API Keys 페이지에서 만듭니다.
macOS 또는 Linux
~/.zshrc(zsh) 또는 ~/.bashrc(bash)에 다음 줄을 추가한 뒤 source로 다시 읽으세요.
1 export OPENAI_BASE_URL="https://www.codebyai.net/api/agent"2 export OPENAI_API_KEY="sk-proj-xxxx"
Windows
명령 프롬프트에서 같은 변수를 사용자 계정에 설정합니다.
1 setx OPENAI_BASE_URL "https://www.codebyai.net/api/agent"2 setx OPENAI_API_KEY "sk-proj-xxxx"
setx 후에는 새 터미널을 열어 클라이언트가 값을 읽도록 하세요.
Chat Completions 요청 보내기
클라이언트는 OpenAI 호환 Chat Completions를 사용해야 합니다. /api/agent/v1/chat/completions와 /api/agent/chat/completions가 모두 라우팅됩니다.
1 curl --fail-with-body "https://www.codebyai.net/api/agent/v1/chat/completions" \2 -H "Authorization: Bearer $OPENAI_API_KEY" \3 -H "content-type: application/json" \4 -d '{5 "model": "deepseek-v4.1-flash",6 "messages": [{ "role": "user", "content": "Hello" }]7 }'
더 큰 모델을 쓰려면 모델 ID를 deepseek-v4-pro로 바꾸세요. Responses 엔드포인트는 DeepSeek을 제공하지 않으며, model을 생략해도 DeepSeek 모델이 선택되지 않습니다.
OpenAI SDK 사용
공식 SDK는 위에서 설정한 환경 변수 OPENAI_BASE_URL과 OPENAI_API_KEY를 읽습니다. 호출마다 모델 ID를 지정하세요.
1 from openai import OpenAI2 3 client = OpenAI()4 response = client.chat.completions.create(5 model="deepseek-v4.1-flash",6 messages=[{"role": "user", "content": "Hello"}],7 )8 print(response.choices[0].message.content)
문제 해결
403과Invalid key가 반환되면 키가 유효하지 않거나 폐기되었거나 만료된 것입니다.OPENAI_API_KEY를 확인하고Authorization헤더에서 키를Bearer토큰으로 보내는지 확인하세요.400 Unknown model은 ID가 카탈로그에 없음을 뜻합니다.deepseek-v4.1-flash또는deepseek-v4-pro를 정확히 사용하세요./v1/responses의400은 정상입니다. DeepSeek은 Chat Completions로만 제공됩니다.- 잔액과 모델별 사용량은 대시보드에서 확인할 수 있습니다. 모델 응답 전에 거부된 요청은 과금되지 않습니다.
시작하기
첫 요청까지 네 단계
- 01
무료 계정 만들기
Google, GitHub 또는 이메일과 비밀번호로 가입하세요. 카드는 필요하지 않습니다.
- 02
API 키 생성하기
대시보드에서 한 번 클릭해 키를 만들고 CLI를 Code By AI에 인증하세요.
- 03
잔액 충전하기
첫 요청 전에 잔액을 충전하세요. 사용량은 토큰 단위로 잔액에서 차감됩니다.
- 04
CLI를 Code By AI로 연결하기
base URL 환경 변수를 하나 설정하거나 config.toml에 model provider 블록을 추가하세요. 각 에이전트에 필요한 정확한 설정은 가이드에 정리되어 있습니다.