Tokios API 키 생성 및 관리

​

키 생성하기

1. 콘솔에서 Keys 탭을 엽니다.
2. 키의 display name을 입력합니다(예: production-app 또는 local-dev).
3. 선택 사항으로 model patterns을 설정합니다. 키가 접근할 수 있는 모델을 제한하는 쉼표로 구분된 글롭입니다(예: gemma*, gpt-4*). 모든 모델을 허용하려면 *로 두세요.
4. 마지막으로 Create key를 클릭한 후 copy the key immediately — 키는 한 번만 표시됩니다.

​

이메일로 키 공유하기

​

키 사용하기

• 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"}]}'

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"}],
)

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"}],
)

​

키 보안

• 키를 소스 코드 관리에 커밋하지 마세요. 체크인되는 .env 파일과 하드코딩된 문자열에서 키를 보호하세요.
• 환경 변수를 사용하고 런타임에 읽으세요.
• 정기적으로 교체하세요. 대체 키를 생성하고 서비스를 업데이트한 후 이전 키를 제거합니다.
• 환경별로 별도의 키를 사용하면 다른 환경에 영향을 주지 않으면서 하나만 해지할 수 있습니다.
• 모델 패턴으로 범위 지정하여 키가 필요한 모델에만 접근할 수 있도록 하세요.
• 저장되는 내용을 파악하세요. 기본적으로 Tokios는 요청 또는 응답 본문을 보관하지 않습니다. request logging을 켜면, 워크스페이스 관리자가 7일 동안 워크스페이스의 모든 키로 전송된 프롬프트를 읽을 수 있습니다.
• 키를 관리하는 스크립트에는 자동화 토큰을 사용하세요. 키는 모델을 호출하는 용도이며, 다른 키를 생성하거나 교체하거나 해지할 수 없습니다. 해당 작업이 필요한 프로그램은 범위 지정 및 만료 가능한 automation token을 사용합니다.

​

키 해지