지원 엔드포인트

Gateway가 제공하는 엔드포인트입니다. 대부분 OpenAI 호환이고, Messages는 Anthropic 네이티브 형식을 따릅니다.

Base URL과 인증

경로에 따라 base URL과 인증 헤더가 두 가지로 나뉩니다.

경로	base URL	인증 헤더
OpenAI 호환	`https://gw.letsur.ai/v1`	`Authorization: Bearer <API_KEY>`
Anthropic 네이티브 (`/v1/messages`)	`https://gw.letsur.ai`	`x-api-key: <API_KEY>` + `anthropic-version: 2023-06-01`

자세한 내용은 인증에서 확인합니다.

이 도메인의 페이지

POST /v1/chat/completions 경로의 텍스트·이미지 입력과 스트리밍을 다룹니다.

Chat Completions

POST /v1/responses 경로와 Responses 형식의 결과를 다룹니다.

Responses

POST /v1/embeddings 경로로 임베딩을 생성하는 방법을 안내합니다.

Embeddings

GET /v1/models 경로로 사용할 수 있는 모델을 조회합니다.

Models

Anthropic 네이티브 POST /v1/messages 경로를 다룹니다.

Messages

LLM 텍스트를 꺼내는 위치

응답 JSON 구조는 엔드포인트마다 다릅니다. 모델이 생성한 결과를 꺼내는 위치만 모아 정리합니다.

엔드포인트	스키마	결과 경로	SDK 편의 속성
`/v1/chat/completions`	OpenAI	`choices[0].message.content`	—
`/v1/chat/completions` (이미지)	OpenAI + `images` 필드	`choices[0].message.images[0].image_url.url` (base64)	—
`/v1/responses`	OpenAI Responses	`output[0].content[0].text`	`response.output_text`
`/v1/embeddings`	OpenAI	`data[0].embedding`	—
`/v1/messages`	Anthropic	`content[0].text`	—

자주 만나는 시나리오

OpenAI 호환 코드 그대로: Chat Completions를 쓰면 base URL과 키만 바꿔 그대로 동작합니다.
Anthropic SDK / Claude Code: Messages 네이티브 경로를 확인합니다.
임베딩 / RAG: Embeddings에서 임베딩 요청 형식을 확인합니다.
사용 가능한 모델 조회: API로는 Models를, 화면에서는 에셋 카탈로그를 확인합니다.

엔드포인트 비교

응답 형식과 지원 기능은 엔드포인트마다 다릅니다.

차원	Chat Completions	Responses	Embeddings	Messages
요청 형식	`messages[]`	`input` (문자열·배열)	`input` (문자열·배열)	`messages[]` (Anthropic)
결과 경로	`choices[0].message.content`	`output[0].content[0].text`	`data[0].embedding`	`content[0].text`
스트리밍	SSE	SSE (이벤트)	미지원	SSE (Anthropic 형식)
Tool calling	지원	지원	미지원	지원 (Anthropic 형식)
이미지 입력	지원	지원	미지원	지원
JSON 모드	지원 (`response_format`)	지원	미지원	미지원
`usage.estimated_cost` 주입	지원	지원	지원	지원

Chat Completions가 OpenAI 호환 기본 경로입니다. Responses는 OpenAI의 차세대 형식으로, 같은 모델을 다른 인터페이스로 제공합니다. Messages는 Anthropic 네이티브 형식이 필요한 클라이언트(Claude Code 등)에서 쓰며, 응답에 usage.estimated_cost 가 함께 들어갑니다.

상위 / 관련

API 레퍼런스 인증·헤더 모든 엔드포인트 공통 에러 단가