Perguntas frequentes sobre a API de LLM
Respostas práticas sobre configuração, roteamento regional, cobrança, resolução de problemas e suporte seguro. A disponibilidade atual dos modelos e os preços estão na página de preços.
Primeiros passos e entrega
Compre ou recarregue o acesso e depois confirme a entrega e o saldo disponível.
Como compro uma chave de API?
Abra a página de acesso, escolha um pacote, informe o e-mail de entrega e conclua o pagamento. As novas credenciais são entregues conforme as instruções do checkout; verifique também a pasta de spam.
Como recarrego uma chave de API existente?
Use a página de recarga e informe com cuidado a chave existente. Nunca cole uma chave completa em um chamado público, conversa em grupo, captura de tela ou documento compartilhado.
Paguei, mas não recebi a chave. O que devo fazer?
Verifique o status do pagamento, se o e-mail de entrega foi digitado corretamente, a caixa de entrada e a pasta de spam. Se ela ainda não chegar após uma breve espera, fale com o suporte em privado e informe o número do pedido e o horário do pagamento.
Onde posso consultar o saldo e o uso?
Use o portal oficial de cota vinculado neste site. Informe a chave somente nessa página oficial e nunca envie a credencial completa ao suporte.
Os créditos comprados expiram?
Atualmente, os créditos pré-pagos padrão permanecem disponíveis até serem usados. Se uma campanha, contrato ou plano personalizado tiver condições diferentes, prevalecem a página de checkout ou o acordo assinado.
Endpoints regionais e formatos de API
Escolha pela região de implantação e use o protocolo exigido pelo seu cliente ou SDK.
Qual Base URL regional devo usar?
Use https://gpt-agent.cc/v1 para a América do Norte e a América do Sul, https://eu.gpt-agent.cc/v1 para a Europa e a África, https://hk.gpt-agent.cc/v1 para o Sudeste Asiático, Hong Kong, Macau, Taiwan, Japão, Coreia, Austrália e Nova Zelândia, e https://api.llm-token.cn/v1 para a China continental.
Qual é a diferença entre uma Base URL e um endpoint completo?
Uma Base URL termina em /v1. Um endpoint completo acrescenta /chat/completions, /responses ou /messages. Siga o rótulo do campo no seu cliente e não acrescente o mesmo caminho duas vezes.
Quais formatos de API são compatíveis?
Estão disponíveis formatos compatíveis com Chat Completions, Responses e Messages. Selecione o formato esperado pela sua biblioteca, cliente ou fluxo de trabalho de agente.
Onde devo inserir a chave de API?
Use o campo API Key, Token ou Authorization. As solicitações HTTP diretas normalmente enviam Authorization: Bearer YOUR_API_KEY. Remova aspas, texto de exemplo e espaços inseridos por engano.
Onde encontro o ID exato do modelo?
Copie-o do catálogo de modelos atualizado ou da página de preços. Os nomes exibidos podem ser diferentes dos IDs usados nas solicitações; portanto, preserve exatamente maiúsculas e minúsculas, hífens e sufixos de versão.
Modelos, multimodalidade e ferramentas de desenvolvimento
As versões dos modelos mudam ao longo do tempo; use o catálogo atualizado como a fonte de referência vigente.
Quais famílias de modelos estão disponíveis?
O catálogo abrange as principais famílias GPT, Claude, Grok, DeepSeek, Qwen, Doubao, Kimi, GLM, MiniMax, Hunyuan, StepFun, MiMo e LongCat. Consulte a página de preços para ver as versões, capacidades e tarifas atuais.
Como escolher um modelo para programação, raciocínio, contexto longo ou processamento em lote?
Comece pela capacidade necessária e depois compare qualidade, latência, preço, tamanho do contexto e suporte a ferramentas. Teste a mesma instrução curta em dois ou três candidatos antes de direcionar o tráfego de produção.
A geração de imagens e as entradas multimodais são compatíveis?
Sim, nos modelos marcados com essas capacidades no catálogo atualizado. Confirme se o modelo escolhido aceita URLs de imagens, entrada Base64 ou gera imagens e siga o formato de solicitação específico dele.
Quais clientes e ferramentas de agentes posso conectar?
As configurações comuns incluem Codex CLI, Claude Code, OpenCode, OpenClaw, Cursor, Cline, Roo Code, Kilo Code, Windsurf, Cherry Studio, OpenWebUI, Dify, n8n, LangChain e LM Studio. Consulte o tutorial para saber os nomes exatos dos campos.
O que fazer se um modelo for renomeado, ficar temporariamente indisponível ou for removido?
Consulte primeiro o catálogo atualizado e os avisos de serviço. Se apenas um modelo falhar, mude temporariamente para outro comparável; se vários modelos falharem, considere um possível problema de roteamento ou manutenção.
Cobrança, cota e contas empresariais
As cobranças seguem as regras atuais dos modelos e o uso real; preços promocionais não são permanentes.
Como os preços são calculados?
Os créditos são pré-pagos e descontados pela tarifa atual de cada modelo, incluindo tokens de entrada e saída, multiplicadores ou tarifas por tarefa, quando aplicável. Consulte a página de preços antes da compra ou do uso em produção.
O que afeta o custo de tokens e recursos multimodais?
Históricos de conversa longos, respostas extensas, novas tentativas automáticas, ciclos de ferramentas de agentes, imagens e comportamento do cache podem alterar o uso. Mantenha as instruções e o contexto retido tão pequenos quanto a tarefa permitir.
Por que foram usados mais créditos do que o esperado?
Verifique se há histórico repetido, limites de saída altos, solicitações paralelas, novas tentativas do SDK ou ciclos de agentes. Compare o período do portal de cota com os logs do aplicativo sem expor a chave de API completa.
Vocês oferecem notas fiscais, processos de compras ou planos de alto volume?
As equipes podem falar com o suporte sobre volume, simultaneidade, compras, faturamento e necessidades de atendimento. Qualquer preço personalizado ou compromisso de serviço deve ser confirmado em privado no acordo aplicável.
Resolução de erros comuns
Guarde a mensagem de erro exata, o modelo e o horário antes de alterar várias configurações ao mesmo tempo.
Como corrigir erros de autenticação 401 ou 403?
Verifique se a chave está completa, não contém espaços, está no campo correto e é usada com uma das Base URLs deste serviço. Se houver possibilidade de exposição, pare de usá-la e substitua-a.
Como corrigir 404 ou “model not found”?
Verifique o ID exato do modelo e o caminho do endpoint. As causas comuns são usar um nome de exibição, duplicar /v1 ou enviar um payload de Responses ou Messages para um caminho de Chat Completions.
O que significa 429 ou limite de taxa?
Primeiro, verifique o crédito restante; depois, reduza a simultaneidade e a frequência das novas tentativas. Se o saldo for suficiente e o erro 429 continuar, guarde o modelo, o horário e uma captura do erro para o suporte.
O que fazer em caso de tempo limite ou erro de conexão de rede?
Teste o endpoint mais próximo da região de implantação, reduza o contexto e a saída e envie uma solicitação mínima. Se apenas um cliente falhar, verifique as configurações de proxy, certificado e tempo limite dele.
O que fazer em caso de 500, 502 ou Bad Gateway?
Tente novamente uma vez após uma breve pausa e teste outro modelo. Falhas em apenas um modelo geralmente apontam para a rota dele; falhas em vários modelos podem indicar um problema de roteamento compartilhado ou manutenção.
Como saber se um modelo ou toda a rota está falhando?
Envie a mesma solicitação mínima com a mesma chave e Base URL, alterando apenas o ID do modelo. Uma única falha sugere uma rota de modelo; várias falhas justificam encaminhar o caso ao suporte.
Segurança, reembolsos e suporte
Nunca publique credenciais completas, detalhes do pedido ou informações de identidade durante a resolução de problemas.
O que fazer se uma chave de API for exposta?
Exclua ou remova a mensagem exposta, pare de usar a chave e fale com o suporte para solicitar uma substituição ou avaliação de risco. Nas capturas de tela, oculte tudo, exceto alguns caracteres no início e no fim.
O suporte precisa da minha chave de API completa?
Não. Para a resolução pública de problemas, bastam o nome do modelo e uma captura do erro. A verificação de conta que envolva credenciais deve usar um canal de suporte privado e seguro.
Quais informações devo fornecer ao relatar um problema?
Forneça no máximo dois itens: (1) o nome do modelo e (2) uma captura do erro que inclua o horário ou o ID da solicitação, quando disponível. Nunca inclua a chave completa, senha, cartão de pagamento ou dados de identidade não ocultados.
Como consultar o status de manutenção e tentar novamente com segurança?
Consulte primeiro os avisos de serviço. Após a recuperação, envie uma única solicitação mínima em vez de ativar tentativas ilimitadas. Se ainda falhar, informe o modelo e envie a captura do erro mais recente.
Posso solicitar um reembolso ou uma análise do uso?
Reembolsos e contestações de uso seguem a política de reembolso e o status real do pedido. Interrompa novas chamadas e depois fale com o suporte em privado, informando o número do pedido e o horário relevante para análise.