spicyapi문서
계정 및 결제
본문

콘솔과 팀

SpicyAPI 콘솔의 페이지마다 무엇을 하고 언제 쓰는지, 그리고 비용은 팀 소유자가 내면서 팀원들이 API 키와 지출 한도를 함께 쓰는 방법을 설명합니다.

spicyapi.ai/console의 콘솔은 웹 브라우저에서 계정을 관리하는 곳입니다. 돈, API 키, 로그, 팀원, 설정을 모두 여기서 다룹니다. 내가 만든 프로그램은 콘솔을 쓰지 않고, API 키로 API를 호출합니다.

처음이라면 계정 설정부터 따라 하세요. 가입, 잔액 충전, 키 만들기를 순서대로 안내합니다. 이 페이지는 그 밖의 콘솔 기능을 모두 찾아볼 수 있는 참고 자료입니다.

프로그램에는 콘솔 로그인이 아니라 API 키를 쓰세요

콘솔에 로그인한 쿠키나 세션을 코드에 복사하지 마세요. 로그인은 만료되고, 내 브라우저에 묶여 있으며, 지출 한도도 걸 수 없습니다. 자동으로 돌아가는 것에는 무엇이든 API 키를 만들어 쓰세요. 인증을 보세요.

화면 둘러보기

모든 페이지의 맨 위에는 충전 버튼이 붙은 잔액, 모델, 문서, 알림 벨, 페이지 찾기가 있습니다. 페이지 찾기는 macOS에서 ⌘K, Windows와 Linux에서 Ctrl + K를 누른 뒤 콘솔 페이지 이름을 입력해 씁니다.

왼쪽에는 사이드바가 있습니다. 맨 위에는 지금 어느 계정이나 팀을 보고 있는지 정하는 범위 선택기가 있습니다(개인 범위와 팀 참고). 그 아래에 페이지가 다음과 같이 묶여 있습니다.

묶음페이지
(제목 없음)개요, 결제
개발API 키, 웹훅, 연동, 로그
계정팀, 설정, 알림, 데이터 보호
(맨 아래)지원

휴대폰에서는 메뉴 버튼으로 사이드바를 여세요.

콘솔 페이지 한눈에 보기

페이지주소이럴 때 씁니다
개요/console잔액, 최근 활동, 시작 체크리스트를 확인할 때
결제/console/billing잔액을 충전하고, 자동 충전을 설정하고, 잔액 내역과 사용량을 보고, 인보이스를 발행할 때
API 키/console/keys키를 만들고, 제한을 걸고, 폐기할 때
웹훅/console/webhooks콜백용 서명 키를 받고 전송 기록을 확인할 때
연동/console/integrationsSDK, CLI, MCP 서버와 그 밖의 도구 설정을 복사할 때
로그/console/logs작업을 찾아 상태, 비용, 오류, 결과를 볼 때
팀/console/team팀을 만들고, 사람을 초대하고, 팀 지출 한도를 정할 때
설정/console/settings프로필, 비밀번호, 2단계 인증, 기기, API 오류 언어, 계정 종료
알림/console/notifications잔액 부족 알림, 모델 업데이트, 받을 이메일을 정할 때
데이터 보호/console/settings/data결과·프롬프트·업로드 파일의 보관 기간을 줄이거나 내 데이터를 내려받을 때
지원/console/support지원팀과 비공개로 대화할 때

모든 주소는 https://spicyapi.ai로 시작합니다. 콘솔 주소에는 언어 접두사가 붙지 않습니다.

페이지별 기능

개요

로그인하면 가장 먼저 보이는 페이지입니다.

  • 시작하기 체크리스트: 이메일 인증, 충전하기, 첫 작업 실행하기, 그리고 API로 개발하는 방법과 코드 없이 만드는 방법으로 가는 링크가 있습니다. 모두 끝냈다면 시작 안내 숨기기로 숨기세요.
  • 사용 가능 잔액. 아직 실행 중인 작업을 위해 보류 중인 금액과 최근 7일 동안 쓴 금액이 함께 표시됩니다.
  • 최근 7일 요청 수와 최근 7일 오류 수, 그리고 사용량 보기와 로그 보기 링크.
  • 최근 사용한 모델과 최근 작업.
  • 잔액이 적거나 비었을 때 나오는 경고. 잔액이 비어 있으면 충전하기 전까지 새 작업이 거부됩니다. 이미 접수된 작업은 끝까지 실행됩니다.

결제

