Models

현재 호출할 수 있는 모델 코드를 API에서 조회하세요.

OpenAI 호환 목록과 페이지네이션을 제공하며, 단가와 컨텍스트는 에셋 화면에서 확인합니다.

GEThttps://gw.letsur.ai/v1/models

AUTHAuthorization: Bearer <API_KEY>

요청 파라미터

본문은 없습니다. 목록은 page와 page_size 쿼리로 페이지네이션합니다.

쿼리	타입	요구 여부	기본값	설명
`page`	integer	선택	`1`	조회할 페이지입니다
`page_size`	integer	선택	`20`	페이지당 항목 수입니다. 최대 `100`입니다

응답 (200)

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


{
  "object": "list",
  "data": [
    {
      "id": "<MODEL_CODE_A>",
      "object": "model",
      "created": 1730000000,
      "owned_by": "letsur"
    },
    {
      "id": "<MODEL_CODE_B>",
      "object": "model",
      "created": 1729000000,
      "owned_by": "letsur"
    }
  ],
  "pagination": {
    "total": 42,
    "page": 1,
    "page_size": 20,
    "total_pages": 3
  }
}

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

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

페이지네이션 예시

아래 예제는 Bash 또는 서버 runtime의 LETSUR_API_KEY 환경 변수를 읽습니다. 키 설정은 AI 게이트웨이 시작하기에서 확인합니다.

cURL


(
  test -n "${LETSUR_API_KEY:-}" || { echo "LETSUR_API_KEY가 필요합니다." >&2; exit 1; }
  env -u LETSUR_API_KEY curl "https://gw.letsur.ai/v1/models?page=1&page_size=100" \
    --header @- <<EOF
Authorization: Bearer ${LETSUR_API_KEY}
EOF
)

Python


import os
 
from openai import OpenAI
 
client = OpenAI(api_key=os.environ["LETSUR_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 apiKey = process.env.LETSUR_API_KEY;
if (!apiKey) throw new Error("LETSUR_API_KEY가 필요합니다.");
 
const client = new OpenAI({
  apiKey,
  baseURL: "https://gw.letsur.ai/v1",
});
 
const models = await client.models.list();
for (const m of models.data) {
  console.log(m.id);
}

제약과 공통 오류

유효한 API 키로 현재 스페이스의 모델을 조회합니다. 보유 유닛이 없거나 API 키의 월 한도에 도달했더라도 모델 목록은 조회할 수 있습니다.
전체 목록이 필요하면 pagination.total_pages까지 page를 늘려 순회합니다.
이 엔드포인트 고유의 에러는 없습니다. 인증 오류는 에러 코드를 참고합니다.