Todos os produtos
Search
Central de documentação

Alibaba Cloud Model Studio:Gerar uma chave de API temporária

Última atualização: Oct 29, 2026

Para chamar serviços de modelo em ambientes não confiáveis, como navegadores e aplicativos móveis, use um serviço de backend seguro para gerar chaves de API temporárias. Essa prática evita a exposição da sua chave de API permanente.

ImportanteUma chave de API temporária herda todas as permissões da chave de API usada na criação, incluindo restrições de acesso a modelos ou bases de conhecimento específicos.

Pré-requisitos

Obtenha uma chave de API permanente na página Key Management (Singapore), Key Management (Virginia), Key Management (Beijing) ou Key Management (China (Hong Kong)). Em seguida, defina a chave como a variável de ambiente DASHSCOPE_API_KEY. Para mais informações, consulte Configurar uma chave de API como variável de ambiente.

Exemplo de solicitação

Por padrão, a chave de API temporária é válida por 60 segundos. Defina um tempo de vida (TTL) personalizado entre 1 e 1.800 segundos com o parâmetro expire_in_seconds.

As chaves de API variam conforme a região.

O exemplo a seguir usa o endpoint da região de Singapura. Substitua WorkspaceId pelo seu ID do workspace real. Para a região de Pequim, substitua a URL por: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800

# This is the Singapore region URL. Replace WorkspaceId with your actual workspace ID. URLs differ by region.
curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"

Exemplo de resposta

Exemplo de resposta bem-sucedida

{
    "token":"st-****",
    "expires_at":1744080369
}

Parâmetros de resposta

Parâmetro

Tipo

Descrição

Exemplo

token

String

Chave de API temporária gerada.

st-****

expires_at

Number

Tempo de expiração como timestamp UNIX, em segundos.

1744080369

Exemplo de resposta de erro

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"902fee3b-f7f0-9a8c-96a1-6b4ea25af114"
}

Parâmetros de resposta

Parâmetro

Tipo

Descrição

Exemplo

code

String

Código de erro. Para causas e soluções, consulte Códigos de erro.

InvalidApiKey: A chave de API é inválida.

message

String

Mensagem de erro.

Invalid API-key provided.

request_id

String

ID da solicitação.

902fee3b-f7f0-9a8c-96a1-6b4ea25af114

Perguntas frequentes

P: Posso excluir manualmente uma chave de API temporária?

R: Não. As chaves de API temporárias têm ciclo de vida fixo e expiram automaticamente. Não é possível excluí-las antes da expiração.