결제에는 개요, 사용량, 인보이스 세 탭이 있습니다.

결제 → 개요 (/console/billing)

  • 잔액 충전: 카드, 암호화폐, 또는 제공되는 경우 수동 송금으로 충전합니다. 단계별 안내, 걸리는 시간, 결제가 반영되지 않을 때 할 일은 계정 설정 → 잔액 충전하기에 있습니다.
  • 충전 주문: 모든 충전과 그 상태(대기 중, 입금 완료, 취소됨, 환불됨)를 보여 줍니다. 대기 중인 수동 송금 주문을 결제 마무리로 열면 결제 안내를 보거나 거래 참조를 제출할 수 있고, 아직 돈을 보내지 않았다면 대기 주문 취소를 누르면 됩니다.
  • 자동 충전: 카드를 저장해 두면 잔액이 줄었을 때 저희가 알아서 충전합니다. 결제가 실패하면 어떻게 되는지를 포함한 정확한 규칙은 계정 설정 → 자동 충전에 있습니다.
  • 잔액 상세: 계정에 프로모션 잔액이나 승인된 후불 한도가 있을 때만 표시됩니다. 프로모션 잔액은 묶음별로 만료일과 함께 나열됩니다.
  • 잔액 내역: 돈의 모든 움직임을 최신순으로 보여 줍니다. 종류와 기간으로 거르거나 CSV 내보내기를 누르세요. 흔히 보이는 항목은 충전, 보너스, 보류(작업이 접수될 때 따로 떼어 둔 금액), 청구(성공한 작업의 최종 가격), 보류 해제(예약해 둔 금액 중 쓰지 않고 돌아온 부분), 반환(실패나 시간 초과 뒤 돌아온 예약 금액 전액)입니다. 과금 방식은 과금을 보세요.

결제 → 사용량 (/console/billing/usage)

최근 7일, 30일, 90일, 또는 최대 92일까지 직접 지정한 기간(UTC 기준일)의 일자별 작업 수와 지출을 차트로 보여 줍니다. 그 아래 모델별에는 모델마다 작업 수, 실패, 지출, 비중이 나오고, 작업 보기를 누르면 로그에서 해당 작업들로 바로 이동합니다. CSV 내보내기는 화면에 표시된 일별 합계를 내려받습니다. API의 사용량 엔드포인트는 호출한 키 하나의 사용량만 알려 주지만, 이 페이지는 사이드바에서 선택한 범위 전체를 보여 줍니다.

결제 → 인보이스 (/console/billing/invoices)

인보이스 정보를 입력하고, 결제를 마친 충전 건의 결제 인보이스나 마감된 달의 사용 내역서를 발행하고, 월별 계정 명세서(CSV)를 만듭니다. 문서마다 무엇이 다른지, 틀린 문서를 어떻게 고치는지는 계정 설정 → 인보이스와 영수증에 있습니다.

API 키

내 프로그램이 쓰는 키를 만들고, 편집하고, 폐기합니다. 목록에는 키마다 일부를 가린 키 값, 지금까지 쓴 금액, 한도, 허용할 모델, IP 허용 목록, 만료일, 마지막 사용 시각이 나옵니다. 이름이나 가린 키 값으로 검색하고, 활성, 만료, 폐기로 거를 수 있습니다.

  • 키 만들기는 사이드바에서 선택한 범위에 키를 만듭니다. 키 전체는 한 번만 표시됩니다.
  • 편집으로 이름, 지출 한도(일·월·누적), 허용할 모델, IP 허용 목록, 만료를 바꿉니다. 편집할 때는 비어 있는 한도 칸이 한도 없음을 뜻합니다.
  • 폐기하면 키가 즉시 멈추며 되돌릴 수 없습니다. 이미 접수된 작업은 계속 실행되고 비용도 청구됩니다.

모든 항목의 설명은 계정 설정 → API 키 만들기에, 제한마다 반환되는 오류 코드는 인증에 있습니다.

팀에서는: 소유자, 관리자, 개발자 역할이어야 팀의 키를 만들고 관리할 수 있습니다. 팀 키의 사용량과 한도는 팀 기준으로 계산되고, 그 키로 보낸 작업의 비용은 팀 소유자가 냅니다.

웹훅

웹훅은 작업이 끝나면 SpicyAPI가 내 서버로 보내는 메시지입니다. 덕분에 끝났는지 계속 물어볼 필요가 없습니다. 보낼 주소는 작업마다 callBackUrl로 정합니다. 이 페이지에서는 두 가지 일을 합니다.

