엔드포인트

경로 형식

보호된 자원은 모두 다음 형식의 경로 아래에 노출됩니다:

/v1/<service>/<path...>

<service>는 게이트웨이가 사전에 등록해 둔 서비스 이름이며, 등록되지 않은 이름으로 요청하면 실제 존재 여부와 무관하게 404가 반환됩니다(내부 구성 미노출). <path...> 이후 부분과 쿼리 스트링·요청 바디는 해당 서비스로 그대로 전달됩니다.

지원 HTTP 메서드: GET·POST·PUT·PATCH·DELETE·HEAD·OPTIONS.

모든 /v1/* 요청은 인증이 필요합니다(Authorization: Bearer <token> 헤더 부재 시 401).

등록된 서비스

서비스	경로 접두사	설명
추론 (infer)	/v1/infer/	로컬 LLM — OpenAI 호환 채팅 완성·스트리밍·비전(이미지 입력).
채팅 (claude 티어)	/v1/claude/	Claude 계열 프런티어 채팅 — OpenAI 호환 채팅 완성·스트리밍.
채팅 (gpt 티어)	/v1/gpt/	GPT 계열 프런티어 채팅 — OpenAI 호환 채팅 완성·스트리밍.
임베딩 (embed)	/v1/embed/	텍스트 임베딩(bge-m3, 다국어 1024차원) — OpenAI 호환 embeddings.

그 밖의 개별 서비스 계약(경로별 요청/응답 스키마)은 아직 안정화 단계이며 공개 문서에 개별 표면으로 확정되지 않았습니다. 안정화되는 대로 이 표와 섹션 아래에 서비스별 페이지가 추가됩니다.

응답 헤더

게이트웨이는 응답에서 Set-Cookie를 포함한 세션 관련 헤더를 제거합니다 — 이 API는 순수 bearer 토큰 기반이며 쿠키를 발급하지 않습니다.

헬스체크

GET /healthz

인증이 필요 없는 라이브니스 체크입니다. 백엔드 서비스에는 접촉하지 않고 게이트웨이 프로세스 자체의 상태만 반환합니다.

요청 예시

curl -s https://api.danny22.com/healthz

응답 예시

{ "status": "ok" }

레이트리밋이나 인증이 적용되지 않는 모니터링 전용 엔드포인트입니다.