guides

2026-10-23: 7 queixas sobre APIs que ouvimos hoje

PoYo Team
9 min read
Share:

Queixas que programadores de língua inglesa publicaram abertamente entre 21 e 23 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. A minha chave do Gemini ainda estava nas variáveis de ambiente da Railway — alguém gastou $800 durante a noite.

De que se queixam os programadores: A divulgação sobre as variáveis de ambiente da Railway continua a gerar faturas novas. Um programador disse que perdeu $800 quando alguém usou a sua chave de API do Gemini na Google Cloud no nível prioritário do Gemini 4 Argon. Outro disse que a OpenRouter lhe enviou um e-mail a informar que duas chaves pessoais tinham sido revogadas depois de usadas para executar agents de outra pessoa. Um terceiro resumiu a semana como OpenCode, Railway e LiteLLM a visarem, todos, chaves de inferência de IA em cinco dias. O conselho recorrente: uma chave exposta continua a ser gasta até alguém ler a fatura.

Como o PoYo responde: Roda primeiro — um segredo exposto continua a ser um segredo exposto. Depois, a nossa documentação lista controlos que limitam o que uma chave do PoYo roubada pode fazer:

  • Lista de IPs permitidos. Permite numa chave apenas os IPs dos teus servidores aprovados, para que uma chave copiada de uma variável de ambiente não funcione a partir da máquina do atacante. Vê a página de chaves de API e os Primeiros passos.
  • Limites de utilização por chave (por hora, por dia e totais), para que cada chave tenha um teto firme antes de dares por isso.
  • Bloqueio por utilizador final. Envia um cabeçalho X-End-User-ID e podes bloquear um autor de pedidos abusivo numa chave sem a rodar. Vê Identificação do utilizador final.

Se ainda assim queres o próprio Gemini 4 Argon, o PoYo lista-o a $1.60 de entrada / $8.00 de saída por 1 M de tokens (20% abaixo das tarifas standard oficiais), com a mesma chave do PoYo que usas nos outros modelos.

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. O Gemini no AI Studio e no Vertex devolvem ambos 429 e timeouts — o dia de ontem ainda não acabou?

De que se queixam os programadores: Um programador escreveu que a API do Gemini, no AI Studio ou no Vertex, estava “unbearably unstable and slow” (insuportavelmente instável e lenta) com 429 e timeouts, e perguntou se os problemas do dia anterior sequer tinham terminado. Em separado, discussões no Reddit, em r/openrouter, continuam a explicar que o saldo pago num agregador não aumenta a quota de um modelo a montante — continuas a receber 429 quando o conjunto partilhado está cheio.

Como o PoYo responde: A nossa página de códigos de erro dá a cada estado um significado e uma ação recomendada:

Códigoerror.typeO que a documentação diz para fazer
402insufficient_credits_errorRecarrega. Tentar novamente não ajuda.
429rate_limit_errorEspera antes de tentares novamente, ou põe os pedidos em fila.
500 / 502 / 503internal_error / upstream_error / service_errorTenta novamente com backoff exponencial.

Os Primeiros passos publicam o limite de geração predefinido: até 20 novos pedidos de geração por cada 10 segundos, por conta. Os pedidos acima desse limite recebem HTTP 429 e não entram na fila. Os modelos de chat e de media partilham uma só chave do PoYo e estão listados no llms.txt, por isso mudar de modelo é trocar uma string model — não é integrar um novo fornecedor.

A documentação não descreve nenhum failover automático entre fornecedores. Constrói o fallback no teu cliente. Os Primeiros passos dizem também que a “estabilidade global” do PoYo “pode ser ligeiramente inferior à dos fornecedores oficiais”.


Q3. O meu agent precisa de imagem, vídeo, áudio e chat — são cinco SDKs e cinco dashboards de faturação.

De que se queixam os programadores: Um criador resumiu o problema sem rodeios: analisar uma imagem, gerar um vídeo, transcrever áudio e criar embeddings de texto significava cinco SDKs, cinco chaves de API e cinco dashboards de faturação. As apresentações de produtos no X repetiam o mesmo cansaço — fartos de gerir várias chaves de API de IA e dashboards de faturação.

Como o PoYo responde: O llms.txt descreve o PoYo como uma API de modelos unificada: imagem, vídeo, música, 3D, chat e ferramentas atrás de uma única chave de API. Os modelos de media usam um único fluxo assíncrono de submissão/estado (POST /api/generate/submit e depois polling do estado ou definição de callback_url). O chat usa endpoints compatíveis com a OpenAI, Claude Messages ou nativos do Gemini, com a mesma chave. A visão geral da API documenta essa arquitetura de dois endpoints, e a página inicial repete “uma API assíncrona” para imagem, vídeo, música, chat e 3D.


Q4. O Seedance gerou três vídeos e cobrou-me como se eu tivesse pedido seis.

