guides

2026-10-21: 8 queixas sobre APIs que ouvimos hoje

PoYo Team
10 min read
Share:

Queixas que programadores de língua inglesa publicaram abertamente no X entre 19 e 21 de outubro de 2026, parafraseadas abaixo com ligações para as publicações originais. Cada resposta usa apenas o que o site e a documentação públicos do PoYo dizem hoje, e indica a página de onde vem. Onde a documentação não cobre algo, dizemo-lo.


Q1. Uma ferramenta em que confiava expôs a minha chave de API e acordei com uma fatura. Como limito os danos da próxima vez?

De que se queixam os programadores: A violação da OpenCode Console foi a maior notícia de API dos últimos dois dias. A OpenCode diz que as chaves de fornecedores guardadas por cerca de 1,4% dos utilizadores da Console podem ter ficado expostas, e alguns programadores relataram cobranças não autorizadas da OpenAI, da Anthropic e da Google, com um relato de $1700. Os programadores repetiram o mesmo conselho: dá a cada ferramenta a sua própria chave com um limite de gasto e lembra-te de que eliminar uma chave dentro de uma ferramenta de terceiros não a revoga. Outro programador publicou sobre uma fatura de $420 por causa de uma chave esquecida de 2024.

Como o PoYo responde: A nossa documentação lista três controlos que podes aplicar a uma chave do PoYo:

  • Limites de utilização por chave (por hora, por dia e totais) e uma lista de IPs permitidos, para que só os IPs dos teus servidores aprovados possam usar a chave. Ambos estão na página de chaves de API e explicados em Primeiros passos.
  • Bloqueio por utilizador final. A tua aplicação envia um cabeçalho X-End-User-ID com cada pedido, e depois podes bloquear um autor de pedidos abusivo numa chave sem a rodar nem a desativar. Também podes tornar o cabeçalho obrigatório em todos os pedidos dessa chave. Vê Identificação do utilizador final.
  • As chaves ficam no servidor. A documentação diz para nunca pôr chaves em código de navegador, em apps móveis ou em repositórios públicos.

A nossa documentação pública não promete reembolsos por utilização feita com uma chave exposta. Se achas que uma chave do PoYo foi utilizada indevidamente, revoga-a e contacta o suporte (support@poyo.ai).


Q2. Paguei créditos de API antecipadamente e, um ano depois, tinham desaparecido.

De que se queixam os programadores: Uma publicação muito partilhada defendia que a expiração dos créditos pré-pagos da Anthropic e da OpenAI ao fim de 12 meses não tem qualquer 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 $50 por expiração.

Como o PoYo responde: A página inicial do PoYo diz sem rodeios: preços baseados em créditos, sem subscrições, compras pontuais e créditos que nunca expiram. Podes consultar o teu saldo atual a qualquer momento através do endpoint de saldo do utilizador (GET /api/user/balance), que devolve credits_amount em tempo real.


Q3. O Gemini 3.8 Flash devolve 503 “sem capacidade” há dias. O que faço quando um fornecedor a montante bloqueia?

De que se queixam os programadores: Um programador disse que o nível gratuito do gemini-3.8-flash estava a devolver 503 há 2,5 dias. Outro viu respostas com mais de 60 segundos ou erros 503 de capacidade no Antigravity. Do lado dos agents de programação, uma análise contou 42,7 horas de incidentes abertos do Codex em duas semanas e defendeu que são as falhas, e não o gosto, o motivo por que muita gente paga por duas ferramentas de programação.

Como o PoYo responde: Eis o que a documentação sustenta e o que não sustenta:

  • Uma chave, muitos modelos. O Gemini 3.8 Flash, o Gemini 3.7 Flash, o Claude, o GPT e os modelos DeepSeek funcionam todos com a mesma chave do PoYo. Se um modelo estiver com problemas, podes mudar para outro alterando o valor de model. Todos os modelos estão listados no 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 repetir ambos com backoff exponencial.
  • O que não afirmamos. A documentação não descreve nenhum failover automático entre fornecedores, por isso, se quiseres um fallback, constrói-o no teu cliente. Os Primeiros passos dizem também diretamente que a “estabilidade global” do PoYo “pode ser ligeiramente inferior à dos fornecedores oficiais”. Preferimos dizer-to desde o início.

Q4. O meu 429 não era, afinal, um limite de pedidos. Porque é que os fornecedores reutilizam o mesmo erro para coisas diferentes?

De que se queixam os programadores: Um programador explicou que um 429 que recebeu era na verdade um limite do nível para contexto longo, e não um limite de pedidos, e que demorou cerca de uma hora a vasculhar dashboards até perceber. Um tutorial relacionado sobre erros de quota do Gemini (16 de outubro) explica como um único 429 RESOURCE_EXHAUSTED pode significar “sem quota para este modelo”, “limite por minuto” ou “limite por dia”, e cada caso exige uma correção diferente.

Como o PoYo responde: A nossa página de códigos de erro dá a cada estado um único significado:

Códigoerror.typeO que fazer
402insufficient_credits_errorRecarrega. Tentar novamente não ajuda.
429rate_limit_errorEspera e tenta novamente, ou põe os pedidos em fila.
502upstream_errorTenta novamente com backoff.
503service_errorTenta novamente com backoff.

A mesma página diz-te para estares atento ao teu saldo de créditos, para não apanhares um 402 a meio de trabalho crítico. O endpoint de saldo é a forma de o verificar.


Q5. Os meus trabalhos em batch esbarram nos limites de pedidos a meio.

