계정 설정

계정을 만들고 이메일 인증하기

spicyapi.ai/register를 여세요. 가입 방법은 세 가지입니다.

서비스 약관과 개인정보처리방침 동의에 체크한 뒤 계정 만들기를 누르세요.

이렇게 보여야 합니다: 이메일 계정이라면 메일함을 확인하세요라는 제목의 페이지가 나옵니다. 받은 메일을 열고 링크를 클릭하세요. 이메일 인증 완료 페이지가 인증을 확인해 주고, 콘솔로 이동을 누르면 콘솔로 들어갑니다.

이 단계에서 일어난 일: 계정이 만들어졌지만, 이메일을 인증해야 API를 호출할 수 있습니다. 인증 전까지 콘솔에는 다음 배너가 표시됩니다: 이메일 미인증 — API 호출이 거부됩니다.

• 링크는 한 번만 쓸 수 있고 24시간 뒤에 만료됩니다. 만료됐다면 그래도 링크를 열어 인증 링크 다시 보내기를 쓰거나, 콘솔 배너의 인증하기를 누르세요.
• 몇 분이 지나도 메일이 오지 않나요? 스팸함을 확인한 뒤 다시 보내기를 누르세요.

잔액 충전하기

콘솔에서 결제를 여세요: spicyapi.ai/console/billing. 잔액 충전에서 다음 순서로 진행합니다.

1. 금액을 고릅니다. 미리 정해진 금액(예: $10, $25, $50, $100) 가운데 하나를 고르거나, 직접 입력을 눌러 원하는 금액을 입력하세요. 한 번에 충전할 수 있는 최소·최대 금액이 콘솔에 표시됩니다. 온라인 결제는 소수점 이하 둘째 자리까지만 받습니다.
2. 보너스를 확인합니다. 일부 금액에는 프로모션 보너스가 붙으며, 결제 전에 +$… 보너스로 표시됩니다. 보너스는 결제한 금액과 별도의 항목으로 추가됩니다.
3. 결제 방법을 고르고 아래 탭의 안내를 따르세요.

그 밖에 볼 수 있는 메시지:

• 지금은 충전할 수 없습니다 또는 현재 충전 주문을 만들 수 없습니다: 충전이 일시적으로 닫혀 있거나, 대기 중인 주문이 너무 많습니다. 충전 주문에서 예전 주문을 마무리하거나 취소하고, 아니면 나중에 다시 시도하세요.
• 연결이 끊겨 결과를 알 수 없습니다: 두 번 결제하지 않도록, 다시 시도하기 전에 충전 주문을 먼저 확인하세요.

선택: 자동 충전 켜기

자동 충전은 잔액이 줄어들면 저장해 둔 카드로 알아서 결제해, 오래 걸리는 작업이 40201 때문에 중간에 멈추지 않게 해 줍니다. 카드로만 쓸 수 있습니다.

1. 결제에서 자동 충전을 찾아 결제 수단 안전하게 저장을 누릅니다.
2. 열리는 보안 페이지에 카드 정보를 입력합니다. 카드 정보는 결제 대행사에만 보관됩니다.
3. 결제 페이지로 돌아오면 결제 수단을 확인하고 있습니다가 표시된 뒤 결제 수단을 저장했습니다로 바뀝니다. 이 카드는 사용할 수 없습니다가 표시되면 아무것도 저장되지 않은 것이니 다른 카드로 시도하세요.
4. 세 칸을 채웁니다.
   • 잔액이 이 금액 미만이면 충전: 결제를 시작하는 기준 잔액입니다.
   • 1회 충전 금액: 한 번 결제할 때마다 충전되는 금액입니다. 일반 충전과 같은 범위 안이어야 합니다.
   • 월 한도: 자동 충전이 한 달(달력 기준) 동안 결제할 수 있는 최대 금액입니다. 1회 충전 금액보다 낮게 정할 수 없습니다.
5. 승인 항목에 체크하고 자동 충전 켜기를 누릅니다.

이렇게 보여야 합니다: 자동 충전을 이 한도로 켰습니다. 카드에는 "잔액이 $10 미만이 되면 $50 자동 충전"처럼 규칙이 표시되고, 이번 달 사용액도 함께 나옵니다.

정확한 규칙:

• 약 30초에서 2분마다 잔액을 확인합니다. 사용 가능 잔액이 기준 금액 이하이면 저장된 카드로 설정한 금액을 결제합니다.
• 자동 결제 한 건 한 건은 자동 충전 태그가 붙은 일반 충전 주문입니다. 같은 금액을 직접 충전할 때와 똑같은 보너스를 받고, 인보이스도 발행할 수 있습니다.
• 월 한도는 UTC 기준 달력의 한 달 단위로 셉니다. 한도를 다 쓰면 자동 충전은 다음 달 1일까지 기다립니다. 실패한 결제는 한도에 포함되지 않습니다.
• 결제가 실패하면 1시간 뒤에 다시 시도하고, 그다음 6시간 뒤에 한 번 더 시도합니다. 세 번 연속으로 실패하면 자동 충전이 스스로 꺼집니다. 은행이 카드를 아예 거절하면(예: 도난 신고되었거나 해지된 카드) 즉시 꺼집니다. 결제에 한 번 성공하면 실패 횟수는 초기화됩니다.
• 스스로 꺼진 뒤에는 카드 문제를 해결하거나 새 카드를 저장한 다음 다시 켜세요.
• 자동 충전 끄기를 누르면 언제든 이후의 결제가 멈춥니다. 잔액이나 이미 처리된 충전에는 아무 영향이 없습니다.

