API 레퍼런스
Gateway가 노출하는 엔드포인트, 인증 방식, 에러 응답, 외부 도구 연동을 정리한 곳입니다. 대부분의 호출은 base URL https://gw.letsur.ai/v1 과 Authorization: Bearer <API_KEY> 헤더로 동작합니다. Anthropic 네이티브 경로(/v1/messages)만 base URL과 헤더가 다르므로, 이 경로는 별도 설정이 필요합니다. 자세한 내용은 인증에서 확인합니다.
이 도메인의 페이지
키와 헤더 설정을 OpenAI 호환, Anthropic 네이티브 방식으로 나눠 설명합니다.
인증엔드포인트 목록, 결과를 꺼내는 위치, 기능 비교를 정리합니다.
지원 엔드포인트RFC 7807 응답 형식과 자주 만나는 에러를 다룹니다.
에러 코드Claude Code, Codex, OpenAI SDK, LangChain 연결 방식을 안내합니다.
외부 도구 연동엔드포인트 한눈에 보기
| 엔드포인트 | 경로 | 페이지 |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses |
| Embeddings | POST /v1/embeddings | Embeddings |
| Models | GET /v1/models | Models |
| Messages (Anthropic 네이티브) | POST /v1/messages | Messages |
자주 만나는 시나리오
- OpenAI SDK로 호출: Chat Completions에서 OpenAI 호환 요청 형식을 확인합니다.
- Anthropic SDK / Claude Code: Messages에서 네이티브 경로를 보고, Claude Code 연동으로 설정을 이어갑니다.
- 에러 디버깅: 에러 코드에서 응답의
error_ref로 추적합니다. - 재시도 / 한도 처리: 에러 코드의 재시도 기준을 먼저 보고, 한도 기준은 한도 개요에서 확인합니다.
상위 / 관련
Last updated on