웹훅 서명 키. 모든 콜백에는 서명이 붙어 있어서, 내 서버가 정말 SpicyAPI에서 온 것인지 확인할 수 있습니다. 계정에는 서명 키가 하나뿐이고 계정의 모든 API 키가 이 키를 함께 쓰며, 키 값은 만들어지는 순간에 한 번만 표시됩니다. 새 계정에는 아무도 본 적 없는 키가 이미 만들어져 있으므로, 카드에 설정됨이라고 나와도 복사할 값이 없을 수 있습니다. 그럴 때는 다음과 같이 하세요.

  1. 카드에 설정 안 됨이라고 나오면 발급을, 설정됨이라고 나오면 교체를 누릅니다.
  2. 새 키를 서버 설정에 복사합니다. 보통 SPICY_WEBHOOK_SECRET이라는 이름으로 넣습니다.
  3. 저장했습니다를 누릅니다.

교체에는 유예 기간이 없습니다

교체하는 그 순간 예전 키는 서명을 멈추고 새 키가 바로 적용됩니다. 서버에 새 키를 넣기 전까지는 이전 전송의 재시도까지 포함해 콜백을 단 하나도 검증할 수 없습니다. 요청이 적은 시간에 교체하고 곧바로 서버를 업데이트하세요. 그사이 놓친 결과는 recordInfo로 가져올 수 있습니다. 웹훅을 보세요.

웹훅 전송 기록. 계정의 모든 콜백 시도를 최신순으로 보여 주며, 전송 완료, 재시도 중, 실패로 거를 수 있고 시도 횟수와 다음 재시도 시각도 나옵니다. 다시 전송은 서명된 원래 메시지를 한 번 더 보냅니다. 내 서버가 같은 메시지를 두 번 받아도 문제가 없는지 확인하세요. 보관 기간 설정 때문에 저장된 내용이 이미 지워진 전송은 다시 보낼 수 없습니다.

연동

SpicyAPI와 함께 쓰는 도구의 설정을 복사해 붙여 넣을 수 있게 모아 둔 페이지입니다. 도구를 고르면 설정 방법과 문서 열기가 나옵니다.

  • 연결 기본 사항: OpenAI 호환 클라이언트용 베이스 URL과 키 만들기 바로 가기. 키 이름은 그 키를 쓸 도구 이름으로 지으세요.
  • 공식 도구: TypeScript SDK, CLI, MCP 서버, Agent Skill.
  • OpenAI 호환 클라이언트: 베이스 URL을 바꿀 수 있는 도구로, 텍스트 모델과 영상 모델에 씁니다. 이미지 생성은 호환 엔드포인트에서 제공하지 않습니다.
  • 코딩 에이전트: MCP 서버를 추가해 쓰는 편집기와 에이전트. MCP 서버는 과금될 때마다 확인을 요청합니다.

코드 조각에는 자리표시자 MODEL_ID_FROM_CATALOG가 들어 있습니다. 실시간 카탈로그(GET /api/v1/models, spicyapi models list, listModels())에서 가져온 정확한 모델 ID로 바꾸세요. 모델 카탈로그와 스키마를 보세요.

로그

실패한 것을 포함해 모든 작업을 최신순으로 보여 줍니다. 행마다 작업, 모델, 상태, 소요 시간, 비용이 나옵니다.

  • 필터: 상태, 모델, 기간으로 거릅니다. 검색창에는 정확한 작업 ID나 요청 ID를 넣습니다. 오류 보고에 해당하는 작업을 찾는 가장 빠른 방법입니다. 페이지에는 최대 500행까지 불러오므로, 그보다 많이 보려면 필터를 좁히세요.
  • CSV 내보내기는 필터에 맞는 작업을 모두 내보냅니다. 기본 기간은 최근 30일이고, 최대 92일 또는 10,000행까지입니다.
  • 작업에서 세부 정보 열기를 누르면 상태, 비용, 시작·완료 시각, 사용한 키, 작업 ID와 요청 ID, 오류 코드와 실패 원인, 요청 파라미터, 응답, 다운로드 링크가 나옵니다. 다운로드 링크는 링크 받기로 받으며, 링크마다 만료되지만 언제든 새로 받을 수 있습니다.

비용 칸에는 실행 중인 작업의 예약 금액과 정산 후 실제 청구액이 표시됩니다. 모델 페이지에 명시된 콘텐츠 거부는 실패한 작업에도 요금이 부과될 수 있습니다. 상태만으로 환불을 판단하지 말고 정산 결과를 확인하세요.

