Assinaturas de IA e chaves de API: guia passo a passo

Primeiro, o vocabulário

Nem sempre é necessária uma chave API para escrever baralhos e estudar. Ela é usada para gerar com sua própria conta de IA.

1. Assinatura, API e passe são diferentes

Uma API permite que um programa solicite trabalho à IA. A chave é uma credencial secreta que autoriza o uso da sua conta. Não é o código de login por e-mail, a chave de recuperação do Quiz Notebook ou a senha do chat.

Chat e API têm cobranças separadas mesmo com o mesmo e-mail. Você não precisa comprar uma assinatura de chat primeiro para usar uma API. Verifique a cobrança da conta API.

2. Escolha como trabalhar

Você pode trabalhar manualmente no seu chat de IA, revisar o resultado e importá-lo em um formato compatível. Esse fluxo é separado da conexão API.

No BYOK, você gerencia chave, modelo e custos. Esta conexão atende OpenAI e Anthropic diretamente. Credenciais de Gemini, NotebookLM, Azure e Bedrock não são compatíveis com estes campos.

Para encomendar um baralho pronto, não envie sua chave. O serviço prevê avaliação prévia, acordo de escopo, revisão e entrega. Consulte a página do serviço para saber se os pedidos pagos já estão abertos.

3. Antes de conectar

Prepare conta e faturamento API, ID de modelo disponível e uma pequena amostra que você tenha direito de transmitir. Em contas escolares ou empresariais, confirme a autorização para serviços externos.

O aplicativo exige login por e-mail, passe válido e dispositivo registrado e ativo nas configurações da conta. Criar uma chave não libera uma função ainda fechada.

Não insira chaves nesta página, em formulários ou e-mails. Use apenas o campo oculto do aplicativo oficial.

4. Criar uma chave OpenAI

1. Entre na OpenAI API Platform, separada das configurações da assinatura ChatGPT.
2. Crie ou selecione um projeto dedicado ao Quiz Notebook na sua organização para separar uso e revogação.
3. Confira API Billing, pagamento e créditos. Desative Auto-reload e salve se não quiser compras automáticas de créditos.
4. Em API Keys do projeto, crie uma chave secreta com nome reconhecível e guarde-a em um gerenciador de senhas seguro.
5. Conceda apenas as permissões necessárias. A conexão precisa criar solicitações Responses API; Read Only não basta. Não use chave de administrador.
6. Consulte o ID API exato do modelo na documentação e confirme o acesso do projeto. O nome do plano ou a etiqueta do chat não é o ID.

Se perder o segredo, crie uma chave nova e revogue a antiga. Cobrança e permissões de projeto e modelo também precisam estar válidas.

5. Criar uma chave Claude / Anthropic

1. Entre no Claude Console, separado do Claude Pro ou Max.
2. Escolha organização e workspace, configure API Billing e confira controles de recarga e gasto disponíveis.
3. Crie uma chave de inferência em API Keys. Use uma chave de um único workspace, não uma de administrador nem credenciais de outra nuvem.
4. Confira nome, permissões e validade; guarde o segredo com segurança e lembre qual workspace acompanhar.
5. Consulte um ID de modelo disponível na documentação e selecione Anthropic no Quiz Notebook.

A assinatura paga do Claude não substitui o saldo ou faturamento API do Console.

6. Conectar no Quiz Notebook

1. Entre no aplicativo oficial e confirme passe e dispositivo ativo nas configurações.
2. Escolha um baralho. Comece com uma ou duas perguntas e respostas curtas de sua autoria.
3. Abra ‘내 API로 AI 후보 만들기’ (Criar candidatos com minha API), abaixo do baralho. O campo não fica nas configurações da conta.
4. Escolha OpenAI ou Anthropic, informe o ID exato do modelo e cole a chave em ‘본인 API 키’, sem espaços ou quebras de linha extras.
5. Leia e aceite o aviso de envio e custo separado. São enviados os textos das perguntas e respostas; imagens e anexos não são lidos automaticamente.
6. Clique uma vez em ‘별도 후보 덱 만들기’ (Criar baralho candidato separado) e aguarde. Digitar a chave não inicia uma chamada.
7. Revise o novo baralho com a fonte: exatidão, explicações e direitos. Não há fusão automática com o original nem revisão pelo serviço de produção encomendada.
8. Confira Usage e Billing do fornecedor antes de aumentar o volume.

