API 빠른 시작
다음 예시로 앱이나 스크립트에서 API를 호출하세요. Claude Code, Codex 등은 도구 설정 가이드를 참고하세요.
- 지갑을 충전하고 API 키를 만드세요.
- 모델 목록에서 사용할 엔드포인트에 맞는 모델을 선택하세요.
- 아래 안내대로
CODEBYAI_API_KEY를 설정하고MODEL_ID를 선택한 모델로 바꾼 뒤 요청을 실행하세요. 성공한 요청은 잔액을 사용합니다. 키를 공유하지 마세요.
Messages는 Claude를 지원합니다. Responses는 GPT·Codex·Claude를 지원하며 Chat Completions는 Grok도 지원합니다. Gemini 모델은 Gemini 엔드포인트를 사용합니다. 알 수 없는 ID는 HTTP 400을 반환합니다. 기본 모델을 쓰기 위해 생략할 수 있는 것은 Messages·Responses·Chat Completions의 JSON model 필드뿐입니다. Gemini URL에는 모델 ID가 필수입니다.
터미널 환경 설정
curl 7.76+, Python 3.10+ 또는 Node.js 20+를 사용하세요. SDK 설치는 필요하지 않습니다. 설정 명령의 YOUR_API_KEY만 본인의 키로 바꾸고 CODEBYAI_API_KEY라는 이름은 유지하세요. 요청을 실행할 터미널에서 설정해야 하며 새 터미널을 열면 다시 설정해야 합니다.
macOS / Linux (bash / zsh):
1 export CODEBYAI_API_KEY="YOUR_API_KEY"
Windows PowerShell(Python 및 JavaScript 예제용):
1 $env:CODEBYAI_API_KEY="YOUR_API_KEY"
생성한 예제 실행
홈페이지 생성기에서 프로토콜, 모델, 언어를 선택한 뒤 예제를 복사하세요. 스크립트를 일반 텍스트로 저장하고 키를 설정한 동일한 터미널에서 파일이 있는 폴더로 이동해 실행하세요.
| 언어 | 저장 파일 | 실행 방법 |
|---|---|---|
| curl | 필요 없음 | bash / zsh에 붙여 넣기 |
| Python | request.py | python3 request.py |
| JavaScript | request.mjs | node request.mjs |
Windows의 Python은 python request.py로 실행하세요. Node.js 명령은 동일합니다. curl 예제는 bash / zsh 문법을 사용하므로 Windows에서는 Git Bash 또는 WSL을 사용하세요. Python이나 JavaScript 코드를 shell에 직접 붙여 넣지 마세요. 아래 curl 예제도 동일한 환경 변수를 읽습니다.
Set CODEBYAI_API_KEY가 표시되면 동일한 터미널에서 키를 다시 설정하세요. HTTP 오류는 상태 코드와 오류 내용을 출력하므로 원인을 확인한 후 다시 실행하세요.
Anthropic Messages
1 curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/messages \2 -H "x-api-key: ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "anthropic-version: 2023-06-01" \4 -H "content-type: application/json" \5 -d '{"model":"MODEL_ID","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'
Claude 모델만 처리합니다. 이 엔드포인트는 x-api-key를 먼저 읽습니다. anthropic-version은 Claude 채널로 전달됩니다.
OpenAI Responses
1 curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/responses \2 -H "Authorization: Bearer ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "content-type: application/json" \4 -d '{"model":"MODEL_ID","input":"Hello"}'
GPT, Codex, 그리고 claude-*를 처리합니다. claude-*는 Claude 채널로 전달되어 Claude 가격으로 청구됩니다.
OpenAI Chat Completions
1 curl --fail-with-body --max-time 120 https://www.codebyai.net/api/agent/v1/chat/completions \2 -H "Authorization: Bearer ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "content-type: application/json" \4 -d '{"model":"MODEL_ID","messages":[{"role":"user","content":"Hello"}]}'
Chat Completions는 GPT·Codex·Claude·Grok을 지원합니다. Responses는 Grok을 지원하지 않습니다. OpenAI SDK의 base URL은 https://www.codebyai.net/api/agent/v1 또는 https://www.codebyai.net/api/agent입니다.
Gemini
1 curl --fail-with-body --max-time 120 "https://www.codebyai.net/api/agent/v1beta/models/MODEL_ID:generateContent" \2 -H "x-goog-api-key: ${CODEBYAI_API_KEY:?Set CODEBYAI_API_KEY}" \3 -H "content-type: application/json" \4 -d '{"contents":[{"role":"user","parts":[{"text":"Hello"}]}]}'
Gemini 모델만 처리합니다. 키 헤더는 x-goog-api-key입니다.
응답 확인
성공하면 HTTP 200을 반환합니다. 아래 필드에서 생성 텍스트와 토큰 사용량을 확인할 수 있으며, 전체 응답은 모델마다 다릅니다.
| 프로토콜 | 생성 텍스트 | 토큰 사용량 |
|---|---|---|
| Messages | content[].text | usage |
| Responses | output[].content[].text | usage |
| Chat Completions | choices[].message.content | usage |
| Gemini | candidates[].content.parts[].text | usageMetadata |
400이면 모델 ID와 엔드포인트를 확인하세요. 인증 또는 잔액 문제는 일반적인 오류를 참고하세요.