De que se queixam os programadores: Uma criadora pediu desculpa por edições desarrumadas e acrescentou que o Seedance gerou três vídeos em vez de um e cobrou o dobro dos créditos. Outra discussão lembrou que os segundos de referência também podem ser faturáveis — uma referência de 15 segundos mais uma saída de 15 segundos podem significar 30 segundos faturáveis. Um terceiro chamou ao Seedance 2.5 absurdamente lento e caro para UGC autêntico.

Como o PoYo responde: A página do modelo Seedance 2.5 publica a regra de faturação em linguagem simples: com vídeo de entrada, segundos faturados = duração da saída + duração do vídeo de referência. Os preços por segundo estão listados por resolução (por exemplo, 480p sem vídeo de entrada a $0.140/s e 1080p sem vídeo de entrada a $0.570/s). Itera em 480p e depois renderiza a versão final numa resolução mais alta. Todas as rotas de vídeo partilham o mesmo fluxo assíncrono na página API de vídeo com IA. O llms.txt e a página inicial indicam ambos que as tarefas falhadas não são cobradas — mas um clipe terminado de que não gostas continua a contar como resultado bem-sucedido.


Q5. A Anthropic diz que o meu saldo de créditos é demasiado baixo — pensava que a minha subscrição cobria isto.

De que se queixam os programadores: Várias publicações neste período limitaram-se a colar o mesmo erro da Anthropic: “Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.” (o teu saldo de créditos é demasiado baixo para aceder à API da Anthropic; vai a Plans & Billing para fazer upgrade ou comprar créditos). Em separado, a quem estava a criar agents no n8n lembraram que a faturação da API da OpenAI é independente de uma subscrição do ChatGPT. A queixa de fundo é a mesma: os planos de produto e os créditos de API parecem iguais até um pedido morrer a meio do fluxo.

Como o PoYo responde: O modelo de faturação do PoYo está documentado como apenas de créditos pré-pagos:

  • A página inicial diz compras pontuais, sem subscrições recorrentes, e os créditos nunca expiram.
  • Quando o saldo acaba, a API devolve 402 insufficient_credits_error (códigos de erro) em vez de abrir silenciosamente uma fatura a pagar depois.
  • Podes fazer polling de GET /api/user/balance para obter credits_amount em tempo real (saldo do utilizador).

Compara os preços de chat e de media na página de preços antes de submeteres trabalho pago.


Q6. Perco constantemente a noção do que a minha programação com IA custa hoje.

De que se queixam os programadores: Um programador disse que perdia constantemente a noção dos custos da programação com IA, por isso criou widgets de ambiente de trabalho para o gasto na OpenRouter e os créditos restantes. Depois da semana da Railway, outro lembrete foi direto: define limites de faturação nos fornecedores de IA para que uma chave exposta tenha um teto.

Como o PoYo responde: Três elementos documentados respondem a esta queixa:

  1. Saldo em direto. GET /api/user/balance devolve credits_amount para dashboards e alertas (saldo do utilizador). A documentação sugere guardar em cache e atualizar depois das tarefas, em vez de fazer polling constante.
  2. Limites por hora, por dia e totais em cada chave, na página de chaves de API, para que a chave de um agent de programação não possa esgotar a conta inteira (Primeiros passos).
  3. Travão pré-pago. Saldo vazio → 402, não uma fatura sem limite (códigos de erro).

Q7. A minha execução longa de um agent esbarra num timeout rígido do gateway antes de o modelo acabar de pensar.

De que se queixam os programadores: Um programador disse que não conseguia puxar pelo Gemini Argon na app para o consumidor, mudou para o Google AI Studio e continuou a bater num limite rígido de gateway no servidor de exatamente 10 minutos. É a dor clássica do HTTP síncrono: o modelo ainda está a trabalhar, a ligação já morreu.

Como o PoYo responde: A geração no PoYo foi pensada para ser assíncrona. Os Primeiros passos e a visão geral da API dizem: submete uma tarefa, guarda o task_id e depois faz polling do estado ou recebe um webhook. Uma submissão bem-sucedida devolve HTTP 200 e um task_id — não significa que a geração terminou. Para cargas de produção, a documentação prefere webhooks assinados a polling frequente. O chat pode usar streaming nos endpoints documentados compatíveis com a OpenAI, Claude Messages ou nativos do Gemini (llms.txt), enquanto os trabalhos longos de media ficam no caminho de submissão/estado, para não ficarem presos a um único timeout de gateway.


Mapa rápido

QueixaOnde o PoYo a documenta
Chaves do Gemini / Railway esgotadasPágina de chaves de API · Primeiros passos · X-End-User-ID · Gemini 4 Argon
429 / timeouts do GeminiCódigos de erro · Primeiros passos: limites de pedidos · llms.txt
Cinco SDKs / cinco faturasllms.txt · Visão geral da API · Página inicial
Seedance / surpresas de créditos de vídeoSeedance 2.5 · API de vídeo com IA · llms.txt: falhadas não cobradas
Saldo demasiado baixo / plano vs APIPágina inicial: créditos · Códigos de erro: 402 · Preços
Gastos de programação invisíveisAPI de saldo · Primeiros passos: limites das chaves
Timeouts de gateway em execuções longasPrimeiros passos: assíncrono · Visão geral da API
Share: