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
WorkspaceIdpelo 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.