Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

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.

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

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

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

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

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

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