작업 상세에는 세 가지 동작이 있습니다.

동작하는 일돈
새 작업으로 다시 시도같은 입력을 새 작업으로 다시 실행합니다. 실패했거나, 시간이 초과됐거나, 취소된 작업에만 쓸 수 있고, 그 입력이 아직 보관되어 있는 동안에만 가능합니다새로 과금됩니다. 원래 기록은 그대로 남습니다
결과 폐기작업이 만든 이미지·영상·텍스트, 저장된 결과, 내가 보낸 프롬프트를 삭제합니다. 되돌릴 수 없습니다바뀌는 것이 없습니다. 비용, 모델, 상태, 타임스탬프, 요청 ID는 기록에 남습니다
기록에서 삭제작업의 요청과 결과를 지우고, 미디어 삭제를 예약하고, 로그에서 그 행을 숨깁니다. 작업이 끝나고 정산된 뒤에 쓸 수 있습니다바뀌는 것이 없습니다. 과금 기록은 남습니다

이 중 어느 것도 실행 중인 작업을 취소하지 않습니다. 접수된 작업은 취소할 수 없습니다. 삭제할 때 무엇이 남고 무엇이 지워지는지는 보관과 파기를 보세요.

팀에서는: 모든 멤버가 팀의 작업과 그 상태, 비용을 볼 수 있습니다. 프롬프트, 결과, 다운로드 링크는 소유자, 관리자, 개발자만 봅니다. 위의 세 가지 동작은 그 작업의 비용을 낸 계정만 쓸 수 있습니다.

팀

팀을 만들고, 사람을 초대하고, 역할을 바꾸고, 팀 지출 한도를 정하고, 팀에서 나가거나 팀을 넘깁니다. 혼자 쓰시나요? 그렇다면 팀은 필요 없습니다. 키, 잔액, 사용량은 팀 없이도 이미 잘 작동합니다. 팀에 관한 모든 내용은 아래 팀에 있습니다.

설정

한 페이지 안에 여러 묶음으로 나뉘어 있습니다.

계정

  • 이메일. 인증됨 또는 미인증으로 표시됩니다. 로그인 이메일은 로그인 이메일 변경으로 바꿉니다. 새 주소로 확인 링크(20분 동안 유효)를 보내고, 예전 주소로는 알림을 보냅니다. 현재 비밀번호가 필요합니다.
  • 표시 이름, 계정 ID(지원팀에 문의할 때 알려 주세요), 가입일.

보안

  • 비밀번호. 비밀번호를 바꾸면 모든 기기에서 로그아웃됩니다. Google이나 GitHub로 만든 계정은 설정 링크 보내기를 눌러 비밀번호를 정하기 전까지 비밀번호가 없습니다. 계정을 종료하거나 팀을 넘기려면 비밀번호가 필요합니다.
  • 로그인된 기기. 모르는 기기는 로그아웃하고, 다른 누군가가 내 계정에 접근한 것 같다면 모든 기기에서 로그아웃(지금 쓰는 기기 포함)을 누르세요. 그 직후 비밀번호를 바꾸세요.
  • 2단계 인증. 2단계 인증 설정을 누르고, 현재 비밀번호를 입력하고, 인증 앱에 계정을 추가한 뒤 앱에 나오는 6자리 코드를 입력합니다. 그 뒤로는 로그인할 때마다 코드를 묻습니다. 이때 한 번씩만 쓸 수 있는 복구 코드 10개도 받습니다. 휴대폰이 없으면 이 코드가 계정에 다시 들어갈 유일한 방법이고 다시 보여 드릴 수도 없으므로, 휴대폰이 아닌 다른 곳에 보관하세요. 새 복구 코드는 기존 코드를 모두 새것으로 바꾸고, 2단계 인증 끄기는 2단계 인증을 해제합니다. 둘 다 먼저 본인 확인을 요청합니다.
  • 보안 활동: 최근 로그인, 새 기기, 인증 정보 변경 내역.

환경설정

  • API 오류 언어: 내 API 키로 보낸 요청에 대해 오류 응답의 msg와 작업의 errorMessage(상태 조회와 웹훅에 들어 있는 값)를 어떤 언어로 받을지 정합니다. 기본값은 영어입니다. 요청 자체에 Accept-Language 헤더가 있으면 그쪽이 우선하며, 코드에서 분기해야 할 값(code, errorCode)은 절대 바뀌지 않습니다. 오류를 보세요.

