I. Model List
This chapter covers the self-service query APIs at the account level.
1. Get the list of available models
Get the list of model names your current account can access. Use it to:
•Dynamically render a "model selector" in your app
•Select the allowed models when creating an API key
•Check whether a model name entered by a user is valid
Request
•Method:
GET•Path:
/api/user/modelsHeader:
| Name | Required | Notes |
|---|---|---|
Authorization |
Yes | System access token |
Query parameters (optional):
| Parameter | Type | Default | Notes |
|---|---|---|---|
group |
string | — | Group name, optional. If omitted, returns the models (deduplicated) from all groups available to you. Pass auto to return the models in the auto group; pass any other group name to return the models in that group. If the group is not one of your available groups, an empty array is returned. You can view your available groups with GET /api/user/self/groups |
No request body.
Response
Example success response:
The model list is determined dynamically by your account group and system configuration. The following is only a format example; the actual names and count depend on what the API returns.
{
"success": true,
"message": "",
"data": [
"gpt-4o",
"gpt-4o-mini",
"claude-sonnet-4-6",
"claude-opus-4-6",
"qwen3.7-plus",
"qwen3.7-max",
"glm-5.2",
"kimi-k2.7-code",
"doubao-seed-2.1-pro"
]
}
Field descriptions:
| Field | Type | Notes |
|---|---|---|
data |
string[] |
All model names available to you. Each element is a raw model name string, in no fixed order and without categories |
Examples
curl -sS "https://ailink.nativex.com/api/user/models" \
-H "Authorization: Bearer <your-system-access-token>"
Query the models in a single group only:
curl -sS "https://ailink.nativex.com/api/user/models?group=default" \
-H "Authorization: Bearer <your-system-access-token>"
Notes
•The returned list varies with your user group. After you switch groups, or when models are added or removed, the result of this API updates in real time.
•The returned list does not include metadata such as input/output pricing or context length. For pricing, see the "Model Pricing" page in the AiLink console.
•If the account is disabled or fails authentication, 401 is returned.
Common errors
| HTTP | message | Action |
|---|---|---|
| 401 | Unauthorized, ... |
Check whether the Authorization header is set and whether the token is still valid |
| 500 | — | Retry later |