このページはまだ日本語に翻訳されていません。英語の原文を表示します。
GET /models
Listing and filtering the catalog
Returns every model you can currently call. No authentication required.
GET https://openrouter.myip.co.kr/api/v1/modelsThe response shape matches openrouter — field names, nesting, and the convention of encoding decimals as strings — and the only difference is that the numbers in pricing are KRW per token rather than USD per token. That is why there is a pricing.currency field and an X-MyIP-Currency: KRW header. Parsers written for openrouter ignore unknown fields, so they keep working.
Query parameters
qstringFull-text search over model id, name and description.
categorystringNarrows by modality family (text, image, …). Our catalog has no openrouter category column, so we match on architecture.modality and input_modalities.
input_modalitiesstringComma-separated. Keeps only models that accept all the listed input modalities, e.g. text,image.
output_modalitiesstringComma-separated, same rule applied to output modalities.
supported_parametersstringComma-separated. Keeps only models supporting all the listed parameters, e.g. tools,response_format.
contextintegerKeeps models whose context_length is at least this value.
min_pricenumberLower bound on the prompt sell rate, in KRW per token.
max_pricenumberUpper bound on the prompt sell rate, in KRW per token, e.g. max_price=0.00005.
model_authorsstringComma-separated. This is the part of the model id before the /, e.g. google,lgai.
providersstringComma-separated provider slugs. Keeps only models that provider actually serves.
sortstringprice (= pricing-low-to-high), pricing-high-to-low, context (= context-high-to-low), newest (= created), top-weekly. Any other value is ignored and the default model-id ordering is kept.
offsetintegerHow many to skip. Defaults to 0.
limitintegerHow many to return. Omitted, everything is returned.
Request examples
# Tool-calling models with at least 32k context, cheapest first
curl "https://openrouter.myip.co.kr/api/v1/models?supported_parameters=tools&context=32768&sort=price"
# Only certain authors
curl "https://openrouter.myip.co.kr/api/v1/models?model_authors=google,lgai"
# Only models served by our GPU farm, second page
curl "https://openrouter.myip.co.kr/api/v1/models?providers=local-gpu&limit=20&offset=20"Response
dataobject[]An array of model objects. The total count is not in this response; /models/count provides it separately.
data[].idstringThe model id, in author/slug form. This is what goes in a request's model.
data[].canonical_slugstringCanonical slug; falls back to id.
data[].hugging_face_idstring | nullHugging Face repository id, or null when unknown.
data[].namestringDisplay name.
data[].createdintegerUnix seconds.
data[].descriptionstringDescription, or an empty string.
data[].context_lengthinteger | nullContext length in tokens.
data[].architectureobjectmodality, input_modalities, output_modalities, tokenizer, instruct_type.
data[].pricingobjectSell rates in KRW per token. Every value is a string. Fields: prompt, completion, request, image, web_search, internal_reasoning, input_cache_read, input_cache_write, and currency.
request, image, web_search and internal_reasoning are always "0" because we do not charge for those. currency is our addition, absent from openrouter, and is always "KRW".
data[].top_providerobjectcontext_length, max_completion_tokens, is_moderated.
data[].supported_parametersstring[]The request parameter names this model accepts.
data[].default_parametersobjectModel defaults; an empty object when there are none.
data[].per_request_limitsobject | nullPer-request limits. We do not use these, so usually null.
data[].supported_voicesnullnull — we do not support speech synthesis.
data[].knowledge_cutoffstring | nullTraining data cutoff.
data[].expiration_datestring | nullPlanned retirement date.
data[].reasoningobject | nullReasoning-token metadata, or null when unknown.
data[].weekly_tokensnumber | nullRecent weekly token volume.
data[].links.detailsstringThe endpoints path for this model: /api/v1/models/<id>/endpoints.
Response example
{
"data": [
{
"id": "google/gemma-4-26b-a4b",
"canonical_slug": "google/gemma-4-26b-a4b",
"hugging_face_id": null,
"name": "Google: Gemma 4 26B A4B",
"created": 1786924800,
"description": "Gemma 4 26B (MoE, 4B active, QAT AWQ-INT4). Default MyIP local GPU slot. Supports tool calling.",
"context_length": 32768,
"architecture": {
"modality": "text+image->text",
"input_modalities": ["text", "image"],
"output_modalities": ["text"],
"tokenizer": "Other",
"instruct_type": null
},
"pricing": {
"prompt": "0.000030",
"completion": "0.000150",
"request": "0",
"image": "0",
"web_search": "0",
"internal_reasoning": "0",
"input_cache_read": "0.000003",
"input_cache_write": null,
"currency": "KRW"
},
"top_provider": {
"context_length": 32768,
"max_completion_tokens": 32768,
"is_moderated": false
},
"per_request_limits": null,
"supported_parameters": [
"max_tokens", "temperature", "top_p", "top_k", "stop", "seed",
"frequency_penalty", "presence_penalty", "repetition_penalty",
"logit_bias", "response_format", "tools", "tool_choice"
],
"default_parameters": {},
"supported_voices": null,
"knowledge_cutoff": null,
"expiration_date": null,
"reasoning": null,
"weekly_tokens": null,
"links": { "details": "/api/v1/models/google/gemma-4-26b-a4b/endpoints" }
}
]
}"prompt": "0.000030" means 0.00003 won per token — 30 won per million tokens. How rates are derived is explained in How costs are calculated.
Related endpoints
GET /models/count
Counts public models only, and takes no query parameters.
curl https://openrouter.myip.co.kr/api/v1/models/count{ "data": { "total": 12 } }GET /models/user
Requires an inference key. Returns the models that key can actually call. It differs from /models in two ways: private models are included, and models with no provider mapping — which therefore cannot be called — are excluded. Query parameters and response shape are the same as /models.
curl https://openrouter.myip.co.kr/api/v1/models/user \
-H "Authorization: Bearer $MYIP_API_KEY"Errors
| Status | error_type | Raised when |
|---|---|---|
| 401 | invalid_api_key | /models/user called with no key or a bad key |
| 429 | rate_limit_exceeded | Request rate limit exceeded |
| 500 | server | Server error |
/models and /models/count are unauthenticated, so they never return 401. Unknown query parameters and unparseable values are ignored rather than rejected.
最終更新 2026/09/05