문서

API 빠른 시작

다음 예시로 앱이나 스크립트에서 API를 호출하세요. Claude Code, Codex 등은 도구 설정 가이드를 참고하세요.

  1. 지갑을 충전하고 API 키를 만드세요.
  2. 모델 목록에서 사용할 엔드포인트에 맞는 모델을 선택하세요.
  3. 아래 안내대로 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에 붙여 넣기
Pythonrequest.pypython3 request.py
JavaScriptrequest.mjsnode 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을 반환합니다. 아래 필드에서 생성 텍스트와 토큰 사용량을 확인할 수 있으며, 전체 응답은 모델마다 다릅니다.

프로토콜생성 텍스트토큰 사용량
Messagescontent[].textusage
Responsesoutput[].content[].textusage
Chat Completionschoices[].message.contentusage
Geminicandidates[].content.parts[].textusageMetadata

400이면 모델 ID와 엔드포인트를 확인하세요. 인증 또는 잔액 문제는 일반적인 오류를 참고하세요.

다음