Visão geral

#chaves de API

Criar e gerenciar chaves de API

Visão geral

Cada solicitação de API para QwenCloud requer uma chave de API para autenticação. As chaves de API fornece gerenciamento centralizado de todas as suas credenciais de acesso, incluindo chaves de API pré-pagas e chaves de API Token Plan.

• Chaves de API pré-pagas: cada chave pertence a um espaço de trabalho e herda o acesso ao modelo do espaço de trabalho e limites de taxa.
• Chaves de API do Token Plan: exibe as credenciais de acesso do assinante para chamadas de API de modelo. A atribuição de assentos e o gerenciamento de membros são feitos no portal de gerenciamento do Token Plan.

Para obter um guia rápido sobre como obter sua primeira chave de API, consulte Obter uma chave de API.

Crie uma chave de API

Selecione um espaço de trabalho

Vá para [Chaves de API](https://home.qwencloud.com/api-keys) página. Use o alternador de espaço de trabalho na parte inferior da barra lateral para selecionar o espaço de trabalho onde você want para criar a chave.

Crie a chave.

Clique em **Criar chave de API**. Insira uma descrição para ajudá-lo a identificar a chave posteriormente (como "Chave de API de produção para o aplicativo principal") e clique em **Gerar chave**.

Copy the key

Copie a chave de API imediatamente — **ela é mostrada apenas uma vez**. Depois de fechar a caixa de diálogo, você poderá ver apenas uma versão mascarada da chave.

Cada espaço de trabalho suporta até 20 chaves de API.

Gerenciar chaves de API pré-pagas

Na seção Pague conforme o uso das Chaves de API, você pode:

• Pesquisar: Encontre chaves por descrição.
• Editar: Clique em Editar para atualizar a descrição da chave.
• Excluir: Clique em Excluir para revogar permanentemente a chave. Esta ação não pode ser desfeita — todas as solicitações que usam esta chave falharão imediatamente.
• Ativar/Desativar: alterne a chave de status para ativar ou desativar uma chave de API. As chaves desativadas rejeitam todas as solicitações; reativar restaura o acesso imediatamente.
• Ver custo: clique em Ver custo para ver o detalhamento dos custos de uma chave de API específica.

A tabela de chaves de API mostra o ID, Chave de API (mascarada), Descrição, Criada, Custo, Status de cada chave e Ações disponíveis.

Gerenciar chaves de API do Token Plan

Na seção Plano de token das Chaves de API, você pode visualizar suas credenciais do Token Plan e URLs base (compatível com OpenAI, compatível com Anthropic). Alterne entre as guias Individual e Equipe para visualizar as chaves de API correspondentes. A tabela mostra Chave de API (mascarada), Status da chave de API, Plano, Dias restantes e Ações (Redefinir, gerenciar plano).

• Redefinir: gere novamente a chave de API. A chave antiga é invalidada imediatamente.

• Gerenciar plano: Navegue até a página de gerenciamento do Token Plan para visualizar detalhes e uso da assinatura. Para atribuição de licenças da edição Team e gerenciamento de membros, use o portal de gerenciamento do Token Plan.

  O gerenciamento completo do Token Plan (atribuição de assentos, login SSO, gerenciamento de membros) está disponível no portal de gerenciamento do Token Plan. Consulte Gerenciamento de equipe para obter detalhes.

Chaves de API e espaços de trabalho

As chaves de API têm como escopo o espaço de trabalho onde são criadas:

• As chaves no espaço de trabalho padrão podem chamar todos os modelos disponíveis com limites de taxa no nível da conta.
• As chaves em um subespaço de trabalho só podem chamar modelos que foram concedidos a esse espaço de trabalho, com os limites de taxa configurados para esse espaço de trabalho.

Para gerenciar chaves de API para um espaço de trabalho diferente, alterne para ele usando o alternador de espaço de trabalho na parte inferior da barra lateral.

Chaves de API e faturamento

As chaves de API pré-pagas e as chaves de API do Token Plan devem ser usadas com seus respectivos endpoints. Não os misture.

As chamadas de API por meio de endpoints DashScope usam faturamento pré-pago e não consumirão sua cota de assinatura do Token Plan.

Melhores práticas de segurança

• Armazene chaves com segurança: use variáveis de ambiente ou um gerenciador de segredos. Nunca codifique chaves de API no código-fonte.
• Não exponha chaves do lado do cliente: as chaves de API só devem ser usadas em código do lado do servidor. Nunca os inclua em aplicativos front-end, aplicativos móveis ou código do navegador.
• Gire chaves regularmente: exclua chaves comprometidas ou não utilizadas e crie novas.
• Use chaves separadas por ambiente: Crie chaves (ou espaços de trabalho) diferentes para desenvolvimento, teste e produção.