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.
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://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800
Exemplo de resposta
- Exemplo de resposta bem-sucedida
- Exemplo de resposta de erro
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 |