AI エージェントから SeedRouter を使う

エージェントから SeedRouter を使う方法は 3 つあります。いずれも API キー、残高、モデル、制限は共通で、課金方法も同じです。

エージェント自体を SeedRouter のテキストモデルで動かすには、SeedRouter でコーディングエージェントを使うを参照してください。

キーを一度設定する

API キーページでキーを作成し、エクスポートしてください。プロジェクトのファイルにキーを保存せずに、エージェントが読み込めるようになります：

export SEEDROUTER_API_KEY=YOUR_API_KEY

API キーページには MCP 経由で接続 ボタンもあり、各 MCP クライアント向けにそのまま使える設定を表示します。

SeedRouter でエージェントが行うこと

1. モデルを探す：MCP の list_models、または /llms.txt のモデル一覧を使います。ランディングページのあるモデルには、https://seedrouter.ai/models/<slug>/llms.txt にパラメータ、価格、例を記載したプレーンテキストの概要があります。
2. 入力スキーマを読む：MCP の get_model_schema、またはモデルのドキュメントページを使います。
3. 公開メディア URL を使う：生成エンドポイントでは、参照用の画像・動画・音声を公開の http(s) URL としてのみ受け付けます。Base64 入力は拒否されるため、ローカルファイルは事前にアクセス可能な場所でホストしてください。
4. 価格を確認する：MCP の get_pricing は、送信前にモデルの現在のレートを USD で返します。
5. 送信して待機する：submit_task を呼び出したあと、タスクが完了するまで wait_seconds: 50 を指定して get_task を呼び出します。HTTP では、モデルのエンドポイントに送信し、約 3 秒ごとに GET /v1/tasks/{id} をポーリングします。

失敗したタスクは課金されません。送信は冪等ではありません。レスポンスを受け取れなかったリクエストを再試行すると、2 件目のタスクが作成され、その分も課金されます。先にタスク履歴または残高を確認してください。

運用で考慮すべき制限

リクエストにはレート制限が適用される場合もあり、その場合も HTTP 429 が返されます。HTTP 429 では、Retry-After があれば、そこで指定された時間だけ待機してください。なければ、待機時間にランダムな変動と上限を設け、再試行のたびに指数関数的に延ばしてください。テキストのエンドポイントは各プロトコルのエラー形式で応答するため、エラー本文を解析するのではなく、ステータスコードで判断してください。バッチ処理ではキューを保持し、実行中のタスクが完了したら新しいタスクを送信するようにしてください。すべてを一度に送信しないでください。上限の引き上げが必要な場合は、[email protected] にお問い合わせください。

機械可読の入口