시작하기

API 키를 발급받고 엔드포인트를 고른 뒤 첫 요청을 보내세요. HTTP API를 직접 호출하거나 클라이언트를 설정할 수 있습니다.

1. 가입하고 API Key를 복사한다

가입을 열고 로그인한 뒤 API Keys에서 Key를 복사합니다. Key는 해당 클라이언트 자신의 설정이나 로그인 명령에만 둡니다. 저장소, 스크린샷, 채팅에는 넣지 마세요. 유출되면 같은 페이지에서 "Key 교체"를 누르며, 이전 Key는 즉시 무효가 됩니다.

2. 엔드포인트를 선택한다

엔드포인트 선택에서 사용할 모델 계열마다 엔드포인트를 고르고 저장합니다. 일부 모델은 지정된 엔드포인트에만 있습니다. Claude Fable 5는 "Claude Max 20x 구독"이 필요합니다. 선택하지 않은 계열로 보낸 요청은 실패하며, 자동으로 골라 주지 않습니다.

첫 API 요청 보내기

터미널에서 사이트 API Key를 환경 변수 ICODEEASY_API_KEY로 설정합니다. 예시는 deepseek-flash를 사용합니다. 직접 HTTP 호출과 Chat Completions를 지원하는 DeepSeek 엔드포인트를 먼저 선택하거나 선택한 엔드포인트에서 지원하는 모델 ID로 바꾸세요.

curl -sS https://api.icodeeasy.cc/v1/chat/completions \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"model":"deepseek-flash","messages":[{"role":"user","content":"Say hello."}],"stream":false}'

HTTP 200이 반환되면 choices[0].message.content에서 답변을 읽습니다.

첫 이미지 또는 동영상 생성

• 이미지. POST /v1/images/generations?sync=1로 프롬프트를 보내고 HTTP 200이 반환되면 data[0].url을 엽니다. ?async=1을 사용하면 task_id를 저장하고 GET /v1/images/tasks/{task_id}를 completed까지 조회한 뒤 result_url을 읽습니다. 이미지 요청 예시를 참고하세요.
• 동영상. POST /v1/videos/generations로 작업을 생성합니다. HTTP 202가 반환되면 task_id를 저장하고 status_url을 조회합니다. succeeded가 되면 content_url로 다운로드합니다. 동영상 빠른 시작을 참고하세요.

클라이언트 설정

기본 API 주소:

https://api.icodeeasy.cc

이 도메인이 느리거나 시간 초과되면 경로와 Key는 그대로 두고 예비 주소로 바꿉니다.

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

클라이언트마다 넣는 항목이 다릅니다. 해당 문서를 따르고, 한 설정을 다른 클라이언트에 그대로 붙이지 마세요.

• Claude Code / Desktop
• Codex
• Gemini CLI: 주소는 도메인만. /v1beta를 붙이지 않음
• ICodeEasy

같은 Key를 이 클라이언트들에서 함께 쓸 수 있습니다. 하나의 Key로 여러 클라이언트를 보세요.

클라이언트에서 메시지를 한 번 보내고 답변을 확인하세요.

요청 결과 확인

응답을 받으면 요청 로그에서 모델, 상태, 요금을 확인하세요. 요금은 가격 페이지와 가격, 잔액, 사용 내역을 참고하세요.

Node.js가 없으면 먼저 환경 준비를 합니다. 401, 429, 연결이 끝나지 않으면 연결 점검을 보세요.