Tokios API 키를 생성하고 관리하기

Every request to api.tokios.com authenticates with a Tokios API key sent as a Bearer token. You create keys on the Keys tab of the console; they start with sk-tok- and can be scoped to specific models. Keys are free and need no credit card.

키 생성하기

콘솔에서 Keys 탭을 엽니다.
Enter a display name (for example production-app or local-dev).
원한다면 model patterns을 설정할 수 있습니다. 이는 키가 접근할 수 있는 모델을 제한하는 용도로 사용되는데, 쉼표로 구분된 패턴 형태입니다(예: gemma*, gpt-4*). 모든 모델에 접근하도록 하려면 * 상태로 두면 됩니다.
Click Create key, then copy the key immediately — it is shown only once.

생성된 키는 만들어질 때 단 한 번만 화면에 표시됩니다. 즉시 비밀번호 관리자나 보안 저장소에 저장해두어야 합니다. 분실 시 기존 키를 취소하고 새 키를 생성해야 합니다.

최대 50개의 활성 키를 보유할 수 있습니다. 각 키 항목마다 수정, 순환, disable, delete 등의 조작 메뉴가 제공됩니다. 팀원이나 친구에게 접근 권한을 부여하되 본인이 직접 API 키를 다루고 싶지 않다면 Share Key을 사용하세요 (Keys 탭에서 Create key 옆에 위치합니다). 이 기능은 해당 사용자를 위한 새로운 전용 키를 생성한 뒤, 키를 확인할 수 있는 일회용 링크를 이메일로 전송합니다. 키 자체는 이메일에 포함되지 않으며 관리자 역시 해당 키를 확인하거나 복사할 수 없습니다. In the Share a key by email dialog:

수신자의 이메일 주소를 입력합니다

키를 받게 될 사람입니다. 이 사람에게는 키 텍스트가 아닌 일회용 확인 링크만 전송됩니다

모델 사용 범위를 설정합니다

이 공유 키가 호출할 수 있는 모델을 지정합니다. 일반적인 API 키와 동일한 패턴 기반 설정이 적용되므로 특정 배포 환경에만 사용하도록 제한할 수도 있습니다

필요 시 패스프레이즈와 만료일을 추가합니다

A passphrase (share it with the recipient separately) adds a second factor to the reveal link. Expiry sets when the key stops working — or leave it as No expiry.

사용 기록 공개 여부를 선택한 뒤 전송합니다

Leave Let them check this key’s usage enabled to let the recipient see the shared key’s usage (you can turn this off per key later). If your workspace uses request logging and you want the recipient to read the prompts sent with this key, also tick Let them read their stored prompts there too — it is off by default because anyone holding the key could then read those prompts. Then click Send invite.

공유 키는 독립적인 전용 키이므로 언제든지 직접 무효화할 수 있습니다. 이를 통해 다른 사용자에게는 영향을 주지 않으면서 해당 인원의 접근 권한만 회수할 수 있습니다. 이 방식이 바로 로컬 모델용 API 키 문서에서 설명한 개별 사용자별 키 관리 방법입니다

워크스페이스에서 요청 로그 기록 기능이 활성화되어 있다면 공유 키로 전송된 프롬프트 내용도 저장되며, 수신자의 사용 내역 페이지에 관련 안내 문구가 표시됩니다. 위에서 언급한 프롬프트 열람 옵션을 체크했거나 나중에 키 설정에서 해당 권한을 부여한 경우에만 수신자가 해당 내용을 확인할 수 있습니다. 키를 공유하기 전에 이 점을 반드시 알려주시기 바랍니다

API 키를 사용하세요

해당 키를 Bearer 토큰 형태로 전송하고, 클라이언트에 맞게 기본 URL도 설정해 주세요

OpenAI 스타일 (Codex, OpenAI SDK): https://api.tokios.com/v1
Anthropic 스타일 (Claude Code): https://api.tokios.com

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemma-tunnel", "messages": [{"role": "user", "content": "Hello"}]}'

OpenAI SDK (Python):

from openai import OpenAI

client = OpenAI(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com/v1",
)
response = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "Hello"}],
)

Anthropic SDK (Python) — Anthropic 인터페이스에서는 기본 URL에 /v1 값이 포함되지 않습니다:

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com",
)
message = client.messages.create(
    model="gemma-tunnel",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello"}],
)

API 키 보안 관리

절대로 API 키를 소스 제어 시스템에 커밋하지 마세요. 체크인되는 .env 파일이나 하드코딩된 문자열에 키가 들어가지 않도록 관리해야 합니다
환경 변수를 활용하여 런타임 시점에 키를 읽어들이세요
주기적으로 키를 교체하세요 — 새 키를 생성한 뒤 서비스에 적용하고 기존 키는 삭제하시기 바랍니다
환경마다 별도의 키를 사용하면 특정 환경의 키만 비활성화해도 다른 환경에는 영향을 주지 않습니다
모델 패턴에 따라 키의 접근 범위를 제한하면 필요한 모델에만 접근이 허용되도록 설정할 수 있습니다
어떤 정보가 저장되는지 파악하세요. 기본적으로 Tokios는 요청 및 응답 본문을 저장하지 않습니다. 요청 로깅 기능을 활성화하면 워크스페이스 관리자들은 7일 동안 워크스페이스 내 모든 키와 함께 전송된 프롬프트 내용을 확인할 수 있습니다.

API 키를 취소합니다

On the Keys tab, find the key and disable or delete it. A revoked key stops authenticating immediately — any request using it is rejected.

시작하기

모델

개념

참고

Tokios API 키를 생성하고 관리하기

키 생성하기

API 키를 사용하세요

API 키 보안 관리

API 키를 취소합니다

​키 생성하기

​이메일을 통해 키를 공유하기

​API 키를 사용하세요

​API 키 보안 관리

​API 키를 취소합니다

키 생성하기

이메일을 통해 키를 공유하기

API 키를 사용하세요

API 키 보안 관리

API 키를 취소합니다