Models

GET /v1/models 로 호출 가능한 모델 목록을 코드에서 조회할 수 있습니다. 도구나 SDK에서 모델 목록을 갱신할 때 사용합니다.


GET https://gw.letsur.ai/v1/models

이 엔드포인트는 Gateway에 등록된 모델 정의를 그대로 목록으로 반환합니다.

같은 정보를 화면에서 보려면 에셋 카탈로그를 엽니다. 카탈로그에는 단가, 컨텍스트 길이, 지원 엔드포인트 같은 부가 정보도 함께 있습니다. 이 엔드포인트는 모델 코드 목록만 돌려줍니다.

인증

요청에 API 키를 Bearer 토큰으로 넣습니다.

방식	헤더
Gateway 키	`Authorization: Bearer <API_KEY>`

시그니처


GET https://gw.letsur.ai/v1/models

쿼리 파라미터와 본문은 없습니다. 현재는 전체 목록만 반환합니다. capability, provider, status 필터는 추가되는 대로 이 페이지에 반영합니다.

응답 (200)

성공하면 200 과 함께 모델 배열을 반환합니다.


{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1730000000,
      "owned_by": "letsur"
    },
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1729000000,
      "owned_by": "letsur"
    }
  ]
}

필드	의미
`data[].id`	모델 코드입니다. 호출 시 `model` 필드에 그대로 넣습니다
`data[].object`	항상 `"model"` 입니다
`data[].created`	모델 추가, 갱신 시각입니다 (Unix epoch)
`data[].owned_by`	OpenAI 호환을 위해 `letsur` 로 고정합니다. 실제 공급사 정보는 보안 정책에 따라 노출하지 않습니다

단가, 컨텍스트, 지원 엔드포인트 같은 부가 정보는 이 응답에 포함하지 않습니다. 부가 정보는 에셋 카탈로그에서 확인합니다.

예시

cURL


curl https://gw.letsur.ai/v1/models \
  -H "Authorization: Bearer <API_KEY>"

Python


from openai import OpenAI
 
client = OpenAI(api_key="<API_KEY>", base_url="https://gw.letsur.ai/v1")
 
models = client.models.list()
for m in models.data:
    print(m.id)

TypeScript


import OpenAI from "openai";
 
const client = new OpenAI({
  apiKey: "<API_KEY>",
  baseURL: "https://gw.letsur.ai/v1",
});
 
const models = await client.models.list();
for (const m of models.data) {
  console.log(m.id);
}

에러

이 엔드포인트 고유의 에러는 없습니다. 인증, 한도 같은 공통 에러만 발생합니다. 에러 코드를 참고합니다.

한도와 제약

한도 체크가 적용됩니다. 한도 개요를 참고합니다.
메타데이터만 조회하므로 호출 비용은 거의 들지 않습니다. usage.estimated_cost 는 0에 가깝습니다.