AI 키 입력 설명서

프로젝트K 포토카드에 쓸 구글 AI 키를 만들어 넣는 방법입니다.
그림의 빨간 번호 순서대로 누르시면 됩니다. 약 10분 걸립니다.

준비물
  1. 구글 계정 (기관 공용 계정을 권장합니다)
  2. 해외 결제가 되는 카드
  3. 관리 비밀번호 (담당자에게 따로 받으세요)

1키 만들기

컴퓨터에서 aistudio.google.com/apikey 에 들어가 구글 계정으로 로그인합니다.
오른쪽 위 Create API key를 누릅니다.

Create API key 단추

이름 칸에 아무 이름(예: 프로젝트K 포토카드)을 적고 Create key를 누릅니다.

키 만들기 창

처음 들어가면 약관 동의 화면이 먼저 나올 수 있습니다. 동의하고 넘어가세요.

2결제 연결하기

목록에 방금 만든 키가 생깁니다. 그 줄의 Set up billing을 누릅니다.
(아래 작게 Free tier라고 써 있으면 아직 결제가 안 된 키입니다.)

Set up billing

결제 계정 창이 뜹니다. 처음이면 Add new billing account를 눌러 국가(대한민국)·카드를
등록합니다. 이미 결제 계정이 있으면 고르고 Continue를 누릅니다.

결제 계정 창

3충전하기

왼쪽 메뉴 Billing → Buy credits를 누릅니다. 잔액이 0원이면 포토카드가 만들어지지
않으니 꼭 충전해 주세요.

Billing 화면

충전할 금액을 원 단위로 적고 Make a payment를 누릅니다.

충전 금액 입력

위 그림 ③ Set up auto reload(자동 충전)를 켜 두면 잔액이 떨어질 때 알아서 충전돼
행사 중에 멈추지 않습니다.

4키 복사하기

왼쪽 메뉴 API Keys로 돌아갑니다. 내 키 줄에 Tier 1이라고 보이면 결제까지 끝난 것입니다.
그 줄의 복사 아이콘을 누릅니다.

Tier 1 확인과 복사 아이콘

키는 카톡·메일·메모장에 옮겨 적지 말고, 복사한 그대로 바로 5단계에 붙여 넣어 주세요.

5키 입력 페이지에 넣기

kdebut-app.pages.dev/admin 에 들어갑니다
(컴퓨터·휴대폰 모두 됩니다). 관리 비밀번호를
넣고 확인을 누릅니다.

관리 비밀번호 입력

새 키 넣기 칸에 붙여 넣고(Ctrl+V, 휴대폰은
길게 눌러 붙여넣기) 저장하고 확인하기를
누릅니다. 10~30초 뒤 결과가 나옵니다.

새 키 넣기

결과 보기

초록
초록색이면 끝입니다.
지금부터 모든 포토카드가 새 키로 만들어집니다.
주황
주황색 = 키는 저장됐지만 결제가 아직입니다.
2·3단계(결제 연결·충전)를 마치고 10분쯤 뒤 키
입력 페이지의 지금 상태 확인하기를 누르세요.
빨강
빨간색 = 키가 틀려 저장하지 않았습니다.
4단계 복사 아이콘으로 다시 복사해 붙여 넣으세요.
쓰던 키는 그대로라 포토카드는 멈추지 않습니다.

충전했는데 계속 주황색이에요

① 구글 쪽 반영에 10~30분 걸릴 수 있으니 잠시 뒤 다시 확인하세요. ② API Keys 목록에서 넣은
키가 Tier 1인지 보세요. Free tier면 결제가 다른 프로젝트에 연결된 것이니, Tier 1으로 보이는
키를 복사해 다시 넣으세요. ③ Billing 화면의 잔액(Credit balance)이 0원보다 큰지 보세요.

비밀번호를 여러 번 틀려서 잠겼어요

8번 틀리면 15분 동안 잠깁니다. 15분 뒤 다시 하세요.

키가 밖으로 새어 나간 것 같아요

새 키를 하나 더 만들어(1단계) 키 입력 페이지에 먼저 넣은 뒤, API Keys 목록에서 옛 키 줄 끝의 ⋮
메뉴로 옛 키를 지우세요. 이 순서로 하면 포토카드가 멈추지 않습니다.