본문으로 건너뛰기

모델 선택

사용할 모델과 호출 방식 선택하기

에셋 화면에서 현재 스페이스의 모델 코드, 지원 API, 입력 조건과 단가를 비교하고 선택한 모델의 호출 안내를 확인합니다.

페이지 목차

에셋 화면 열기

진입위치
UI에서 보기왼쪽 메뉴 > AI 게이트웨이 > 에셋
API로 보기GET https://gw.letsur.ai/v1/models (Models)

에셋 화면의 기본 모델, 미디어 모델, 커스텀 모델 탭에서 사용할 모델을 찾습니다. 영상 모델은 미디어 모델 탭에 있습니다. 이미지 모델 가운데 일부는 기본 모델 탭에 있습니다. 이미지 모델의 호출 방법은 탭과 관계없이 이미지와 영상 만들기에서 확인합니다.

Models API는 모델 코드와 함께 pricing, supports_batch 필드를 반환합니다. 단가의 의미와 호출별 비용 해석은 요청별 비용에서 확인합니다.

모델 비교 항목

에셋 화면에서 모델마다 다음 항목을 확인합니다. 이미지나 영상 모델이라면 모델별 가이드가 있는지도 함께 보세요.

모델 코드
요청의 model 필드에 지정하는 정확한 식별자이며, 에셋 화면에서는 에셋 코드로 표시됩니다. 별칭이나 공급사 접두사를 임의로 추가하지 않습니다.
상태
현재 스페이스에서 모델을 호출할 수 있는지 나타냅니다. 스페이스별 제공 조건에 따라 목록이 달라질 수 있습니다.
지원 API
에셋이 지원하는 요청 경로입니다. 모델 이름이나 결과 종류만으로 호출 형식을 정하지 않습니다.
단가와 컨텍스트
현재 unit 단가와 토큰 한도입니다. 텍스트 생성 모델의 컨텍스트 한도는 입력과 출력을 합해 처리할 수 있는 범위이며, 출력 토큰 상한과는 다릅니다. 대화 이력과 시스템 지시도 입력에 포함됩니다.
에셋과 모델별 가이드에 없는 조건을 지원이나 무제한으로 판단하지 마세요

토큰 한도, 입력 배열의 크기, 이미지 해상도, 도구 호출이나 선택 파라미터처럼 확인해야 할 조건이 에셋이나 모델별 가이드에 없을 수 있습니다. 표시된 정보만으로 지원 여부나 한도를 확인할 수 없다면 플랫폼 내 문의 기능에 모델 코드와 확인하려는 입력 조건 또는 기능을 남기세요. API 키나 실제 입력 원문은 보내지 않습니다.

선택한 모델 호출하기

호출하려면 그 모델을 사용할 수 있는 스페이스의 API 키가 필요합니다. 키가 없다면 API 키 만들기에서 자신의 키를 만드세요. 인증 헤더와 SDK의 기본 URL은 인증과 기본 URL에 맞춰 지정합니다.

선택한 모델과 하려는 일에 맞춰 다음 안내로 이동하세요. 에셋에 모델별 가이드나 요청 예시가 제공되면 함께 확인합니다.

선택한 모델과 하려는 일이동할 곳
텍스트 모델로 응답 받기텍스트 생성하기에서 API 형식을 선택합니다. Chat Completions를 지원하는 모델이라면 첫 API 호출에서 키와 모델 코드를 안전하게 설정하고 요청을 보냅니다
이미지 모델이나 영상 모델로 결과 만들기이미지와 영상 만들기에서 모델별 호출 경로와 결과를 받는 방법(응답으로 바로 받기 또는 작업 ID로 조회)을 확인합니다
여러 요청을 파일로 묶어 일괄 제출하기여러 요청을 Batch로 처리하기에서 Batch 입력 조건을 별도로 확인합니다
기본 제공 목록에 없는 모델 사용하기작업할 스페이스가 맞는지 먼저 확인한 뒤 커스텀 에셋 문의에서 도입 가능성을 확인합니다

Batch로 제출할 수 있는 모델은 Batch 시작 전 준비에서 확인합니다. Batch 입력의 토큰 한도는 에셋 화면의 표시값에서 확인합니다. Models API 응답의 max_input_tokens 필드는 현재 null입니다. max_input_tokens 값의 뜻과 긴 입력이 처리 중에 실패하는 경우는 긴 입력의 처리 후 실패에서 함께 확인하세요.

요청 필드와 응답 형식은 아래 엔드포인트 명세에서 확인합니다. 선택한 에셋이 지원하는 API만 사용하세요.

모델별 가이드

이미지 모델과 영상 모델에서 한 모델에만 해당하는 내용은 모델별 가이드에서 확인합니다. 모델 코드와 엔드포인트, 그 모델이 받는 요청 필드와 허용 값, 크기와 수량 제한, 고유 기능이 여기에 해당합니다. 모델별 가이드는 메뉴의 모델별 가이드에서도 열 수 있습니다.

텍스트 모델에는 모델별 가이드가 없습니다. 모델마다 다른 지원 여부와 한도는 에셋 화면에서 확인합니다.

결과 종류모델별 가이드
이미지GPT Image 2, Seedream 5.5
영상Seedance 2.5, Seedance 2.0 계열, Seedance 장면 연결, Kling

업스트림 응답 상태 확인

모델 호출에서 오류나 지연이 발생했다면 공급사 헬스체크 화면에서 업스트림 응답 상태를 확인하세요. 목록에는 선택한 스페이스에서 쓸 수 있는 에셋의 응답 상태가 나오며, 정상으로 판정된 항목은 표시되지 않습니다. 에셋 목록의 제공 여부와 응답 상태는 서로 다른 정보입니다.

작업할 스페이스가 맞는지 확인한 뒤 목록에서 오류나 지연이 발생한 에셋의 응답 상태를 확인합니다.

화면에 표시된 결과확인할 내용
오류 또는 지연표시된 에셋의 호출에서 감지된 문제입니다. 개별 요청의 결과는 요청 응답과 함께 확인합니다.
상태 확인 불가현재 상태를 판정할 정보가 부족합니다. 정상이나 장애로 확정하지 않습니다.
표시할 항목 없음정상으로 판정된 항목은 목록에 표시되지 않습니다. 모든 모델을 실제로 호출해 성공을 확인했다는 뜻은 아닙니다.
조회 실패 안내인증이나 접근 오류라면 로그인 상태와 선택한 스페이스의 참여 권한을 확인합니다. 일시적인 조회 실패라면 잠시 뒤 다시 조회합니다. 조회 실패를 빈 정상 목록으로 해석하지 않습니다.
  • 화면이 보이는 동안에는 응답 상태가 5분마다 자동으로 다시 조회됩니다. 새로고침으로 직접 갱신할 수도 있습니다.
  • 최근 갱신 시각은 화면이 조회 결과를 받은 시각입니다. 모델 상태가 바뀐 시각과 다릅니다.
  • 새로고침해도 모델이 새로 호출되지는 않습니다.

프로그램에서 같은 종류의 상태를 확인하려면 업스트림 응답 상태 조회 API를 사용하세요. 콘솔은 선택한 스페이스를, API는 키가 연결된 스페이스를 조회합니다. 상태 정보만으로 오류 원인이 공급사에 있다고 확정할 수는 없습니다.