동영상 튜토리얼
동영상은 영어입니다(내레이션 및 자막).
API 키는 ImageToTable.ai 계정의 자격 증명입니다. 외부 도구가 여러분의 계정으로 작동할 수 있게 해줍니다: Google Sheets 애드온은 로그인 대신 이 키로 연결할 수 있고, v1 API는 모든 호출에서 이 키를 사용합니다. 이 페이지에서는 키의 위치, 교체 방법, 그리고 교체 후 업데이트해야 할 사항을 다룹니다.
API 키 찾는 방법
키는 프로필 페이지의 API 키 섹션에 있습니다. 이동하려면 앱 오른쪽 상단의 계정 메뉴(아바타와 사용자 이름이 표시된 메뉴)를 열고 프로필을 선택하세요.
해당 섹션에는 키와 관련된 모든 정보가 표시됩니다:
- 키 자체는 기본적으로 점으로 숨겨져 있습니다. 눈 모양 버튼으로 표시하고, 복사 버튼으로 복사할 수 있습니다.
- 키가 이미 있으면 API 키 재생성 버튼이 표시되고, 아직 없으면 API 키 생성 버튼이 표시됩니다(이 경우 섹션에 아직 API 키가 없음이라고 표시됩니다).
- 키가 외부 도구용이며 비밀로 유지해야 한다는 짧은 안내와 API 문서 링크가 표시됩니다.
키를 비밀번호처럼 취급하세요. 키는 특정 도구가 아닌 계정에 속하므로, 키가 허용되는 모든 곳에서 동일한 값이 작동합니다. 그리고 키를 가진 사람은 누구나 여러분의 계정으로 작동할 수 있습니다. 이것이 섹션에서 키를 비밀로 유지하라고 안내하는 이유입니다.
API 키 재생성
계정에는 API 키가 하나만 저장됩니다. 재생성은 두 번째 키를 추가하는 것이 아니라 기존 값을 교체하므로, 활성화된 키는 항상 하나뿐입니다. 확인 단계는 계정의 로그인 방식에 따라 달라집니다. Google 로그인으로 만든 계정에는 여기에 입력할 비밀번호가 없기 때문입니다.
비밀번호로 로그인하는 계정인 경우
API 키 재생성을 선택하면 비밀번호 입력 창이 열립니다. 키가 이미 존재하는 경우, 비밀번호를 묻기 전에 현재 키가 무효화된다는 안내가 표시됩니다. 아직 키가 없는 경우에는 키를 생성하기 위해 비밀번호를 입력하라는 메시지가 표시됩니다. 계정 비밀번호를 입력하고 확인하면 완료됩니다.
비밀번호가 일치하지 않으면 아무것도 변경되지 않으며, 페이지에 비밀번호가 올바르지 않다는 메시지가 표시됩니다.
Google 로그인에 연결된 계정인 경우
Google로 로그인하는 계정의 경우, 확인은 비밀번호 대신 Google 로그인 단계로 진행됩니다. API 키 재생성을 선택하면 본인 확인이라는 제목의 대화 상자가 열리며, Google을 통해 확인하도록 요청합니다. 계정에 이미 키가 있는 경우, 대화 상자에 현재 키가 먼저 무효화된다는 안내가 표시됩니다.
위의 비밀번호 입력 창을 사용할 수 없는 경우 이 경로를 사용하면 됩니다. Google 로그인으로 만든 계정이 여기에 해당합니다.
재생성 후: 키를 사용하는 곳을 업데이트하세요
새 키 생성은 즉시 적용됩니다. 이전 값은 그 순간부터 작동이 중지됩니다. 유예 기간이 없으며 두 키를 모두 활성 상태로 유지할 방법도 없습니다. 이전 키를 계속 보내는 모든 요청은 새 키로 교체될 때까지 거부됩니다.
| 키가 사용되는 곳 | 재생성 후 해야 할 작업 |
|---|---|
| Google Sheets 애드온 | 사이드바에서 계정 섹션을 열고 API 키 붙여넣기 상자에 새 키를 붙여넣습니다. 애드온이 Google로 로그인으로 연결된 경우 키를 전혀 사용하지 않으므로 변경할 필요가 없습니다. |
| v1 API | 애플리케이션에 키가 저장된 모든 곳에서 기존 키를 새 키로 교체하세요. 이전 키로 만든 호출은 더 이상 인증되지 않으므로, 다음 실행 전에 키를 업데이트하세요. |
재생성은 키만 변경합니다. 파일, 템플릿, 크레딧, 및 플랜은 변경되지 않으며, 새 키는 기존 키와 동일한 액세스 권한을 갖습니다.
자주 묻는 질문
키를 분실했습니다. 다시 조회할 수 있나요?
네, 로그인만 가능하면 됩니다. 프로필 페이지에 현재 키가 항상 표시되며, 눈 모양 버튼을 누르기 전까지는 점으로 숨겨져 있습니다. 거기서 복사할 수 있습니다. 재사용하는 대신 교체하려면 API 키 재생성을 사용하세요.
한 번에 여러 개의 키를 가질 수 있나요?
아니요. 계정에는 API 키가 하나만 저장됩니다. 재생성하면 기존 키가 교체되므로, 새 키가 생성되는 즉시 이전 키는 더 이상 작동하지 않습니다.
Google Sheets 애드온은 항상 키가 필요한가요?
아니요. 애드온은 Google 로그인 또는 API 키 붙여넣기 중 하나로 연결할 수 있습니다. Google 로그인으로 연결하면 사이드바에서 키를 사용하지 않으며, 키를 재생성해도 해당 연결에는 영향을 미치지 않습니다. 키 자체를 사용하는 곳만 업데이트하면 됩니다. Google Sheets 애드온을 참조하세요.
v1 API도 이 키를 사용하나요?
네. 모든 v1 API 호출은 키로 인증되므로, 재생성 후에는 이전 키를 교체해야 합니다. API 액세스에서 API의 대상과 요구 사항을 확인할 수 있으며, 전체 참조는 개발자 문서 사이트에 있습니다.