Nota do autor: este artigo é para iniciantes que só usaram as versões web de ferramentas de IA. A checklist tem 6 itens para ajudar você a avaliar se um serviço proxy de API é confiável em relação a canais de acesso, cobrança, logs, segurança da chave API, reembolso, nota fiscal e suporte.
Se você só conversou com o ChatGPT ou o Claude pelo navegador, ao tentar conectar um Modelo de Linguagem Grande ao seu próprio script, planilha ou pequena ferramenta, vai encontrar tanto fornecedores oficiais quanto vários serviços proxy de API. Um serviço proxy de API para IA é uma plataforma terceirizada que encaminha suas requisições para Modelos de Linguagem Grande de diferentes fornecedores. Com uma única conta, você pode usar vários modelos, e adicionar créditos também costuma ser mais simples. O problema é que as plataformas variam muito: quem está começando geralmente vê apenas o “preço baixo” e não percebe as diferenças nos canais de acesso, na cobrança e no suporte. Neste artigo, você encontra uma checklist de 6 itens para conferir um por um e identificar os principais riscos antes de adicionar créditos.
Este artigo não é uma avaliação de nenhuma plataforma nem um endosso a qualquer serviço de terceiros. Todos os termos e números citados vêm de condições dos fornecedores de modelos e de documentação oficial das plataformas disponíveis para consulta em 27 de outubro de 2026. Ao mencionar recursos de uma plataforma, indicamos sempre que eles constam na documentação oficial. Vamos usar a documentação pública da APIYI (apiyi.com) como exemplo para mostrar “quais informações uma plataforma deve apresentar”. Você pode aplicar os mesmos critérios a qualquer outra.
O que você vai aprender: ao final, saberá quais são os 6 pontos a observar em um serviço proxy de API para IA, como verificar cada um deles e o que fazer quando algum não atender aos critérios. Também ficará claro quais riscos cabem exclusivamente a você.
Por que vale a pena dedicar dez minutos à escolha de um serviço proxy de API
Muita gente acha que escolher uma plataforma é só “usar a mais barata”. Mas a API de um Modelo de Linguagem Grande funciona de forma diferente de uma assinatura de serviço na web: a cobrança é por uso, e o acesso utiliza uma chave chamada token. Nesse contexto, o token é a chave API, equivalente à “senha de saque” da sua conta: quem a tiver pode gastar seu dinheiro. Escolher a plataforma errada pode trazer quatro problemas comuns: o modelo ser trocado por uma versão mais barata, a cobrança ficar difícil de entender, a plataforma interromper o serviço de repente e seu saldo desaparecer, ou a chave vazar e ser usada por outra pessoa.
As regras básicas do setor ajudam a entender por que vale desconfiar de preços “baixos demais”. A seção 3.1 do OpenAI Services Agreement, em vigor desde 1º de janeiro de 2026, determina que não se pode compartilhar credenciais de conta entre vários usuários nem revender ou alugar o acesso à conta. A lista de proibições da seção 3.3 também inclui comprar, vender ou transferir chaves API a terceiros. Da mesma forma, a seção D.4 dos Anthropic Commercial Terms, na versão de 17 de junho de 2025, estabelece que os serviços não podem ser revendidos sem autorização explícita. A página de países e regiões aceitos pela OpenAI também alerta que acessar ou oferecer serviços fora da lista pode levar ao bloqueio ou à suspensão da conta. A China continental não está nessa lista.
Por outro lado, as cláusulas de cobrança do contrato da OpenAI mencionam repetidamente “Customer’s reseller” (revendedor do cliente), o que mostra que existem revendedores autorizados. Descontos legítimos vêm de relações de autorização, compras em volume ou promoções oficiais — não da divisão e revenda do acesso à conta de outra pessoa. Por isso, o ponto principal na escolha não é “a plataforma é um proxy?”, mas sim “ela está disposta a apresentar informações que possam ser verificadas?”.
Pontos principais do checklist de 6 itens para serviços proxy de API de IA
A tabela abaixo é o esqueleto deste artigo. Cada item será detalhado a seguir em três partes: “o que observar / como verificar / o que fazer se não passar”.
| Item | O que observar | Como verificar | Sinais de alerta |
|---|---|---|---|
| 1. Tipo de canal | Se usa um canal oficial, uma API oficial por engenharia reversa ou uma conta compartilhada | Pergunte ao suporte sobre o canal principal e o alternativo e veja se a documentação distingue os nomes dos modelos em cada um | Só diz que é “igualzinho ao site oficial”, mas não sabe explicar o canal |
| 2. Critério de cobrança | Se a cobrança é por consumo ou por chamada e se os tipos de token correspondem ao cobrado | Pegue um registro e calcule a cobrança por conta própria | Todos os modelos têm uma única faixa de preço, e a cobrança não fecha |
| 3. Conferência de logs | Se é possível consultar modelo, tokens e valor de cada chamada | Use o Request ID para localizar uma chamada nos logs | Só mostra a mudança no saldo, sem detalhamento |
| 4. Limites de chave e gastos | Se é possível definir limite de gastos, lista de permissões e data de expiração para cada chave | Crie uma chave com limite e faça um teste | Não é possível limitar uma chave nem desativá-la individualmente |
| 5. Pagamento, empresa e nota fiscal | Regras de reembolso, empresa responsável e emissão de nota fiscal | Procure os detalhes nos termos de serviço e na documentação de pagamento | Não é possível identificar a empresa, e os dados de pagamento são fornecidos pelo “suporte por mensagem privada” |
| 6. Estabilidade e suporte | Se há comunicados de status e regras de compensação | Consulte a página de comunicados e o SLA | Promete “nunca sair do ar”, mas, quando há um problema, ninguém confere os logs |
Como avaliar se o preço de um serviço proxy de API é razoável
Antes de conferir cada item, vale entender de onde podem vir os descontos. A Anthropic oferece 50% de desconto sobre entradas e saídas na Batch API (API em lote). Já no Prompt Caching (cache de comandos), quando há acerto de cache, a página oficial de preços informa que a entrada do Claude Sonnet 5.5 custa US$ 2/MTok e a leitura do cache custa US$ 0,10/MTok, cerca de 5% do preço de entrada. A gravação no cache, porém, é cobrada separadamente: 1,25 vez o preço de entrada para o cache de 5 minutos ou 2 vezes para o de 1 hora. Em resumo, quando o mesmo prefixo de comando é enviado repetidamente, o provedor pode cobrar menos.
Tomando a APIYI como exemplo, a própria plataforma informa que o custo total usando exclusivamente canais oficiais fica em torno de 85% do preço de tabela. Com os bônus de recarga, o valor efetivo fica aproximadamente entre 79% e 86%. Segundo a APIYI, a economia vem da alta taxa de acertos de cache e dos bônus de recarga, não de uma redução na capacidade ou da substituição do modelo. A regra para avaliar uma oferta é simples: se o preço cair para 20% ou 30% do valor oficial, pergunte primeiro “como esse preço foi calculado e por qual canal a chamada passa?” antes de decidir se vale a pena testar.
O diagrama foi elaborado com base nas explicações sobre canais e logs da documentação oficial da APIYI, em apiyi.com. Você pode usar os mesmos pontos para comparar outras plataformas.
Checklist de 6 itens para avaliar um serviço proxy de API para IA
Item 1: O tipo de canal do serviço proxy de API para IA
O que observar: primeiro, entenda os tipos de canal. No proxy oficial, a plataforma encaminha sua solicitação diretamente para uma interface oficial, como a API da OpenAI ou o acesso oficial a modelos oferecido por um provedor de nuvem. No canal de engenharia reversa, a plataforma usa uma conexão baseada na engenharia reversa do site ou aplicativo oficial, como se estivesse simulando uma pessoa usando a página. Há também a conta compartilhada, em que várias pessoas usam a mesma conta oficial — prática expressamente proibida pelos termos dos fornecedores mencionados anteriormente.
No caso da APIYI, a documentação oficial informa que a plataforma atua como proxy oficial totalmente transparente: o Claude usa, por padrão, o acesso oficial pelo AWS Bedrock e, como alternativa, conecta-se diretamente com uma chave oficial da Anthropic. A plataforma também afirma que não redireciona para modelos mais baratos, não reduz a capacidade dos modelos, não os substitui sem aviso e não armazena o conteúdo das conversas. A mesma documentação também apresenta modelos que usam canais de engenharia reversa e explica as diferenças em um documento comparativo separado. A tabela abaixo foi organizada com base nesse documento.
| Critério | Proxy oficial (exemplo: gpt-image-2.5-flare / sunburst) | Engenharia reversa (exemplo: gpt-image-2-all / série -vip) |
|---|---|---|
| Canal de origem | Interface oficial OpenAI Images API | -all usa a interface web do ChatGPT; os três modelos -vip usam o Adobe Firefly |
| Cobrança | Conforme o uso real de tokens | Preço fixo por geração: $0.025/imagem para os dois modelos -all e $0.03/imagem para os três modelos -vip |
| Parâmetros oficiais | Compatível com quality, mask, tamanhos arbitrários e n | Não suporta n nem segue a semântica oficial do parâmetro quality |
| Velocidade e estabilidade | Acompanham a interface oficial | Variam conforme o serviço de origem; -all leva cerca de 90 segundos para gerar uma imagem |
| Para quem é indicado | Projetos que precisam de controle dos parâmetros e resultados reproduzíveis | Situações em que as diferenças de parâmetros são aceitáveis e o foco está em preço baixo e geração rápida |
Como verificar: primeiro, pergunte diretamente ao suporte: “Qual canal esse modelo usa e qual é o canal alternativo?”. Depois, confira se a documentação apresenta o mesmo modelo com nomes separados para proxy oficial e engenharia reversa. Por fim, se escolher um canal de engenharia reversa, leve em conta que os parâmetros podem ser diferentes e que a velocidade pode variar conforme o serviço de origem.
O que fazer se não passar no teste: se a plataforma só disser que é “igualzinha à oficial”, mas não souber explicar o canal, ou se todos os modelos tiverem apenas uma faixa de preço, não adicione créditos por enquanto. Escolher uma plataforma que documenta os canais dá bem menos trabalho do que tentar resolver problemas depois.
Item 2: Como a plataforma proxy de IA cobra (por consumo ou por chamada)
O que observar: primeiro, vale explicar o que é um token. É a menor unidade usada pelo modelo para processar texto e pode ser entendido, de forma aproximada, como um “bloco de texto”. Na cobrança por consumo, o valor depende da quantidade de tokens de entrada e de saída. Uma mesma plataforma pode oferecer os dois tipos de cobrança: acesso oficial por tokens efetivamente usados e acesso por engenharia reversa com preço fixo por chamada.
O tipo de credencial também precisa ser compatível com o modelo. A documentação oficial da APIYI informa que, para chamar modelos de imagem pelo acesso oficial, é necessário usar uma credencial do tipo “prioridade para cobrança por consumo”. Uma credencial com cobrança por chamada será rejeitada por incompatibilidade de cobrança. Também é importante entender a conversão de créditos: segundo a documentação, 500.000 créditos = US$ 1,00. A API de consulta de saldo e a API de gerenciamento de credenciais usam a mesma conversão.
Como conferir: pegue o registro de uma chamada real e calcule “tokens de entrada × preço unitário de entrada + tokens de saída × preço unitário de saída”. Depois, veja se o resultado corresponde ao valor cobrado. Consulte os preços unitários na lista de modelos da plataforma; não confie na memória nem em capturas de tela de conversas.
O que fazer se não passar na verificação: se o cálculo não bater com a cobrança e você não encontrar uma explicação razoável, como uso de cache ou cobrança por chamada, salve o registro e procure o suporte. Se a plataforma não conseguir esclarecer a diferença, não é recomendável adicionar mais saldo.
Item 3: Os logs do serviço proxy de API permitem conferir a cobrança?
O que verificar: os logs são seu único “livro-caixa”. A documentação oficial da APIYI informa que os logs do console registram os campos principais de cada chamada e, em caso de falha, também registram informações sobre o erro.
| Campo do log | O que mostra | Como usar |
|---|---|---|
| Horário da requisição | Horário preciso até o segundo | Compare com o horário de execução do seu programa |
| Modelo usado | Nome do modelo realmente invocado | Confira se é o mesmo modelo solicitado |
| Tokens de entrada / saída | Uso nessa chamada | Calcule a cobrança com base no preço unitário |
| Valor cobrado | Quanto foi descontado na chamada | Compare com a variação do saldo |
| Status da chamada | Sucesso ou falha | Veja se houve cobrança por uma chamada que falhou |
| Informações adicionais da falha | Tipo de erro, mensagem e parâmetros relacionados | Tire uma captura de tela ao abrir um chamado |
Também vale conferir a política de privacidade. Segundo a documentação, por padrão são registradas apenas as informações básicas necessárias para a cobrança, sem o conteúdo das entradas e saídas. Para ajudar a investigar um problema, um administrador pode ativar temporariamente logs detalhados. Eles podem conter comandos completos, mensagens de sistema, histórico de conversas, parâmetros de chamadas de função e respostas do modelo. Por isso, remova dados sensíveis antes de abrir um chamado. Os logs são mantidos durante o mês atual e os dois meses anteriores; no dia 5 de cada mês, os dados de meses completos mais antigos são apagados. Se precisar guardá-los, exporte-os.
Como conferir: depois da chamada, procure o Request ID, que geralmente está no cabeçalho da resposta, em x-request-id ou request-id. Com ele, você consegue localizar no log o modelo, o canal, o status e a cobrança daquela chamada. Atenção: o campo id no corpo da resposta de um modelo de texto pode ser um Completion ID, que não é necessariamente igual ao Request ID da plataforma.
E se não passar no teste? Se a plataforma mostrar apenas a variação do saldo, sem detalhar cada chamada, você não terá como comprovar que o modelo não foi trocado ou que não houve cobrança a mais. Nesse caso, é melhor desistir da plataforma.
Item 4: chaves e limites de gastos do serviço proxy de API
O que observar: o uso indevido de chaves vazadas é uma das perdas mais comuns para quem está começando. Uma boa plataforma deve permitir que você defina limites para cada chave. A documentação oficial da APIYI informa que a API de gerenciamento de tokens oferece três tipos de restrição: use remain_quota para definir o limite de crédito, models para criar uma lista de modelos permitidos (requisições a modelos fora da lista retornam 403 e não são cobradas) e expired_time para definir a data de expiração.
A documentação também traz algumas regras de gerenciamento: cada conta pode ter até 1.000 tokens, incluindo os desativados que ainda não foram excluídos. Ao definir status como 2, a chave é desativada imediatamente, mas seus registros e dados de uso são mantidos. Já a exclusão é irreversível.
Como verificar: siga esta sequência e confira os resultados.
- Crie uma chave para cada projeto, definindo o limite de crédito e a lista de modelos permitidos.
- Faça uma chamada usando um modelo fora da lista e confirme que ela foi recusada e não gerou cobrança.
- Simule uma troca de chave: crie uma nova chave → direcione as chamadas para ela → desative a chave antiga → confirme que ela não está mais recebendo chamadas antes de excluí-la.
- Ative os alertas de saldo. Segundo a documentação, o e-mail de alerta de saldo de US$ 30, que antes era enviado por padrão, foi desativado. Agora é preciso ativar as notificações em “Central pessoal → Configurações de notificação”. Há três canais disponíveis: e-mail, WeCom e Feishu. Você também pode usar a API de consulta de saldo para criar seus próprios alertas.
E se não passar na verificação?: se não for possível limitar os gastos de uma chave nem desativá-la individualmente, um vazamento pode acabar com todo o seu saldo. Nesse tipo de plataforma, mantenha apenas valores muito baixos ou simplesmente não a utilize.
Item 5: dinheiro, empresa responsável e notas fiscais do serviço proxy de API
O que observar: este é o principal ponto para avaliar o risco de o serviço desaparecer com seu dinheiro. Procure três informações: regras de reembolso, empresa responsável pela operação e capacidade de emitir notas fiscais. No caso da APIYI, por exemplo, a empresa responsável, MrrBase, LLC, aparece nos termos de serviço; as regras de reembolso e emissão de notas estão na tabela abaixo, conforme a documentação oficial.
| Item | O que diz a documentação oficial |
|---|---|
| Prazo para reembolso | Em até 30 dias após a recarga, é possível pedir o reembolso do saldo não utilizado, sem precisar justificar |
| Bônus | O valor do reembolso deve descontar os créditos recebidos em promoções |
| Taxa de reembolso | Sem taxa para WeChat e Alipay; taxa de 1% para transferência bancária empresarial, USDT, Wise, Mercury e PayPal |
| Nota fiscal já emitida | Para clientes da China continental, não há reembolso se a nota fiscal já tiver sido emitida |
| Tipos de nota fiscal | Notas fiscais comuns e especiais de IVA, com alíquota de 1%; a categoria padrão é “taxa de serviços de tecnologia da informação” |
| Outras formas de pagamento | Pagamentos via Stripe recebem uma Invoice; pagamentos em USDT não têm nota fiscal |
| Forma de cobrança | Todos os pagamentos são pré-pagos; por enquanto, não há linha de crédito nem faturamento mensal. Para transferências empresariais, recomenda-se um valor mínimo de 1.000 yuans por transação. O contrato pode ser providenciado depois, e o contrato-quadro precisa ser assinado apenas uma vez |
| Validade do saldo | A partir de 2 de agosto de 2026, o saldo da conta tem validade de 365 dias; após o vencimento, não há reembolso nem recuperação do saldo |
Como verificar: encontre o nome da empresa responsável nos termos de serviço e as regras de reembolso e emissão de notas na documentação de pagamento. Salve capturas de tela. Obtenha todos os dados de contas empresariais, endereços USDT e contas de recebimento apenas pelos canais oficiais de atendimento; não confie em contatos de “atendimento” indicados por terceiros.
E se não atender aos critérios? Se não conseguir identificar a empresa responsável, não houver regras de reembolso por escrito ou os dados de pagamento só forem fornecidos “por mensagem privada”, basta uma dessas situações para recomendar apenas um teste com valor baixo — ou simplesmente não usar o serviço. Em compras empresariais, confirme primeiro a capacidade de emitir notas fiscais antes de seguir com o processo.
Item 6: estabilidade e suporte pós-venda do serviço proxy de API
O que observar: comece deixando de lado a expectativa de que o serviço “nunca vai cair”. A documentação oficial da APIYI diz que não promete um SLA de 99,99%, com a justificativa de que “nem a OpenAI e a Claude conseguem garantir isso”. A documentação lista três garantias: grandes clientes de geração de imagens que gastam mais de US$ 10.000 por mês podem solicitar compensação por cobranças indevidas; perdas claramente causadas pela plataforma são compensadas com créditos após a verificação dos logs; e clientes empresariais podem definir no contrato os termos do SLA e o limite de indenização.
Como verificar: confira se a plataforma publica o status do serviço e avisos de incidentes (na APIYI, eles ficam na página “Atualizações em tempo real”). Depois, veja se as regras de compensação deixam claros seus limites. A documentação informa que fatores fora do controle da plataforma, como bloqueios pela moderação de conteúdo ou limites de requisições do provedor upstream, não dão direito à reposição de créditos. Alguns bloqueios de moderação do provedor upstream não são cobrados.
O que fazer se não passar no teste: quando houver um problema, salve o Request ID e a resposta completa antes de procurar o suporte para investigar o caso. Se a plataforma não publica avisos nem aceita conferir os logs, o suporte pós-venda basicamente depende da sorte. Nesse caso, tire-a da lista de provedores principais.
Primeiros passos com um serviço proxy de IA: faça a primeira chamada com pouco crédito
Depois de conferir a lista, não tenha pressa de adicionar muito crédito. A recomendação oficial é avançar por etapas: comece com um valor pequeno em um cenário real, confira os logs e as respostas e, se tudo estiver como esperado, aumente o uso aos poucos. A seguir, vamos usar a APIYI como exemplo, com uma interface compatível com a OpenAI — ou seja, que usa o mesmo formato de requisição da API oficial e funciona diretamente com muitas ferramentas existentes.
- Crie uma conta em apiyi.com. Segundo a documentação oficial de início rápido, a conta recebe $0,05 em crédito de teste após o cadastro, o suficiente para fazer a primeira chamada.
- No console, crie um token e configure o limite de crédito, a lista de modelos permitidos e a data de expiração. Copie a chave gerada e guarde-a apenas em uma variável de ambiente local.
- Na ferramenta ou no SDK que você usa, defina
https://api.apiyi.com/v1como base_url e sua chave como api_key. - Use
https://api.apiyi.com/v1/chat/completionscomo endereço da requisição e incluaAuthorization: Bearer YOUR_API_KEYno cabeçalho. - No corpo da requisição, informe
model— copie o nome de um modelo de texto da lista da plataforma — emessages, por exemplo:[{"role": "user", "content": "Olá"}]. - Ao receber a resposta, anote o
x-request-iddo cabeçalho e confira o nome do modelo, a quantidade de tokens e o valor cobrado nos logs do console. - Use alguns comandos fixos para fazer novas chamadas em horários diferentes. Salve as respostas e os logs juntos para servir de referência em comparações futuras.
🚀 Dica para começar: na primeira integração, use o crédito de teste da APIYI em apiyi.com para concluir os 7 passos acima antes de decidir se vai adicionar crédito. Consulte a lista de modelos da plataforma para verificar os modelos e preços, em vez de confiar em capturas de tela compartilhadas por terceiros.
Se você quiser usar um modelo recém-lançado pelo fornecedor e ele ainda não estiver na lista da plataforma, normalmente é porque o acesso ainda não foi liberado pelo fornecedor ou porque a plataforma ainda está ajustando os canais e a cobrança. A resposta da APIYI nesses casos é: vamos disponibilizar o modelo o mais rápido possível. Até lá, desconfie de qualquer canal que prometa “acesso antecipado”, mas não explique claramente como oferece esse acesso.
Quais riscos você assume ao escolher um serviço proxy de API para IA
Vamos começar com franqueza: um checklist pode reduzir os riscos, mas não eliminá-los. Como mostram os termos dos fornecedores citados anteriormente, canais não autorizados, compartilhamento de contas e conexões obtidas por engenharia reversa podem levar ao bloqueio da conta ou à interrupção do acesso pelo provedor original. Se isso acontecer, a plataforma pode deixar de funcionar de um dia para o outro. E a possibilidade de reembolso do seu saldo depende das regras da plataforma e da disposição dela em cumpri-las. Este artigo oferece apenas critérios de avaliação e não endossa nenhuma plataforma de terceiros.
Independentemente da plataforma escolhida, vale ter clareza sobre estes riscos:
- Risco de políticas do provedor original: os termos dos fornecedores e as regiões atendidas podem mudar a qualquer momento. Conexões obtidas por engenharia reversa são especialmente vulneráveis.
- Risco de conformidade de dados: antes de enviar dados sensíveis, como informações de clientes, contratos e código-fonte, a uma plataforma de terceiros, consulte as regras da sua organização.
- Risco de segurança da chave API: se uma chave vazar e for usada por terceiros, a plataforma geralmente só poderá ajudar a desativá-la. É difícil recuperar os valores já gastos.
- Risco de saldo pré-pago: o saldo pode ter prazo de validade, e os reembolsos podem estar sujeitos a prazos e taxas. Quanto maior a recarga, maior a exposição ao risco.
- Risco de expectativas sobre os resultados: conexões obtidas por engenharia reversa podem ter parâmetros diferentes dos oficiais e velocidade instável. Essas são características da própria conexão e, em geral, não são consideradas falhas da plataforma.
Para terminar, aqui está uma tabela com erros comuns de quem está começando. Vale conferi-la antes de cada recarga.
| Erro comum | Sinal típico | Como verificar | O que fazer |
|---|---|---|---|
| Olhar só o desconto, sem conferir o canal | O mesmo modelo custa muito menos na plataforma A do que na B | Veja se a documentação distingue o proxy da API oficial das conexões obtidas por engenharia reversa | Confirme o canal antes de comparar os preços |
| Achar que “gerar uma resposta” significa que o modelo não foi trocado | A resposta parece normal e você não verifica mais nada | Compare as respostas usando o mesmo comando | Confira se o nome do modelo nos logs corresponde ao valor cobrado |
| Compartilhar a chave API como se não fosse uma senha | A chave aparece em grupos de conversa, capturas de tela ou repositórios de código | Pesquise seus repositórios e históricos de conversa | Use uma chave com limite de gastos para cada projeto. Se vazar, desative-a antes de removê-la; não basta trocar a senha de acesso |
| Fazer uma recarga alta logo de cara | Você adiciona um valor alto de uma vez para receber mais bônus | Revise as regras de reembolso e a validade do saldo | Comece com um valor pequeno e teste em cenários reais antes de aumentar a recarga |
| Confiar em mensagens privadas de supostos atendentes | Alguém envia, sem solicitação, uma conta bancária empresarial ou um endereço USDT | Confira se a mensagem veio de um canal oficial | Obtenha os dados de pagamento apenas pelos canais oficiais de atendimento |
Perguntas frequentes e resumo sobre a escolha de um serviço proxy de API
Perguntas frequentes sobre serviços proxy de API
P1: Qual é a diferença entre um serviço proxy de API e a API oficial?
Com a API oficial, você contrata o fornecedor e paga diretamente a ele. Já o serviço proxy de API é uma plataforma de terceiros que conecta você a modelos de vários fornecedores com um único token. A vantagem é a facilidade de integração e a possibilidade de pagar menos; em troca, há mais uma parte em quem você precisa confiar. É por isso que existe esta lista de 6 itens.
P2: Para iniciantes, é melhor escolher um proxy oficial ou um canal de engenharia reversa?
Se você precisa controlar os parâmetros e obter resultados estáveis, priorize um proxy oficial. Se quer apenas experimentar gastando pouco e aceita diferenças nos parâmetros e variações de velocidade, um canal de engenharia reversa também pode servir como alternativa. O importante é conferir na documentação a qual categoria pertence o modelo que você vai usar. Não presuma que um canal é oficial só porque o nome parece ser.
P3: Como saber se um modelo foi substituído sem aviso ou teve seu desempenho reduzido?
O fato de o modelo retornar uma resposta não basta para saber. Uma forma prática é preparar alguns comandos fixos, enviá-los periodicamente e salvar as respostas. Confira também se o nome do modelo, o número de tokens e o valor cobrado nos logs correspondem ao preço unitário. Uma plataforma com campos de log incompletos já não atende ao item 3.
P4: O que fazer se um modelo recém-lançado pelo fornecedor oficial não estiver disponível na plataforma?
Primeiro, consulte a lista de modelos da plataforma, que é a referência para disponibilidade e preços. Se o modelo ainda não estiver disponível, usando a APIYI como exemplo, a orientação é: faremos o possível para disponibilizá-lo em breve; após o lançamento, ele poderá ser consultado na lista de modelos em apiyi.com. Não vale a pena recorrer a serviços que não explicam claramente a origem do acesso só para experimentar antes.
P5: O que preciso preparar para fazer um primeiro teste?
Basta uma conta, um token com limite de gastos configurado e uma ferramenta ou SDK compatível com OpenAI. Na APIYI, em apiyi.com, por exemplo, o cadastro inclui US$ 0,05 em créditos de teste. Siga os 7 passos da seção “Início rápido” deste artigo para fazer a primeira chamada e conferir os registros de cobrança.
P6: O que as empresas precisam observar na contratação?
Confirme principalmente três pontos: a empresa responsável pela operação, o tipo de nota fiscal e a alíquota de imposto, e como funcionam os reembolsos para valores já faturados. Consulte a página da plataforma para detalhes específicos, como alíquotas e valores recomendados por transação para pagamentos empresariais, e guarde capturas de tela. Obtenha os dados da conta de recebimento apenas pelos canais oficiais. Se for necessário estabelecer um SLA e um limite de indenização, inclua-os no contrato.
Principais pontos para escolher um serviço proxy de API para IA
- Escolha uma plataforma com informações verificáveis: mais importante do que saber se é um proxy é verificar se o canal, a empresa responsável, os logs e a política de reembolso estão claramente documentados.
- Questione preços baixos demais: os descontos oficiais divulgados costumam se concentrar em APIs de processamento em lote e cache de comandos. Se o preço for 70% ou 80% menor, pergunte de onde vem o desconto.
- O canal determina a experiência: o proxy pela API oficial mantém os parâmetros alinhados e cobra por uso; o acesso por engenharia reversa cobra por chamada e pode apresentar diferenças nos parâmetros e na velocidade.
- Os logs são seu registro de cobrança: use o Request ID para conferir o nome do modelo, a quantidade de tokens e o valor cobrado. Confira também o prazo de retenção e a anonimização dos dados.
- Defina limites para a chave: configure teto de gastos, lista de modelos permitidos e data de expiração. Em caso de vazamento, desative a chave antes de excluí-la.
- Comece com pouco e aumente depois: use o saldo de teste em cenários reais e só faça uma recarga depois de confirmar que o serviço atende às suas expectativas.
Resumo: checklist de 6 itens para escolher um serviço proxy de API para IA
Para escolher um serviço proxy de API para IA, o essencial é esclarecer estas 6 questões:
- Canal: o serviço usa a API oficial, acesso por engenharia reversa ou conta compartilhada? Isso está documentado?
- Cobrança e logs: você consegue calcular o valor cobrado a partir de um registro de log?
- Chave e gastos: é possível definir limite de gastos, restringir modelos, configurar uma data de expiração e desativar cada chave separadamente?
- Dinheiro e empresa responsável: você consegue encontrar os termos originais sobre reembolso, emissão de nota fiscal, validade do saldo e empresa responsável pela operação?
- Suporte: há comunicados públicos? Os critérios para compensação estão claros?
Os termos dos fornecedores fazem com que exista o risco de interrupção do serviço ou bloqueio de contas, e essa parte do risco fica por sua conta. O checklist ajuda a evitar plataformas que nem sequer divulgam informações básicas. Se quiser um exemplo para comparar, acesse a documentação oficial da APIYI em apiyi.com, confira cada um dos 6 itens deste artigo e use o saldo de teste para fazer sua primeira chamada.
Referências
- OpenAI Services Agreement: termos sobre compartilhamento de contas, revenda e compra e venda de chaves API
- Link:
openai.com/policies/services-agreement - Países e regiões com suporte à API da OpenAI: informações sobre possível bloqueio de acesso em regiões sem suporte
- Link:
help.openai.com/en/articles/5347006-openai-api-supported-countries-and-territories - Anthropic Commercial Terms: restrições de revenda e requisitos de regiões com suporte
- Link:
anthropic.com/legal/commercial-terms - Preços da Anthropic: descontos da Batch API e do cache de comandos
- Link:
docs.claude.com/en/docs/about-claude/pricing - Central de documentação oficial da APIYI: informações sobre fidelidade dos modelos e canais, comparação entre proxy oficial e engenharia reversa da API oficial, gerenciamento de tokens, consulta de logs, política de reembolso, pagamentos e emissão de notas fiscais, informações sobre SLA e guia de início rápido
- Link:
docs.apiyi.com
Autor: Equipe técnica da APIYI
Dúvidas técnicas: se tiver alguma dúvida sobre o checklist deste artigo, entre em contato pelos canais oficiais de atendimento disponíveis na página inicial do site da APIYI.
