API 레퍼런스
모델 목록
GET
/v1/models이 키로 호출할 수 있는 모든 모델을 나열합니다 — Cursor 같은 클라이언트가 연결 확인에 사용합니다. 모델 허용 목록이 있는 키는 허용 목록의 모델만 봅니다.
#요청 예시
curl https://www.aisplice.store/v1/models \
-H "Authorization: Bearer sk-YOUR_KEY"#응답
response.json
{
"object": "list",
"data": [
{"id": "gpt-5.6-luna", "object": "model", "owned_by": "openai"},
{"id": "gpt-5.6-terra", "object": "model", "owned_by": "openai"},
{"id": "gpt-5.6-sol", "object": "model", "owned_by": "openai"},
{"id": "claude-opus-5-5", "object": "model", "owned_by": "anthropic"},
{"id": "qwen3.7-max", "object": "model", "owned_by": "alibaba"}
]
}이 페이로드에는 가격이 없습니다 — 모델 페이지에서 모델별 실시간 가격, 요금 구간, 기능 태그를 확인하세요.
#모델 목록 읽는 법
어떤 목록 필드가 모델의 지원 기능을 알려 주는지, 어떤 필드를 UI에 둘지 설명합니다.
supported_endpoint_types- 노출 시점
- 모델이 어떤 엔드포인트 형식에 속하는지 판단할 때 먼저 확인하세요.
- 권장 기본값
- UI 컨트롤이 아니라 라우팅 신호로 다루세요.
- 중요한 이유
- 모델을 /images, /images/tasks, /videos, /audio, 채팅형 엔드포인트 중 어디로 호출해야 하는지 알려 줍니다.
pricing_tiers.size / quality / resolution / duration- 노출 시점
- 제품 UI에 어떤 조절 항목을 둘지 정할 때 확인하세요.
- 권장 기본값
- 요금 구간 맵이 비어 있으면 해당 컨트롤을 숨기세요.
- 중요한 이유
- 이 맵은 모델이 해당 요금 기준을 실제로 지원한다는 가장 확실한 증거입니다.
pricing_tiers.reference- 노출 시점
- 이미지나 동영상 참조 미디어가 허용되는지, 필수인지 알아야 할 때 확인하세요.
- 권장 기본값
- 이 객체에 명시되어 있지 않다면 참조 업로드 컨트롤을 숨기세요.
- 중요한 이유
- 워크플로가 프롬프트만 쓰는지 참조 기반인지, 공개 URL이 필요한지를 결정합니다.
quota_type- 노출 시점
- 사용자나 운영자에게 가격 체계를 설명할 때 확인하세요.
- 권장 기본값
- 모델 상세 페이지에 읽기 전용 메타데이터로 표시하세요.
- 중요한 이유
- 토큰 기준 과금과 요청당 과금을 구분하며, 사용자가 비용을 이해하는 방식을 바꿉니다.
tags / capability- 노출 시점
- 엔드포인트 유형이 너무 포괄적일 때 보조 힌트로 사용하세요.
- 권장 기본값
- 유일한 기준으로 삼지 마세요.
- 중요한 이유
- 채팅, 이미지, 동영상, 오디오를 구분하는 데 도움이 되지만, 명시적인 엔드포인트 필드나 요금 구간 필드보다 신뢰도가 낮습니다.
아직 해결되지 않았나요?
요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.