guides

2026-10-21: 8 reclamações de API que ouvimos hoje

PoYo Team
10 min read
Share:

Reclamações que desenvolvedores de língua inglesa publicaram no X entre 19 e 21 de outubro de 2026, resumidas aqui com links para as publicações originais. Cada resposta usa apenas o que o site público e a documentação da PoYo dizem hoje, e aponta a página de origem. Quando a documentação não cobre um ponto, dizemos isso.


Q1. Uma ferramenta em que eu confiava vazou minha chave de API, e acordei com uma cobrança. Como limito o dano da próxima vez?

Do que os desenvolvedores reclamam: A violação do OpenCode Console foi o maior assunto de API dos últimos dois dias. A OpenCode diz que chaves de provedores salvas por cerca de 1,4% dos usuários do Console podem ter sido expostas. Alguns desenvolvedores relataram cobranças não autorizadas da OpenAI, da Anthropic e do Google, uma delas de US$ 1.700. O conselho se repetiu: dar a cada ferramenta a própria chave, com um teto de gasto, e lembrar que apagar uma chave dentro de uma ferramenta de terceiros não a revoga. Outro desenvolvedor publicou uma cobrança de US$ 420 de uma chave de 2024 esquecida.

Como a PoYo responde: A documentação lista três controles que você pode colocar em uma chave da PoYo:

  • Tetos de uso por chave (por hora, por dia e total) e uma lista de IPs permitidos, para que só os IPs de servidor que você aprovar usem a chave. Os dois estão na página de chaves de API e são explicados em Primeiros passos.
  • Bloqueio por usuário final. Seu aplicativo envia o cabeçalho X-End-User-ID em cada requisição. Depois, é possível bloquear um chamador abusivo em uma chave sem rotacioná-la nem desativá-la. Também dá para tornar o cabeçalho obrigatório em toda requisição dessa chave. Veja Identificação do usuário final.
  • As chaves ficam no servidor. A documentação diz para não colocar chaves em código de navegador, aplicativos móveis ou repositórios públicos.

A documentação pública não promete reembolso pelo uso feito com uma chave vazada. Se você achar que uma chave da PoYo foi usada de forma indevida, revogue-a e fale com o suporte ([email protected]).


Q2. Paguei créditos de API adiantado e, um ano depois, eles tinham sumido.

Do que os desenvolvedores reclamam: Uma publicação muito compartilhada argumentou que a expiração, depois de 12 meses, dos créditos pré-pagos da Anthropic e da OpenAI não tem razão técnica, porque o que se tem é um saldo em dólares, não tempo de GPU reservado. O autor disse ter perdido pessoalmente cerca de US$ 50 com a expiração.

Como a PoYo responde: A página inicial da PoYo diz de forma direta: preços por créditos, sem assinaturas, compras únicas e créditos que não expiram. O saldo atual pode ser lido a qualquer momento no endpoint de saldo do usuário (GET /api/user/balance), que devolve credits_amount em tempo real.


Q3. O Gemini 3.8 Flash está devolvendo 503 “sem capacidade” há dias. O que faço quando um upstream trava?

Do que os desenvolvedores reclamam: Um desenvolvedor disse que o nível gratuito do gemini-3.8-flash devolvia 503 havia 2,5 dias. Outro viu no Antigravity respostas de mais de 60 segundos ou erros 503 de capacidade. Do lado das ferramentas de código, uma análise contou 42,7 horas de incidentes abertos do Codex em duas semanas e argumentou que as quedas, não o gosto, explicam por que muita gente paga duas ferramentas de código.

Como a PoYo responde: Isto é o que a documentação sustenta, e o que ela não sustenta:

  • Uma chave, vários modelos. Gemini 3.8 Flash, Gemini 3.7 Flash e modelos Claude, GPT e DeepSeek rodam na mesma chave da PoYo. Se um modelo vai mal, muda-se o valor de model. Todos os modelos estão em llms.txt.
  • Códigos de erro separados. A página de códigos de erro distingue 502 upstream_error de 503 service_error (“o servidor está ocupado”) e recomenda tentar de novo os dois com backoff exponencial.
  • O que não afirmamos. A documentação não descreve failover automático entre provedores. Se você quiser um fallback, construa-o no cliente. Primeiros passos também diz, de forma direta, que a “estabilidade geral da PoYo pode ser um pouco menor que a dos provedores oficiais”. Preferimos dizer isso antes.

Q4. Meu 429 não era, na verdade, um limite de taxa. Por que os provedores reutilizam o mesmo erro para coisas diferentes?

Do que os desenvolvedores reclamam: Um desenvolvedor explicou que o 429 que encontrou era, na verdade, um teto de nível para contexto longo, não um limite de taxa, e que levou cerca de uma hora nos painéis para entender. Um tutorial relacionado sobre erros de cota do Gemini (16 de outubro) percorre um único 429 RESOURCE_EXHAUSTED que pode significar “não há cota para este modelo”, “limite por minuto” ou “limite por dia”. Cada caso pede uma correção diferente.

Como a PoYo responde: Nossa página de códigos de erro dá a cada status um único significado:

Códigoerror.typeO que fazer
402insufficient_credits_errorRecarregar. Tentar de novo não resolve.
429rate_limit_errorEsperar e tentar de novo, ou colocar as requisições em fila.
502upstream_errorTentar de novo com backoff.
503service_errorTentar de novo com backoff.

A mesma página pede para acompanhar o saldo de créditos, para não encontrar um 402 no meio de um trabalho crítico. A forma de consultar é o endpoint de saldo.


Q5. Meus jobs em lote batem em limites de taxa no meio do caminho.

