API 모델
Rivya API 모델 목록과 모델 ID, 카테고리, 프롬프트 한도, 참조 미디어, 제공 상태, Files API 의존성을 확인하세요.
최근 검토일 2026/08/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모델을 선택하세요.