청구 및 데이터

  • 청구 정보 및 명세서(결제 → 인보이스에 있음)와 데이터와 개인정보(데이터 보호 페이지)로 가는 바로 가기.

위험 구역: 계정 종료

계정을 종료하면 모든 기기에서 로그아웃되고, 모든 API 키가 영구히 폐기되며, 생성된 미디어와 보관 중인 작업 내용이 삭제됩니다. 과금, 감사, 대사 기록은 개인정보처리방침에 적힌 대로 보관됩니다. 결제하지 않고 방치한 충전 주문은 자동으로 취소됩니다. 종료는 다음 경우에만 보류됩니다.

  • 대기 중이거나 실행 중인 작업이 있거나, 끝난 작업이 아직 정산되지 않았습니다(보통 1분 안에 끝납니다).
  • 충전 결제가 아직 처리 중입니다(결제 대행사가 확인하거나 해제하면 저절로 사라지며, 보통 몇 분 걸립니다. 1시간이 지나도 남아 있으면 고객 지원에 문의하세요).
  • 계정에 갚아야 할 금액이 있습니다(사용 중인 승인된 크레딧 또는 마이너스 잔액). 충전해서 해소하세요.
  • 내가 소유한 팀을 다른 멤버에게 넘기거나, 나 말고 다른 멤버가 남지 않도록 비워야 합니다.

아직 걸리는 것이 있으면 콘솔이 목록으로 보여 줍니다. 현재 비밀번호를 입력해 확정합니다. Google 등 외부 로그인으로 가입해 비밀번호가 없다면, 이메일로 받은 6자리 인증 코드(15분간 유효)를 입력해 확정합니다.

계정을 종료하면 잔액을 잃습니다

계정에 남은 잔액은 소멸합니다. 환불되거나 현금으로 지급되지 않으며, 콘솔이 이 점에 동의하는지 명시적으로 확인합니다. 아깝다면 먼저 다 쓰세요. 환불 정책을 보세요.

알림

  • 잔액 부족 알림. 켜고 기준 금액($5, $10, $25, $50, $100 중 하나)을 고르세요. 사용 가능 잔액이 그 아래로 내려가면 알림 벨에 알림이 한 번 오고, 계정에 이메일 주소가 있으면 이메일도 옵니다. 알림을 다시 받는 것은 잔액이 기준 금액 이상으로 회복됐다가 다시 그 아래로 내려갔을 때뿐입니다. 잔액은 약 10분마다 확인합니다.
  • 팔로우한 모델의 업데이트. spicyapi.ai의 모델 페이지에서 모델을 팔로우하세요. 관리를 누르면 팔로우한 모델 목록과 제품 업데이트가 열립니다.
  • 전달 방식. 앱 안의 알림은 항상 켜져 있습니다. 제품 업데이트와 프로모션과 공지 이메일은 켜거나 끌 수 있습니다. 보안, 결제, 서비스 운영에 꼭 필요한 안내는 항상 보내 드립니다.

데이터 보호

  • 보관 기간: 생성 결과, 프롬프트, 업로드 파일에 각각 따로 적용되는 세 가지 기간입니다. 플랫폼 최대치(결과 14일, 프롬프트 텍스트 30일, 업로드 파일 24시간)보다 짧게만 정할 수 있습니다. 기간을 줄이면 이미 실행한 작업의 내용도 다음 정리 때 삭제될 수 있으며, 정리는 1분 안에 실행됩니다. 확정하기 전에 콘솔이 영향받는 항목 수를 세어 보여 주며, 삭제된 내용은 복구할 수 없습니다. 남겨 두고 싶은 것은 먼저 내려받으세요.
  • 작업 콘텐츠 보관: 설정 두 가지가 들어 있는 예전 카드입니다. 그중 작업 콘텐츠 보관 항목은 작업 내용을 며칠 동안 보관하는지 일 단위로 보여 줄 뿐이며, 기간은 위의 세 가지 기간으로 정합니다. 완료 후 곧 콘텐츠 삭제를 켜면 끝난 작업의 결과가 저장되고 웹훅이 전달된 뒤 약 1시간이 지나서 그 작업의 내용을 지웁니다.
  • 데이터가 가는 곳: 개인정보처리방침에서 이미 약속한 내용을 요약한 것입니다. 내 입력과 결과물을 모델 학습에 쓰지 않는다는 점도 들어 있습니다.
  • 내 데이터 다운로드: 프로필, 팀 역할, API 키 정보(키 값 자체는 절대 들어 있지 않음), 보관 중인 작업 데이터, 과금 기록이 담긴 JSON 파일입니다. 미디어 파일은 포함되지 않으므로 결과물은 따로 내려받으세요.

요청마다 보관 기간을 따로 정하는 방법과 삭제한 뒤에도 남는 것을 포함한 전체 규칙은 보관과 파기에 있습니다.

지원

나와 SpicyAPI 지원팀만 읽을 수 있는 비공개 대화를 엽니다. 새 문의를 누르고, 제목과 문의 유형(계정, 결제와 충전, API 연동, 작업 또는 결과, 개인정보, 기업 도입, 기타)을 고른 뒤 무슨 일이 있었는지 적으세요. 답변은 대화 안과 알림 벨에 나타납니다. 대화의 상태는 지원 답변 대기, 고객 답변 대기, 해결됨, 종료됨 중 하나로 표시됩니다.

빨리 도와드릴 수 있도록 작업 ID, 오류 응답의 request_id, 또는 충전 주문 ID와 함께 대략 언제 일어난 일인지(UTC)를 적어 주세요. API 키, 비밀번호, 카드 정보는 절대 붙여 넣지 마세요. support@spicyapi.ai로 이메일을 보내도 됩니다.

팀

개인 범위와 팀

모든 계정에는 개인 범위가 있습니다. 나 말고는 아무도 없는 범위로, 혼자 쓴다면 이것만으로 충분합니다. 개인 키, 잔액, 사용량은 팀 없이도 작동합니다.

팀을 만들면 동료들이 API 키를 함께 쓰고, 같은 작업 기록을 보고, 공유된 지출 한도 안에서 일할 수 있습니다. 팀마다 멤버, 키, 한도가 따로 있습니다.

사이드바 맨 위의 범위 선택기가 콘솔에 무엇을 보여 줄지 정합니다.

  • 개인: 내 개인 범위만 보여 줍니다.
  • 팀 이름: 그 팀의 키, 작업, 사용량, 활동만 보여 줍니다.
  • 전체 범위: 내가 접근할 수 있는 모든 것을 합쳐서 보여 줍니다.
  • 새 팀: 팀을 만드는 바로 가기입니다.

범위 선택기는 새 API 키가 어디에 속할지도 정합니다. 팀을 선택한 상태에서 만든 키는 그 팀에 속합니다.

팀 비용은 누가 내나요

팀의 API 키로 보낸 작업의 비용은 모두 팀 소유자의 잔액에서 나갑니다. 팀에 관한 규칙 가운데 가장 중요한 한 가지입니다.

  • 멤버는 팀을 위해 충전하지 않으며, 소유자의 잔액, 충전 내역, 결제 정보, 인보이스를 볼 수 없습니다.
  • 내가 멤버인데 팀 키가 40201을 반환하기 시작했다면 소유자가 잔액을 충전해야 합니다.
  • 내 개인 키, 잔액, 사용량은 참여한 팀과 절대 공유되지 않으며, 팀에서 나가도 아무 영향이 없습니다.
  • 소유자, 관리자, 개발자는 소유자의 잔액을 쓰는 팀 키를 만들 수 있습니다. 소유자라면 팀 지출 한도를 정하고 키마다 한도를 따로 거세요.

팀 만들기

  1. 팀을 열고 팀 만들기를 누릅니다(범위 선택기의 새 팀을 눌러도 됩니다).
  2. 팀 이름(최대 120자)을 입력하고 만들기를 누릅니다.

만든 사람이 팀의 소유자가 됩니다. 계정 하나가 소유할 수 있는 워크스페이스는 최대 10개이고 개인 범위도 그중 하나로 세므로, 팀은 최대 9개까지 만들 수 있습니다. 다른 사람의 팀에 참여하는 수에는 제한이 없습니다.

사람 초대하기

소유자나 관리자만 초대할 수 있습니다.

초대 보내기

팀을 열고 동료 초대하기를 누릅니다. 초대 이메일에 동료의 이메일을 입력하고, 역할을 고른 뒤 초대 보내기를 누르세요. 역할의 자세한 설명은 역할과 권한에 있고, 화면의 역할별로 무엇을 할 수 있나요? 항목을 펼치면 요약을 볼 수 있습니다.