API 키 만들기

API 키를 엽니다: spicyapi.ai/console/keys. 키 만들기(또는 첫 키 만들기)를 누르세요.

API 키 만들기 대화상자에서 필수 항목은 이름뿐입니다. 고급 설정 아래의 항목은 모두 나중에 바꿀 수 있습니다.

이름. production backend나 my laptop처럼 키를 쓸 곳의 이름을 붙이세요. 나중에 키를 폐기할 때 알아볼 수 있어야 합니다. 최대 120자입니다.

지출 한도 (고급 설정 아래, 미국 달러 기준). 한도에 닿으면 기간이 바뀔 때까지 이 키로 보내는 새 작업이 40202로 거부됩니다. 다른 키는 계속 작동합니다. 아직 실행 중인 작업을 위해 예약된 금액도 모든 한도에 포함됩니다.

어느 한도에든 0을 입력하면 한도 없음입니다. 빈칸으로 두어도 마찬가지입니다.

접근 제한.

• 허용할 모델. 전체 모델 (제한 없음) 상태로 두면 나중에 추가되는 모델을 포함해 모든 모델을 호출할 수 있습니다. 특정 모델을 고르면 그 밖의 모델은 40301로 거부됩니다.
• IP 허용 목록. 모든 주소는 어디서 오는 호출이든 받습니다. 지정한 주소만은 목록에 적은 주소에서 오는 호출만 받습니다. IPv4, IPv6, 또는 203.0.113.10, 198.51.100.0/24 같은 CIDR 대역을 쉼표로 구분해 최대 64개까지 적을 수 있습니다. 사무실이나 집 내부 네트워크의 주소가 아니라, 서버가 외부로 호출할 때 쓰는 공인 주소를 적으세요. 그 밖의 곳에서 오는 호출은 40302로 거부됩니다. 주소가 자주 바뀌는 노트북에서는 모든 주소로 두세요.
• 만료. 7일, 30일, 90일, 1년, 만료 없음, 또는 정확한 날짜 중에서 고릅니다. 키는 그날의 UTC 기준 하루가 끝나는 시점에 작동을 멈추며, 그 뒤로는 폐기된 키와 똑같이 401을 받습니다.

키 만들기를 누르세요.

이렇게 보여야 합니다: 키를 만들었습니다 대화상자에 sk-spicy-로 시작하는 키 전체가 표시됩니다. 키 복사로 복사하거나 파일로 저장을 누르세요. 이 키를 안전한 곳에 저장했습니다에 체크한 뒤 완료를 누릅니다.

이 단계에서 일어난 일: 키 전체가 표시되는 것은 이번 한 번뿐입니다. 저희는 키의 단방향 해시만 보관하므로, 지원팀을 포함해 누구도 키를 다시 보여 드릴 수 없습니다. 잃어버렸다면 폐기하고 새로 만드세요.

나중에 같은 페이지에서 할 수 있는 일:

• 편집으로 이름, 한도, 허용할 모델, IP 허용 목록, 만료를 바꿀 수 있습니다. 변경은 바로 적용됩니다.
• 폐기하면 키가 즉시 멈추며 되돌릴 수 없습니다. 이미 접수된 작업은 계속 실행되고 비용도 그대로 청구됩니다.
• 한 범위에 활성 키를 최대 50개까지 둘 수 있습니다. 앱이나 환경마다 키를 하나씩 쓰면, 다른 키를 멈추지 않고 하나만 폐기할 수 있습니다.

키를 SPICY_API_KEY에 넣기

환경 변수는 터미널이 자신이 실행하는 프로그램에 넘겨주는, 이름이 붙은 값입니다. 공식 SDK, CLI, MCP 서버와 이 문서의 모든 예제는 SPICY_API_KEY라는 환경 변수에서 키를 읽습니다. 이렇게 하면 키를 명령에 직접 입력하거나 프로젝트 안에 저장할 필요가 없습니다.

먼저 터미널을 여세요. macOS에서는 Cmd + Space를 누르고 Terminal을 입력한 뒤 Enter를 누릅니다. Windows에서는 시작 메뉴를 열고 PowerShell을 입력한 뒤 Windows PowerShell을 엽니다.

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

서버에서는 프로젝트 안의 파일 대신 호스팅 서비스의 비밀 설정이나 환경 변수 설정에 SPICY_API_KEY를 넣으세요.

무료 테스트 호출하기

잔액을 조회하는 호출입니다. 비용이 들지 않고 아무것도 만들지 않으며, 한 번에 세 가지를 확인해 줍니다. 키가 설정되어 있는지, 키가 유효한지, 내 계정이 API를 호출할 수 있는지입니다.

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

예상 결과: 다음과 같은 응답이 옵니다(일부 생략).

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

응답의 의미: "code": 200은 성공입니다. 금액은 텍스트로 적힌 미국 달러입니다. available은 새 생성에 쓸 수 있는 금액, held는 아직 실행 중인 생성을 위해 예약된 금액, total은 둘을 합친 금액입니다. 실제 응답에는 결제한 금액과 프로모션 지원금을 나눠 보여 주는 funding 객체도 들어 있는데, 지금은 신경 쓰지 않아도 됩니다.

다른 결과가 나왔다면:

curl을 쓰고 싶지 않다면 CLI의 spicyapi balance로 같은 확인을 할 수 있습니다.