De que se queixam os programadores: Um programador que está a criar um agent de geração de leads com o n8n disse que os limites de pedidos da API durante execuções em batch eram o seu maior problema, e perguntou aos outros como lidam com o backoff e a deduplicação.

Como o PoYo responde: Os Primeiros passos publicam o limite predefinido: até 20 novos pedidos de geração por cada 10 segundos, por conta, o que “normalmente permite mais de 100 tarefas em execução em simultâneo”. Os pedidos acima do limite recebem um HTTP 429 e não entram na fila, por isso espaça as tuas submissões em vez de disparares tudo de uma vez. Se receberes 429 de forma consistente, a documentação diz que podes pedir ao suporte um limite mais alto, embora as aprovações sejam cautelosas.

A geração é assíncrona: submetes uma tarefa, recebes um task_id e depois fazes polling ou recebes um callback (visão geral da API). Para batches grandes, a documentação recomenda webhooks assinados (HMAC-SHA256) em vez de polling frequente. Quanto à deduplicação, a documentação dá uma regra: trata cada nova submissão como trabalho potencialmente novo e pago, e verifica se o pedido original já criou uma tarefa antes de tentares novamente.


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

De que se queixam os programadores: Uma comparação de preços concluiu que os preços da geração de vídeo variam mais de 3 vezes para o mesmo modelo entre fornecedores. Outro programador disse que a Higgsfield continua demasiado cara, mesmo com o Seedance 2.5, e pediu opções mais baratas. Um terceiro disse que gastou cerca de $12 de $40 em créditos no gerador de vídeo de uma aplicação sem obter um único clipe de 15 segundos utilizável.

Como o PoYo responde: Todos os modelos de vídeo estão reunidos na página API de vídeo com IA, e todos usam o mesmo fluxo assíncrono de submissão e estado. Cada modelo publica preços por segundo. Por exemplo, o Seedance 2.5 indica 480p a $0.140/s e 1080p a $0.570/s sem vídeo de entrada, com tarifas mais baixas quando o pedido inclui um vídeo de referência. A página de preços coloca o preço do PoYo ao lado do preço oficial sempre que existe um.

Sobre as falhas: tanto o llms.txt como as páginas de modelo dizem que as tarefas falhadas não são cobradas. Para ser claro, uma tarefa que termina mas te dá um clipe de que não gostas continua a contar como resultado bem-sucedido e é faturada. Podes testar prompts no Playground, em cada página de modelo, antes de chamares a API.


Q7. A API barata que estou a usar serve mesmo o modelo que diz servir?

De que se queixam os programadores: Um programador disse que o OpenRouter começou a enviar os seus pedidos GLM para um endpoint quantizado em FP4, o que lhe estragou o projeto antes de perceber o que tinha mudado. Outra publicação descrevia relays de API “100% de fornecimento direto oficial” que vendem com descontos enormes mas acabam por ser lentos, e como detetar um fornecedor a montante falso.

Como o PoYo responde: Eis o que podes verificar nas nossas páginas públicas:

  • Variantes oficiais identificadas. Alguns modelos são oferecidos como variantes “oficiais” claramente nomeadas, como o Sora 2 Official e o Veo 3.1 Official. Estão listados separadamente das outras variantes do mesmo modelo, como se vê no llms.txt.
  • Schemas e preços públicos. Cada modelo publica o seu schema de entrada e o preço atuais no seu próprio llms.txt.
  • Histórico de tarefas. A página do histórico de tarefas mostra o modelo, os parâmetros de entrada, o estado e o resultado ou erro de cada tarefa que executas (vê os Primeiros passos).

A nossa documentação pública não descreve como cada pedido é encaminhado a montante, por isso não fazemos aqui afirmações sobre o encaminhamento.


Q8. A fatura de tokens do meu agent está fora de controlo.

De que se queixam os programadores: Um programador comparou um mês de custos de um agent de pesquisa: $220 no Opus 5.5 contra $4.80 no DeepSeek. Outro defendeu que, se o Gemini 4 Argon iguala o Opus por menos dinheiro, “brand loyalty won't save your API bill” (a lealdade à marca não te vai salvar a fatura de API).

Como o PoYo responde: Todos estes modelos funcionam com uma só chave, por isso passar uma carga de trabalho para um modelo mais barato significa mudar o campo model, e não começar uma nova integração. Preços atuais listados:

  • Claude Opus 5.5: $3.20 de entrada / $16.00 de saída por 1 M de tokens, o que a página do modelo descreve como 20% abaixo das tarifas standard oficiais.
  • Gemini 4 Argon: $1.60 / $8.00 por 1 M de tokens (20% abaixo do oficial).
  • DeepSeek V4.1 Flash: $0.30 / $1.20 por 1 M de tokens.

Consulta a página de preços antes de comprometeres uma carga de trabalho. Os preços mudam, e o llms.txt de cada modelo tem sempre os valores atuais.


Mapa rápido

QueixaOnde o PoYo a documenta
Chaves expostas / faturas surpresaPágina de chaves de API · Primeiros passos · X-End-User-ID
Créditos que expiramPágina inicial: os créditos nunca expiram · API de saldo
503 a montante / falhasCódigos de erro · Lista de modelos no llms.txt
O que significa um 429Códigos de erro
Limites de pedidos em batchPrimeiros passos: limites de pedidos · Webhooks
Preços de vídeo / clipes falhadosAPI de vídeo com IA · Preços
Confiança em revendedoresHistórico de tarefas · llms.txt por modelo
Faturas de tokensPreços · páginas de modelo
Share: