Skip to main content

Listar permissões de modelos

Chame o endpoint GET /api/v1/models/permissions para consultar a lista de modelos autorizáveis ou autorizados e seus detalhes de permissão no workspace atual.

Pré-requisitos

Uma chave de API foi criada e configurada como a variável de ambiente DASHSCOPE_API_KEY. Para mais informações, consulte Configurar uma chave de API em variáveis de ambiente.

Solicitação

  • Método HTTP: GET
  • URL da solicitação
    Substitua {WorkspaceId} pelo ID do seu workspace.

    Região

    Endpoint

    China (Pequim)

    https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/permissions

  • Autenticação Defina Authorization: Bearer {API_KEY} no cabeçalho da solicitação.

Parâmetros da solicitação

Todos os parâmetros são passados através da query string.

Parâmetro

Tipo

Obrigatório

Descrição

name

String

Não

Busca difusa por nome do modelo. Realiza correspondência difusa com name e model_id. Exemplo: qwen

model

String

Não

Correspondência exata por ID do modelo. Realiza correspondência exata com model_id. Exemplo: qwen-plus

page_no

Integer

Não

Número da página, um número inteiro positivo começando em 1. Valor padrão: 1.

page_size

Integer

Não

Número de entradas por página, variando de 1 a 200 (máximo 200). Valor padrão: 20.

authorization_scope

String

Não

Filtro de escopo de autorização. Valores válidos:

  • AUTHORIZABLE: Modelos autorizáveis (padrão).

  • AUTHORIZED: Modelos autorizados.

Valor padrão: AUTHORIZABLE. Exemplo: AUTHORIZED

action

String

Não

Dimensão de ação de permissão. Valores válidos: INFERENCE - inferência (atualmente o único valor suportado). Aciona a dimensão de filtro apenas quando authorization_scope=AUTHORIZED. Valor padrão: INFERENCE.

Parâmetros de resposta

Parâmetro

Tipo

Descrição

request_id

String

O ID da solicitação. Exemplo: d5f5201f-ee7a-9e3d-8569-bc0eedec21f9

code

String

Código de erro. null em caso de sucesso.

message

String

Mensagem de erro. null em caso de sucesso.

success

Boolean

Se a chamada foi bem-sucedida. Exemplo: true

output.total

Number

Número total. Exemplo: 5

output.page_no

Number

Número da página. Exemplo: 1

output.page_size

Number

Número de entradas por página. Exemplo: 20

output.permissions

Array[Object]

Lista de permissões. Veja a resposta de exemplo.

output.model

String

O ID do modelo. Exemplo: qwen-plus

output.name

String

Nome de exibição do modelo. Exemplo: 通义千问-Plus

output.permissions[].permissions

Object

Detalhes da permissão. Exemplo: {"inference":true,"fine_tune":false,"deploy":false}. Contém os seguintes campos:

  • inference (Boolean): Se o modelo tem permissão de chamada de modelo. Exemplo: true

  • finetune (Boolean): Se o modelo tem permissão de treinamento de modelo. Exemplo: false

  • deploy (Boolean): Se o modelo tem permissão de implantação de modelo. Exemplo: false

Exemplos de solicitações

curl "https://dashscope.aliyuncs.com/api/v1/models/permissions?authorization_scope=AUTHORIZED&action=INFERENCE&page_no=1&page_size=20" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json'

Resposta de exemplo

{
    "code": null,
    "message": null,
    "success": true,
    "output": {
        "total": 1,
        "page_no": 1,
        "page_size": 20,
        "permissions": [
            {
                "model": "qwen-plus",
                "name": "通义千问-Plus",
                "permissions": {
                    "inference": true,
                    "fine_tune": false,
                    "deploy": false
                }
            }
        ]
    },
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

Códigos de erro

Se a chamada falhar, uma mensagem de erro será retornada. Para mais informações sobre códigos de erro e soluções, consulte Mensagens de erro.