guides

2026-10-21:今日聞いた API への不満 8 件

PoYo Team
3 min read
Share:

2026 年 10 月 19 日から 21 日にかけて、英語圏の開発者が X で公開した不満を、元投稿へのリンク付きで要約しています。各回答は、PoYo の公開サイトとドキュメントに今日書かれている内容だけを使い、出典のページへリンクします。ドキュメントが触れていない点は、そのように記します。


Q1. 信頼していたツールから API キーが漏れ、起きたら請求が来ていた。次はどう被害を限るか。

開発者が不満に思っていること: この 2 日で最も大きい API の話題は、OpenCode Console の侵害でした。OpenCode は、Console ユーザーの約 1.4% が保存していたプロバイダー鍵が露出した可能性があると述べています。開発者のなかには、OpenAI、Anthropic、Google への無断課金を報告した人がおり、一件は $1,700 です。繰り返された助言は同じです。ツールごとに支出上限付きの鍵を分けること、そして第三者ツールの中で鍵を消しても失効にはならないことです。別の開発者は、2024 年の置き忘れた鍵で $420 の請求があったと投稿しています。

PoYo の回答: ドキュメントには、PoYo の鍵に付けられる制御が 3 つあります。

  • 鍵ごとの利用上限(時間、日、累計)と IP ホワイトリスト。承認したサーバー IP だけがその鍵を使えます。どちらも API キーのページ にあり、はじめにで説明しています。
  • エンドユーザー単位のブロック。 アプリはリクエストごとに X-End-User-ID ヘッダーを送ります。その後、鍵をローテーションしたり無効にしたりせず、その鍵上の乱用している呼び出し元を 1 件止められます。その鍵の全リクエストでヘッダーを必須にすることもできます。エンドユーザー識別を参照してください。
  • 鍵はサーバーに置く。 ドキュメントは、ブラウザのコード、モバイルアプリ、公開リポジトリに鍵を置かないよう記しています。

公開ドキュメントは、漏えいした鍵による利用分の返金を約束していません。PoYo の鍵が悪用されたと考える場合は、鍵を失効させ、サポート([email protected])へ連絡してください。


Q2. API クレジットを前払いしたのに、1 年後には消えていた。

開発者が不満に思っていること: 広く共有された投稿は、Anthropic と OpenAI の前払いクレジットが 12 か月で失効することに技術上の理由はない、と論じています。持っているのはドル残高であり、確保済みの GPU 時間ではない、という主張です。投稿者は、失効でおよそ 50 ドルを失ったと書いています。

PoYo の回答: PoYo のホームページには明確に書かれています。クレジット課金で、サブスクリプションはなく、買い切りであり、クレジットに有効期限はない。 現在の残高は、いつでもユーザー残高エンドポイント(GET /api/user/balance)で読めます。credits_amount がリアルタイムで返ります。


Q3. Gemini 3.8 Flash が何日も 503「容量なし」を返している。上流の 1 つが止まったらどうするか。

開発者が不満に思っていること: ある開発者は、gemini-3.8-flash の無料枠が2.5 日にわたって 503 を返していると書きました。別の人は Antigravity で、応答が 60 秒を超えるか、503 の容量エラーになると報告しています。コーディング支援の側では、ある分析が2 週間で Codex の未解決インシデントが 42.7 時間だったと数え、多くの人がコーディングツールを 2 つ払う理由は好みではなく障害だ、と論じています。

PoYo の回答: ドキュメントが支えていることと、支えていないことを分けます。

  • 鍵は 1 つ、モデルは複数。 Gemini 3.8 Flash、Gemini 3.7 Flash、Claude、GPT、DeepSeek の各モデルは、同じ PoYo の鍵で動きます。1 つのモデルの状態が悪いときは、model の値を変えて切り替えます。全モデルは llms.txt にあります。
  • エラーコードは分かれている。 エラーコードのページは、502 upstream_error と 503 service_error(「サーバーが混み合っている」)を区別し、どちらも指数バックオフで再試行するよう勧めています。
  • 主張しないこと。 ドキュメントは、プロバイダー間の自動フェイルオーバーを説明していません。フォールバックが必要なら、クライアント側に実装してください。はじめにも、PoYo の「全体的な安定性は公式プロバイダーよりやや低い場合がある」と直接書いています。この点は先に伝えておきます。

Q4. 受けた 429 は、実際にはレート制限ではなかった。なぜ提供者は別の事態に同じエラーを使うのか。

開発者が不満に思っていること: ある開発者は、遭遇した 429 が実は長いコンテキストに対する階層の上限であり、レート制限ではなかったと説明し、ダッシュボードを約 1 時間調べて初めて分かった、と書いています。Gemini のクォータエラーに関する関連チュートリアル(10 月 16 日)は、同じ 429 RESOURCE_EXHAUSTED が「そのモデルにクォータがまったくない」「分あたりの上限」「日あたりの上限」のいずれも意味し得て、対処がそれぞれ違う、と整理しています。

PoYo の回答: エラーコードのページは、各ステータスに一つの意味を与えています。

コードerror.type対処
402insufficient_credits_error補充する。再試行では解消しない。
429rate_limit_error待ってから再試行するか、リクエストをキューに入れる。
502upstream_errorバックオフして再試行する。
503service_errorバックオフして再試行する。

