사용 방법

GoVail Gateway는 OpenAI Chat Completions 규격을 그대로 받습니다.
키만 발급받으면, 쓰던 SDK의 base_url을 바꾸는 쪽이 기본 사용법입니다.

1. Console에서 키 받기

1. https://console.govail.cloud에 들어갑니다.
2. Google 계정으로 로그인합니다.
3. API Key를 발급받습니다. 처음 로그인했는데 키가 없으면 생성 화면이 열립니다.
4. 발급된 평문 키는 한 번만 보입니다. 비밀번호처럼 보관하세요.

키 prefix(gv_code_..., gv_web_...)는 구분용입니다. 실제 경로(CODE / WEB)는 서버에 저장된 credential metadata가 결정합니다.

2. OpenAI 규격으로 호출

엔드포인트: https://api.govail.cloud/v1

curl -s https://api.govail.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'

Python 예:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.govail.cloud/v1",
)

res = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(res.choices[0].message.content)

Cursor / OpenCode / Codex는 Provider 설정에서 base URL만 https://api.govail.cloud/v1로 두면 됩니다.

두 종류의 키

키	경로	용도
CODE (agentic_coding)	Gateway → 모델	이미 루프를 가진 코딩 에이전트
WEB (governed_web)	Gateway → Router → (필요 시 Runtime) → 모델	대화, 근거, 외부 실행이 걸린 요청

같은 OpenAI 규격입니다. 차이가 나는 지점은 서버가 고르는 실행 경로입니다.

관련 주소

용도	URL
Developer Console	console.govail.cloud
OpenAI-compatible API	api.govail.cloud/v1

구조가 궁금하면 Architecture를 보세요.