이렇게 보여야 합니다: 목록에 초대가 대기 중으로 나타나고, 초대 발송됨 또는 초대 발송 실패와 함께 만료일이 표시됩니다. 콘솔에는 일회용 초대 토큰도 표시됩니다.

이 단계에서 일어난 일: 그 주소로 초대 링크를 이메일로 보냈습니다. 초대는 7일 동안 유효합니다.

이메일이 나가지 않았다면

목록에 초대 발송 실패라고 나오거나 이메일이 끝내 도착하지 않으면, 일회용 토큰을 믿을 수 있는 비공개 채널로 직접 전달하세요. 토큰은 한 번만 표시됩니다. 다시 보내기를 누르면 새 이메일이 나가고 새 토큰을 받습니다. 다시 보내면 예전 링크와 토큰은 무효가 되고, 7일의 유효 기간이 새로 시작됩니다.

동료가 수락하기

동료는 이메일의 링크를 열고, 초대를 받은 바로 그 이메일 주소로 로그인하거나 먼저 계정을 만든 다음 초대 수락을 누릅니다. 다른 방법도 있습니다. 대기 중인 초대는 동료의 팀 페이지의 나에게 온 초대에 팀 참여 버튼과 함께 나타나고, 초대 토큰이 있나요? 아래에 토큰을 붙여 넣을 수도 있습니다.

동료에게 이렇게 보여야 합니다: 참여 완료가 표시되고, 동료의 범위 선택기에 팀이 나타납니다.

초대 규칙:

  • 초대는 초대받은 주소와 이메일이 같은 계정만 수락할 수 있습니다. 이메일이 다르면 Please sign in with the invited email address to accept this invite가 표시됩니다.
  • 비공개(직접 관리) 계정은 팀에 참여할 수 없습니다. 이메일 주소가 없기 때문입니다.
  • 한 팀 안에서 이메일 하나에 대기 중인 초대는 하나만 있을 수 있습니다. 이미 멤버인 사람은 다시 초대할 수 없습니다.
  • 한 팀에는 소유자를 포함해 멤버가 최대 100명까지 있을 수 있습니다.
  • 취소를 누르면 대기 중인 초대를 언제든 취소할 수 있고, 나중에 같은 사람을 다시 초대해도 됩니다.
  • 만료된 초대는 수락할 수 없습니다. 새로 보내세요.

역할과 권한

콘솔에는 역할이 아래 이름으로 표시됩니다. API와 내보낸 파일에는 괄호 안의 소문자 이름이 쓰입니다.

멤버가 할 수 있는 일소유자 (owner)관리자 (admin)개발자 (developer)예산 관리자 (billing)읽기 전용 (readonly)
팀의 작업, 상태, 비용, 사용량 보기예예예예예
프롬프트와 결과 읽기, 다운로드 링크 받기예예예아니요아니요
팀 활동(팀 작업에서 생긴 돈의 움직임) 보기예예아니요예아니요
팀 API 키 만들기, 편집, 폐기예예예아니요아니요
생성에서 에셋 사용(팀 라이브러리)예예예예예
팀 에셋 라이브러리에 저장예예예아니요아니요
팀 에셋 이름 변경·삭제예예본인이 저장한 에셋만아니요아니요
팀 지출 한도 변경예예아니요예아니요
사람 초대, 초대 다시 보내기·취소예예. 단, 관리자는 초대할 수 없음아니요아니요아니요
역할 변경, 멤버 제거예예. 단, 다른 관리자는 대상이 아니며 누구도 관리자로 만들 수 없음아니요아니요아니요
팀 이름 바꾸기예예아니요아니요아니요
소유권 이전예아니요아니요아니요아니요
팀에서 나가기아니요. 먼저 이전해야 함예예예예

그 밖에:

  • 누구도 자기 역할을 직접 바꿀 수 없습니다. 소유자의 역할은 소유권 이전을 통해서만 바뀝니다.
  • 작업 재시도, 결과 폐기, 기록에서 삭제는 역할과 관계없이 그 작업의 비용을 낸 계정만 할 수 있습니다.
  • 내용을 읽을 수 없는 역할의 멤버에게는 다음 문구가 표시됩니다: 지금 역할로는 작업 상태와 사용량까지만 볼 수 있고, 프롬프트나 결과는 열어 볼 수 없습니다.
  • 소유자 개인의 잔액, 충전 내역, 결제 정보, 인보이스는 소유자 말고는 누구도 볼 수 없습니다. 팀 활동에는 팀의 작업으로 생긴 돈의 움직임만 나옵니다.

