curl --request GET \
--url 'https://api.novita.ai/openapi/v2/user/key?includePolicySummary=true' \
--header 'Authorization: Bearer <API_KEY>'
{
"keys": [
{
"name": "default",
"id": "123456",
"stringId": "key_xxx",
"maskedKey": "sk_xxx***",
"memberId": "member_xxx",
"uuid": "user_uuid_xxx",
"expireTime": "never",
"createTime": "2026-07-14 12:00:00",
"lastUsedAt": 1783764000,
"modelAccessPolicy": {
"mode": "selected",
"allowedModelCount": 1,
"excludedModelCount": 0
}
}
]
}
API Key Model Access
List API Keys (with Model Access Summary)
GET
/
openapi
/
v2
/
user
/
key
curl --request GET \
--url 'https://api.novita.ai/openapi/v2/user/key?includePolicySummary=true' \
--header 'Authorization: Bearer <API_KEY>'
{
"keys": [
{
"name": "default",
"id": "123456",
"stringId": "key_xxx",
"maskedKey": "sk_xxx***",
"memberId": "member_xxx",
"uuid": "user_uuid_xxx",
"expireTime": "never",
"createTime": "2026-07-14 12:00:00",
"lastUsedAt": 1783764000,
"modelAccessPolicy": {
"mode": "selected",
"allowedModelCount": 1,
"excludedModelCount": 0
}
}
]
}
List the API keys of the current team. When
includePolicySummary=true, each key includes a modelAccessPolicy summary, which is convenient for showing model access status on a list page. On page initialization, call this endpoint to get the summaries first, then query a single key’s full policy as needed.
Permissions
Returned according to the platform’s existing API key read permissions: Owner / Admin can list all keys in the team; Developer and Basic members see the keys they own, within their accessible scope.Request Headers
string
vereist
Bearer authentication format, for example: Bearer {{API Key}}.
Query Parameters
boolean
Whether to return the
modelAccessPolicy summary for each key. Recommended to pass true on the frontend. When omitted or false, modelAccessPolicy may not be returned.Response Parameters
object[]
vereist
The list of API keys.
Verbergen properties
Verbergen properties
string
vereist
API Key name.
string
vereist
Numeric ID of the API key.
string
vereist
The stringId of the API key, used as the path parameter for the model access policy endpoints.
string
vereist
The masked API key, for example
sk_xxx***. The list endpoint does not return the plaintext key; the plaintext is shown only once at creation time.string
vereist
The sub-user account ID that owns the API key.
string
vereist
The UUID of the user that owns the API key.
string
vereist
Expiration time.
never when the key never expires.string
vereist
Creation time.
int64
vereist
Last used time, as a Unix timestamp in seconds.
0 if never used.curl --request GET \
--url 'https://api.novita.ai/openapi/v2/user/key?includePolicySummary=true' \
--header 'Authorization: Bearer <API_KEY>'
{
"keys": [
{
"name": "default",
"id": "123456",
"stringId": "key_xxx",
"maskedKey": "sk_xxx***",
"memberId": "member_xxx",
"uuid": "user_uuid_xxx",
"expireTime": "never",
"createTime": "2026-07-14 12:00:00",
"lastUsedAt": 1783764000,
"modelAccessPolicy": {
"mode": "selected",
"allowedModelCount": 1,
"excludedModelCount": 0
}
}
]
}
Laatst gewijzigd op 10 augustus 2026