API 모델
Rivya API 모델 목록과 모델 ID, 카테고리, 프롬프트 한도, 참조 미디어, 제공 상태, Files API 의존성을 확인하세요.
최근 검토일 2026년 8월 11일
공개 API 제공 상태가 포함된 Rivya 모델 목록을 확인하려면 GET /api/v1/models를 사용하세요.
curl https://rivya.ai/api/v1/models이 엔드포인트는 공개 읽기 전용입니다. 아직 모든 방식으로 호출할 수 없는 모델까지 포함해 API 문서와 온라인 디버거가 공통으로 사용하는 공개 모델 계층을 반환합니다.
응답 구조
응답은 다음 구조를 사용합니다.
{
"object": "list",
"data": [
{
"id": "z-image",
"display_name": "Z-Image",
"category": "image",
"runtime": "async_task",
"base_credits": 1,
"billing_type": "FIXED",
"supported_modes": ["text-to-image"],
"max_prompt_length": 1000,
"reference_media": null,
"params": [],
"api_status": "available",
"api_input_status": "available_text",
"supported_api_inputs": ["text"],
"requires_files_api": false,
"requires_upload_for_modes": [],
"url_input_supported": false,
"file_kinds": [],
"chat_capabilities": null,
"notices": []
}
]
}비동기 생성 모델에서는 POST /api/v1/generations의 model 값으로 id를 사용하세요. 채팅 모델은 POST /api/v1/chat/completions를 사용하고 chat_capabilities를 확인하세요.
제공 상태
모델 레퍼런스는 다음 공개 상태를 사용합니다.
available: 하나 이상의 공개 API 생성 경로를 사용할 수 있음temporarily_unavailable: 모델이 일시적으로 사용 중지되어 현재 Public API v1에서 호출할 수 없음studio_only: Studio 또는 다른 제품 영역에서는 사용할 수 있지만 공개 API v1에는 속하지 않음
입력 준비 상태 필드는 더 구체적입니다.
available_text: 프롬프트 기반 요청을 바로 테스트할 수 있음available_url_input: 공개 URL 또는 스칼라 파라미터를 바로 테스트할 수 있음partial_requires_files: 일부 모드는 업로드 없이 호출할 수 있지만 참조 미디어 모드에는 Files API가 필요함requires_files_api: 모델이/api/v1/files를 통해 업로드한 참조 미디어에 의존함
업로드한 이미지, 비디오 또는 오디오 참조가 필요한 모드를 호출하기 전에 Files API를 사용하세요.
채팅 모델의 chat_capabilities에는 Chat API의 비스트리밍 응답, 스트리밍 응답, 웹 검색, 이미지 file_id 첨부, 사고 과정과 추론 강도 지원 여부가 기록됩니다.
모델 수 정책
Rivya가 모델을 추가하거나 제거하고 공개 범위를 제한함에 따라 공개 모델 목록은 달라질 수 있습니다.
연동 코드에서 고정된 모델 수에 의존하지 마세요. 항상 /api/v1/models 또는 동적 모델 API 레퍼런스를 확인하세요.
관련 페이지
출시 예정 읽기 전용 항목
coming_soon: 검색과 확인용으로만 표시되며 생성 또는 Chat API에 제출할 수 없습니다.supports_direct_generation: false, null runtime·billing·pricing, 빈supported_modes와params를 반환합니다. 요청에는api_status: available모델을 선택하세요.