Do que os desenvolvedores reclamam: Um desenvolvedor que constrói um agente de geração de leads com n8n disse que os limites de taxa da API durante execuções em lote eram o maior problema, e perguntou como os outros tratam backoff e deduplicação.

Como a PoYo responde: Primeiros passos publica o limite padrão: até 20 novas requisições de geração a cada 10 segundos, por conta, o que “em geral permite mais de 100 tarefas em execução ao mesmo tempo”. Requisições acima do limite recebem HTTP 429 e não entram na fila. É preciso espaçar os envios, em vez de disparar tudo de uma vez. Se os 429 forem constantes, a documentação diz que se pode pedir ao suporte um limite maior; as aprovações são cautelosas.

A geração é assíncrona: você envia uma tarefa, recebe um task_id e depois consulta o status ou recebe um callback (visão geral da API). Para lotes grandes, a documentação recomenda webhooks assinados (HMAC-SHA256) em vez de polling frequente. Sobre deduplicação, a regra é uma: trate cada reenvio como um trabalho que pode gerar uma cobrança nova e confira se a requisição original já criou uma tarefa antes de tentar de novo.


Q6. As APIs de vídeo com IA custam valores muito diferentes, e eu continuo pagando por clipes que não consigo usar.

Do que os desenvolvedores reclamam: Uma comparação de preços encontrou preços de geração de vídeo que variam mais de 3 vezes para o mesmo modelo entre provedores. Outro desenvolvedor disse que a Higgsfield continua cara demais mesmo com o Seedance 2.5 e pediu opções mais baratas. Um terceiro disse ter gasto cerca de US$ 12 de US$ 40 em créditos no gerador de vídeo de um aplicativo sem obter um clipe utilizável de 15 segundos.

Como a PoYo responde: Todos os modelos de vídeo estão na página API de vídeo com IA e usam o mesmo fluxo assíncrono de envio e status. Cada modelo publica preços por segundo. Por exemplo, o Seedance 2.5 lista 480p a US$ 0,140/s e 1080p a US$ 0,570/s sem entrada de vídeo, com tarifas menores quando a requisição inclui um vídeo de referência. A página de preços coloca o preço da PoYo ao lado do preço oficial, quando este existe.

Sobre falhas: tanto o llms.txt quanto as páginas de modelo dizem que tarefas com falha não são cobradas. Para deixar claro, uma tarefa que termina, mas entrega um clipe que não serve, ainda conta como saída bem-sucedida e é cobrada. Dá para testar prompts no Playground de cada página de modelo antes de chamar a API.


Q7. A API barata que eu uso está mesmo servindo o modelo que diz servir?

Do que os desenvolvedores reclamam: Um desenvolvedor disse que a OpenRouter passou a enviar as requisições GLM para um endpoint quantizado em FP4, o que quebrou o projeto antes de ele entender o que tinha mudado. Outra publicação descreveu relays de API que se apresentam como “fornecimento direto oficial 100%”, vendidos com desconto forte, mas lentos, e como reconhecer um upstream que não é o anunciado.

Como a PoYo responde: Nas páginas públicas, dá para conferir o seguinte:

  • Variantes official com nome explícito. Alguns modelos são oferecidos como variantes “official” de nome claro, como Sora 2 Official e Veo 3.1 Official. Elas aparecem separadas das outras variantes do mesmo modelo, como mostra o llms.txt.
  • Schemas e preços públicos. Cada modelo publica o schema de entrada e o preço atuais no próprio llms.txt.
  • Histórico de tarefas. A página de histórico de tarefas mostra o modelo, os parâmetros de entrada, o status e o resultado ou o erro de cada tarefa (veja Primeiros passos).

A documentação pública não descreve como cada requisição é roteada para o upstream. Por isso, não fazemos aqui afirmações sobre roteamento.


Q8. A fatura de tokens do meu agente saiu do controle.

Do que os desenvolvedores reclamam: Um desenvolvedor comparou um mês de custos de um agente de pesquisa: US$ 220 no Opus 5.5 contra US$ 4,80 no DeepSeek. Outro argumentou que, se o Gemini 4 Argon se equipara ao Opus por menos dinheiro, “a lealdade à marca não vai salvar sua fatura de API”.

Como a PoYo responde: Todos esses modelos rodam em uma chave só. Mover uma carga para um modelo mais barato é mudar o campo model, não começar uma integração nova. Preços indicados agora:

  • Claude Opus 5.5: US$ 3,20 de entrada / US$ 16,00 de saída por 1 milhão de tokens. A página do modelo descreve isso como 20% abaixo das tarifas oficiais padrão.
  • Gemini 4 Argon: US$ 1,60 / US$ 8,00 por 1 milhão de tokens (20% abaixo do oficial).
  • DeepSeek V4.1 Flash: US$ 0,30 / US$ 1,20 por 1 milhão de tokens.

Consulte a página de preços antes de comprometer uma carga. Os preços mudam, e o llms.txt de cada modelo traz sempre os números vigentes.


Mapa rápido

ReclamaçãoOnde a PoYo documenta
Chaves vazadas / cobranças imprevistasPágina de chaves de API · Primeiros passos · X-End-User-ID
Créditos que expiramPágina inicial: créditos não expiram · API de saldo
503 de upstream / quedasCódigos de erro · lista de modelos no llms.txt
O que um 429 significaCódigos de erro
Limites de taxa em lotePrimeiros passos: limites de taxa · Webhooks
Preços de vídeo / clipes inutilizáveisAPI de vídeo com IA · Preços
Confiança no revendedorHistórico de tarefas · llms.txt de cada modelo
Faturas de tokensPreços · páginas de modelo
Share: