Models

현재 스페이스의 모델 코드를 API로 조회하세요.

모델 코드를 조회하고, 토큰 한도와 지원 엔드포인트는 에셋 화면에서 확인합니다.

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

AUTHAuthorization: Bearer <API_KEY>

요청 파라미터

본문과 페이지네이션 파라미터는 없습니다. 현재 스페이스의 전체 모델 목록을 한 번에 반환합니다.

응답 (200)

성공하면 200과 함께 모델 배열을 반환합니다. 아래는 일부 필드를 보여주는 설명용 예시이며, 실제 모델의 Batch 지원 여부는 현재 응답으로 확인합니다.


{
  "object": "list",
  "data": [
    {
      "id": "<MODEL_CODE_A>",
      "object": "model",
      "created": 1730000000,
      "owned_by": "letsur",
      "supports_batch": true
    },
    {
      "id": "<MODEL_CODE_B>",
      "object": "model",
      "created": 1729000000,
      "owned_by": "letsur",
      "supports_batch": false
    }
  ]
}

필드	의미
`data[].id`	모델 코드입니다. 호출 시 `model` 필드에 그대로 넣습니다
`data[].object`	항상 `"model"`입니다
`data[].created`	모델 추가, 갱신 시각입니다 (Unix epoch)
`data[].owned_by`	OpenAI 호환 응답에서 `letsur`를 반환합니다. 이 값은 실제 모델 공급사를 나타내지 않습니다
`data[].supports_batch`	모델의 Batch 지원 여부입니다. 지원 API와 스페이스의 신규 제출 조건은 별도로 확인합니다

모델 객체에 max_input_tokens 필드는 있지만 현재 값은 null입니다. 무제한으로 해석하지 말고 에셋 화면에서 토큰 한도를 확인합니다. 입력 한도와 출력 상한은 구분합니다. pricing과 supports_batch는 응답에서 확인할 수 있으며, 지원 엔드포인트는 에셋에서 확인합니다.

모델 목록 조회 예시

아래 예제는 전체 모델 목록을 한 번에 조회합니다. 응답은 object와 data로 구성되며 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" \
    --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 키의 월 한도에 도달했더라도 모델 목록은 조회할 수 있습니다.
이 엔드포인트 고유의 오류는 없습니다. 인증 오류는 오류 코드를 참고합니다.