Skip to main content
Gerenciamento de modelos

Atualizar permissões de modelo

Use o endpoint POST /api/v1/models/permissions para atualizar a autorização de modelos (inferência, ajuste fino ou implantação) em um workspace específico. O sistema suporta tanto a autorização por modelo individual quanto o modo "autorizar todos".

Pré-requisitos

Crie uma chave de API e configure-a como a variável de ambiente DASHSCOPE_API_KEY. Para mais informações, consulte Configure an API key in environment variables.

Requisição

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

    Região

    Endpoint

    China (Beijing)

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

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

Parâmetros da requisição

Envie todos os parâmetros no corpo da requisição.

Parâmetro

Tipo

Obrigatório

Descrição

models

Array[Object]

Condicionalmente obrigatório

Lista de itens de autorização por modelo. Pode estar vazia quando access_all_entities for OPEN/CLOSE. É obrigatória quando o valor for KEEP ou não estiver especificado; nesse caso, deve conter de 1 a 20 itens. Exemplo: [{"model":"qwen-plus","inference":true}]

models[].model

String

Sim

ID do modelo. Não pode estar vazio. Exemplos: qwen-plus, qwen3-max.

models[].inference

Boolean

Não

Permissão de chamada do modelo. true: concede permissão de inferência; false: revoga a permissão; não especificado: mantém a configuração atual. Valor padrão: null (sem alteração).

models[].finetune

Boolean

Não

Permissão de treinamento do modelo. true: concede permissão de ajuste fino; false: revoga a permissão; não especificado: mantém a configuração atual. Valor padrão: null (sem alteração).

models[].deploy

Boolean

Não

Permissão de implantação do modelo. true: concede permissão de implantação; false: revoga a permissão; não especificado: mantém a configuração atual. Valor padrão: null (sem alteração).

access_all_entities

String

Não

Opção para autorizar todos os modelos. Valores válidos:

  • OPEN: autoriza automaticamente todos os modelos de inferência no workspace atual, incluindo os adicionados posteriormente.

  • CLOSE: cancele a autorização global e remove as autorizações anteriores de inferência.

  • KEEP: mantém o comportamento original de autorização por modelo (padrão).

Se você definir OPEN ou CLOSE, poderá omitir o campo models. Valor padrão: KEEP. Exemplo: OPEN

Parâmetros da resposta

Parâmetro

Tipo

Descrição

request_id

String

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

code

String

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

message

String

Mensagem de erro. Retorna null em caso de sucesso.

success

Boolean

Indica se a chamada foi bem-sucedida. Exemplo: true

output

Object

Dados da operação. Retorna null para este endpoint.

Exemplos de requisição

Exemplo 1: Autorização por modelo
curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{
        "models": [
            {"model": "qwen-plus", "inference": true, "fine_tune": true, "deploy": false},
            {"model": "qwen3-max", "inference": true}
        ]
    }'
Exemplo 2: Autorizar todos
curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{"access_all_entities": "OPEN"}'

Exemplo de resposta

Exemplo de sucesso
{
    "code": null,
    "message": null,
    "success": true,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}
Exemplo de falha
{
    "code": "InvalidParameter",
    "message": "Model qwen-xxx is not authorized for Inference",
    "success": false,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

Códigos de erro

Em caso de falha na chamada, o sistema retorna uma mensagem de erro. Para obter mais informações sobre códigos de erro e soluções, consulte Error messages.
Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
API em tempo real
Incorporação de Texto
Produção de Modelos