인증
Webway API 키를 안전하게 생성, 전송, 교체, 폐기하세요.
API 키에서 키를 생성하세요. 키는 sk-ww-로 시작하고 조직에 속하므로,
팀 구성원이 바뀌어도 계속 유효합니다.
헤더
프로토콜에서 요구하는 헤더를 사용하세요:
| 프로토콜 | 인증 |
|---|---|
| Chat completions, Responses, Images | Authorization: Bearer sk-ww-… |
| Claude Messages | x-api-key: sk-ww-… |
| Gemini 네이티브 클라이언트 | x-goog-api-key: sk-ww-… |
Claude Messages 요청에는 anthropic-version: 2023-06-01도 함께 보내야 합니다.
키를 안전하게 보관하기
원본 키는 한 번만 표시됩니다. Webway는 키의 SHA-256 해시를 저장하므로 잃어버린 키는 복구할 수 없습니다.
- 키는 환경 변수나 시크릿 매니저에 보관하세요.
- 키를 커밋하거나 브라우저 또는 모바일 코드에 담아 배포하지 마세요.
- 환경이나 서비스마다 별도의 키를 사용하면 사용량의 출처를 파악하기 쉽습니다.
키가 유출되면 즉시 폐기하세요. 폐기는 다음 요청부터 적용됩니다.
다운타임 없이 키 교체하기
- 교체할 키를 생성합니다.
- 교체할 키를 배포합니다.
- 이전 키의 마지막 사용 값이 더 이상 바뀌지 않는지 확인합니다.
- 이전 키를 폐기합니다.
키가 없거나 만료, 폐기, 무효한 경우 401을 반환합니다. 응답 형식은
오류를 참고하세요.