팀 지출 한도

모든 팀(그리고 개인 범위)에는 미국 달러 기준의 일 한도와 월 한도가 있으며, 팀 → 내 팀 → 지출 한도에서 확인합니다. 소유자, 관리자, 예산 관리자는 편집을 누른 뒤 값을 바꾸고 한도 저장을 눌러 변경할 수 있습니다.

  • 한도는 그 범위의 키로 보낸 모든 작업을 합쳐서 적용됩니다.
  • 이미 청구된 금액과, 아직 실행 중인 작업을 위해 보류 중인 금액이 모두 포함됩니다.
  • 일 한도는 UTC 00:00에, 월 한도는 매월 1일 UTC 00:00에 다시 시작됩니다.
  • 기본값은 제한 없음입니다. 0을 입력하면 한도가 없습니다. 칸을 비워 두면 현재 값이 그대로 유지됩니다.
  • 한도를 넘게 될 작업은 40202와 함께 Workspace daily budget has been reached 또는 Workspace monthly budget has been reached 메시지로 거부됩니다. 아무것도 만들어지지 않고, 보류되는 금액도 없습니다.

팀 한도는 키마다 걸린 일·월·누적 한도와 소유자의 잔액에 더해서 적용됩니다. 그중 무엇이든 가장 먼저 바닥나는 쪽이 작업을 막습니다. 모든 지출 한도는 과금을 보세요.

역할 변경과 멤버 제거

팀을 여세요. 멤버에서 멤버의 새 역할을 고르고 역할 변경으로 확인하면 바로 적용됩니다. 제거를 누르면 멤버가 즉시 팀에서 빠지고, 팀과 팀의 키, 활동에 더 이상 접근할 수 없게 됩니다. 소유자는 제거할 수 없습니다.

멤버를 제거해도 그 사람이 만들었거나 쓰던 키는 폐기되지 않습니다. 팀 키는 팀에 속하므로, 그 사람이 아직 가지고 있는 키는 API 키에서 폐기하세요.

팀에서 나가기

소유자를 뺀 모든 멤버는 팀에서 나갈 수 있습니다. 팀을 열고 팀에서 나가기를 누른 뒤 확인하세요. 접근 권한은 즉시 사라지며, 새 초대를 받아야만 다시 들어올 수 있습니다.

지워지는 것은 없습니다. 팀의 키, 작업, 사용량은 팀에 그대로 남고, 비용도 계속 팀 소유자에게 청구됩니다. 팀의 키를 아직 가지고 있다면 관리자에게 폐기해 달라고 요청하세요. 내 개인 범위에는 아무 영향이 없습니다.

소유자는 그냥 나갈 수 없습니다. 그렇게 되면 관리할 사람이 없는 팀 키가 소유자의 돈을 계속 쓰게 되기 때문입니다. 먼저 소유권을 이전하세요. 혼자뿐인 팀이라면 누군가를 초대해 그 사람에게 팀을 넘기세요.

소유권 이전

소유자만 이전할 수 있고, 이미 멤버인 사람에게만 넘길 수 있습니다.

  1. 팀을 열고 위험 구역 → 소유권 이전으로 갑니다.
  2. 새 소유자를 고르고 현재 비밀번호를 입력합니다. (Google이나 GitHub로 만든 계정은 먼저 설정에서 비밀번호를 정해야 합니다.)
  3. 내용을 확인하고 팀 이전을 누릅니다.

그 순간부터 다음이 적용됩니다.

  • 팀의 키로 보내는 모든 작업의 비용을 새 소유자의 잔액이 내며, 모든 팀 키가 새 소유자의 계정으로 옮겨집니다.
  • 나는 관리자가 됩니다.
  • 이전하기 전에 접수된 작업은 원래의 과금 계정을 유지하며, 취소되지 않습니다.

팀 삭제

팀은 삭제할 수 없습니다. 쓰지 않는 팀에는 비용이 들지 않으며 청구서에 나타나지도 않습니다. 멤버를 제거하고 그대로 두거나, 새 팀을 만드는 대신 이름을 바꿔 다시 쓰세요.

팀 한도 한눈에 보기

항목값
계정 하나가 소유할 수 있는 워크스페이스10개(개인 범위 포함)
팀당 멤버 수100명(소유자 포함)
초대 유효 기간7일. 다시 보내면 7일이 새로 시작됩니다
범위당 활성 API 키50개
팀 이름1~120자

이 페이지에서