API Models
Rivya API models를 나열하고 model IDs, categories, prompt limits, reference media, readiness states, Files API dependencies를 이해하세요.
최근 검토일 2026/05/11
Public API readiness가 포함된 Rivya models를 나열하려면 GET /api/v1/models를 사용하세요.
curl https://rivya.ai/api/v1/models이 endpoint는 public read-only입니다. 아직 완전히 호출할 수 없는 모델까지 포함해 API docs와 online debugger가 사용하는 같은 public model layer를 반환합니다.
Response Shape
Response는 다음 shape를 사용합니다.
{
"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": []
}
]
}비동기 generation models에서는 POST /api/v1/generations의 model 값으로 id를 사용하세요. chat models의 경우 POST /api/v1/chat/completions를 사용하고 chat_capabilities를 확인하세요.
Availability States
model reference는 다음 public states를 사용합니다.
available: 하나 이상의 Public API generation path를 사용할 수 있음coming_soon: async generation model이지만 현재 Public API에 노출되어 있지 않음studio_only: Studio 또는 다른 product surface에서는 사용할 수 있지만 Public API v1에는 속하지 않음
input readiness field는 더 구체적입니다.
available_text: prompt-based requests를 바로 테스트할 수 있음available_url_input: public URL 또는 scalar params를 바로 테스트할 수 있음partial_requires_files: 일부 modes는 upload 없이 호출할 수 있고, reference-media modes는 Files API를 사용해야 함requires_files_api: model이/api/v1/files를 통한 uploaded reference media에 의존함
uploaded image, video, audio references가 필요한 modes를 호출하기 전에 Files API를 사용하세요.
chat models의 경우 chat_capabilities는 Chat API가 non-streaming responses, streaming responses, web search, image file_id attachments, thoughts, reasoning effort를 지원하는지 문서화합니다.
Model Count Policy
Rivya가 models를 추가, 제거, 제한 공개함에 따라 public model list는 바뀝니다.
integration에서 hard-coded model count에 의존하지 마세요. 항상 /api/v1/models 또는 dynamic Model API Reference를 읽으세요.