7. Para onde vão chave e materiais?

O caminho é navegador → servidor Quiz Notebook → fornecedor de IA escolhido → navegador. O servidor usa temporariamente a chave em memória; não é uma conexão exclusivamente direta com o fornecedor.

A implementação atual não persiste a chave no banco da conta ou no armazenamento permanente do navegador, nem registra intencionalmente o corpo das solicitações. Recarregar ou sair apaga a chave da tela. Isso não garante retenção zero pelo fornecedor de IA.

Sincronização privada criptografada e envio de texto legível à IA são operações diferentes. Retire nomes, contatos e registros de alunos desnecessários; confirme os direitos de uso e transmissão.

8. Controlar os custos

O custo depende de modelo, tokens de entrada e saída e número de chamadas. Tokens não equivalem a caracteres. Fontes longas, respostas extensas e repetições podem custar mais.

Estime tokens de entrada × tarifa de entrada + tokens de saída × tarifa de saída nas unidades da tabela oficial. Confira cache, raciocínio, impostos e câmbio. O passe web é separado.

Alertas OpenAI não bloqueiam chamadas. Em Limits, confira e salve ‘Enforce a hard limit’ se quiser bloqueio por limite. A aplicação pode atrasar e permitir pequeno excesso. Limites de recarga automática controlam compra de créditos, não o gasto API.

No Claude Console, confira consumo da organização/workspace e faturamento. Comece com pouco e verifique alertas, limites e recargas separadamente.

9. Desconectar, substituir ou cancelar

1. ‘입력한 API 키 지우기’ (Apagar a chave inserida) apaga chave e consentimento da tela. Não cancela uma solicitação em andamento.
2. Para impedir uso futuro em outros lugares, revogue ou exclua a chave em API Keys do fornecedor. Esvaziar o campo não a revoga.
3. Use uma nova chave para reconectar. Se suspeitar de exposição, revogue a antiga primeiro e confira Usage e Billing.
4. Gerencie assinatura do chat, recargas API e passe Quiz Notebook separadamente. Cancelar um não cancela os demais.

Ao pedir suporte, informe horário, fornecedor, ID do modelo e captura sem segredos. Nunca envie a chave completa.

10. Resolver problemas

Botão desativado: confira disponibilidade, login, passe, consentimento e solicitação em andamento. Para erro de dispositivo, confira registro e ativação.

Erro de chave ou modelo: confira fornecedor, espaços, validade, revogação, permissões e ID exato. Pagar pelo chat não adiciona saldo API.

Quota ou congestionamento: confira saldo, limites de velocidade e gasto. Créditos novos podem demorar a aparecer. Não compre repetidamente antes de entender o erro.

Tempo esgotado ou formato inválido: não há nova tentativa automática. O fornecedor pode ter processado trabalho cobrável. Confira Usage antes de tentar novamente com menos texto.

Conteúdo incorreto: conectar com sucesso não valida respostas. Corrija ou descarte candidatos sem fundamento.

11. Compartilhamento, direitos e organizações

Não compartilhe chaves com amigos ou alunos: as chamadas podem ser cobradas na mesma conta. Implantações institucionais exigem acordos sobre titularidade, permissões e custos. Não anexe chaves ou dados reais de alunos a consultas.

Recomendamos uso para estudo pessoal. Verifique direitos antes de enviar livros ou notas de terceiros a uma IA externa, publicar ou vender resultados. A privacidade não resolve automaticamente questões de direitos autorais.

A chave API autoriza chamadas de IA; o código de e-mail autentica o login; a chave de recuperação abre baralhos criptografados. Não são intercambiáveis.

12. Perguntas frequentes

Inserir a chave gera cobrança? A entrada sozinha não envia solicitações. A geração pode ser cobrada quando o fornecedor a processa.

O resultado é igual ao chat? Modelos, instruções, configurações e ferramentas podem variar. Busca e anexos do chat não são incluídos automaticamente.

Preciso inserir de novo? Sim, após recarregar ou sair, pois a chave não fica salva permanentemente. Permanecer conectado é outra coisa.

O mesmo menu existe nos apps instalados? Este guia trata da web. Consulte os manuais das versões para tablet e desktop para seus fluxos e disponibilidade.