同じページは、重要な作業の途中で 402 に当たらないよう、クレジット残高を見るよう記しています。確認方法は残高エンドポイントです。


Q5. バッチジョブが、途中でレート制限に当たる。

開発者が不満に思っていること: n8n でリード獲得エージェントを作っている開発者は、バッチ実行中の API レート制限が最大の問題だとし、バックオフと重複排除をどう扱っているか尋ねています。

PoYo の回答: はじめには既定の制限を公開しています。アカウントあたり、10 秒間に新規の生成リクエストは最大 20 件で、これは「通常、100 件超のタスクを同時に実行できる」としています。上限を超えたリクエストは HTTP 429 になり、キューには入りません。一度に全部投げるのではなく、投入の間隔を空けてください。429 が続く場合、ドキュメントはサポートへ上限引き上げを依頼できると書いていますが、承認は慎重です。

生成は非同期です。タスクを投入して task_id を受け取り、その後ポーリングするかコールバックを受けます(API 概要)。大量バッチでは、頻繁なポーリングより署名付き webhook(HMAC-SHA256)が推奨されています。重複排除について、ドキュメントの規則は一つです。再送は、新たに課金される作業になり得るものとして扱う。 再試行の前に、元のリクエストがすでにタスクを作っていないか確認します。


Q6. AI 動画 API の価格差が大きく、使えないクリップにも支払い続けている。

開発者が不満に思っていること: ある価格比較では、同じモデルでも提供者によって動画生成の価格が 3 倍超開くとされています。別の開発者は、Seedance 2.5 があっても Higgsfield はまだ高すぎるとし、より安い選択肢を求めています。三人目は、あるアプリの動画生成に40 ドルのクレジットのうち約 12 ドルを使っても、使える 15 秒のクリップが 1 本も得られなかった、と書いています。

PoYo の回答: 動画モデルはすべて AI 動画 API のページにまとまり、同じ非同期の投入とステータス確認を使います。各モデルは秒あたりの価格を公開しています。たとえば Seedance 2.5 は、動画入力がない場合、480p が 1 秒 $0.140、1080p が 1 秒 $0.570 です。参照動画を含むリクエストでは、これより低い料金です。料金ページは、公式価格が示されている場合、PoYo の価格をその横に置きます。

失敗について。llms.txt とモデルページは、失敗したタスクは課金されないと記しています。明確にしておくと、タスクは完了したがクリップが期待と違う場合、それは成功した出力であり、課金されます。API を呼ぶ前に、各モデルページの Playground でプロンプトを試せます。


Q7. 使っている安い API は、掲げているモデルを本当に提供しているのか。

開発者が不満に思っていること: ある開発者は、OpenRouter がGLM のリクエストを FP4 量子化エンドポイントへ送り始めたためプロジェクトが壊れ、何が変わったのか後から分かった、と書いています。別の投稿は、大幅な割引で売りながら遅い、「100% 公式の直接供給」をうたう API 中継と、偽の上流の見分け方を説明しています。

PoYo の回答: 公開ページで確認できるのは、次の点です。

  • 名称で区別された official バリアント。 一部のモデルは、名称が明確な “official” バリアントとして提供されます。例は Sora 2 Official と Veo 3.1 Official です。同じモデルの他のバリアントとは別に列挙され、llms.txt にそのように出ます。
  • 公開された schema と価格。 各モデルは、現在の入力 schema と価格を自身の llms.txt で公開しています。
  • タスク履歴。 タスク履歴のページは、実行した各タスクのモデル、入力パラメータ、ステータス、結果またはエラーを表示します(はじめに)。

公開ドキュメントは、各リクエストが上流へどうルーティングされるかを説明していません。したがって、ここではルーティングについて主張しません。


Q8. エージェントのトークン請求が制御できない。

開発者が不満に思っていること: ある開発者は、調査エージェントの 1 か月の費用を比べています。Opus 5.5 で $220、DeepSeek で $4.80です。別の人は、Gemini 4 Argon がより少ない費用で Opus に並ぶなら、「ブランドへの忠誠は API の請求を救わない」と論じています。

PoYo の回答: これらのモデルは 1 つの鍵で動きます。より安いモデルへ作業を移すのは、model フィールドを変えることであり、連携を作り直すことではありません。現在の表示価格は次のとおりです。

  • Claude Opus 5.5:100 万トークンあたり入力 $3.20 / 出力 $16.00。モデルページは、公式の標準料金より 20% 低いと説明しています。
  • Gemini 4 Argon:100 万トークンあたり $1.60 / $8.00(公式より 20% 低い)。
  • DeepSeek V4.1 Flash:100 万トークンあたり $0.30 / $1.20。

作業を決める前に料金ページを確認してください。価格は変わります。各モデルの llms.txt が、その時点の数字です。


早見表

不満PoYo がドキュメントに書いている場所
漏えいした鍵 / 想定外の請求API キーのページ · はじめに · X-End-User-ID
失効するクレジットホームページ:クレジットは失効しない · 残高 API
上流の 503 / 障害エラーコード · llms.txt のモデル一覧
429 の意味エラーコード
バッチのレート制限はじめに:レート制限 · Webhook
動画の価格 / 失敗したクリップAI 動画 API · 料金
再販への信頼タスク履歴 · モデルごとの llms.txt
トークン請求料金 · モデルページ
Share: