コンテンツへスキップ
ガイド
ガイド

認証

APIキーを作成してRunAPIへのリクエストを認証します。

Markdownを表示

RunAPIはAPIキーを使用してAPIリクエストを認証します。アカウントにアクセスするか、作業を作成するすべてのリクエストにキーを添付してください。

適切なキーを選択する

  • 標準APIキーは、Task API・LLM API・アカウントエンドポイントを呼び出します。 サインインしてAPIキーページを開き、作成してください。
  • 管理キーは、標準APIキーとガードレールの作成および管理に使用します。 サインインしてManagement Keysページを開いて作成し、Platform Managementエンドポイントでのみ使用してください。

APIキーを作成する

アプリケーションごとに独自のキーを付与することで、他の統合を中断することなくアクセスのローテーションや失効が可能になります。キーは 1 つのアカウントにバインドされており、リクエストはそのアカウントから見えるリソースにのみアクセスできます。

有料 API 呼び出しはアカウントあたり毎分 300 リクエストに制限されています。429 Too Many Requests レスポンスには Retry-After、X-RateLimit-Limit-RPM、X-RateLimit-Remaining-RPM、および X-RateLimit-Reset ヘッダーが含まれます。

リクエストを認証する

AuthorizationヘッダーでAPIキーをベアラートークンとして送信します：

HTTP 
Authorization: Bearer YOUR_API_TOKEN

例えば、cURLで現在の残高を確認するには：

SHELL 
curl "https://runapi.ai/api/v1/me/balance" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

ホスト型 MCP OAuth

リモート MCP クライアントは https://mcp.runapi.ai/mcp に接続し、標準 OAuth リソース https://mcp.runapi.ai を使用して RunAPI の認証フローを自動的に検出します。RunAPI アカウントにサインインまたは新規作成し、アカウントを選択して、API キーを作成・共有せずにアクセスを承認してください。

RunAPIは、Hosted MCPアクセスのために、動的クライアント登録、S256 PKCEによる認可コード、およびローテーションリフレッシュトークンをサポートしています。

OAuthディスカバリーエンドポイント：

  • Protected Resource Metadata： https://runapi.ai/.well-known/oauth-protected-resource
  • Authorization Server Metadata： https://runapi.ai/.well-known/oauth-authorization-server

サインインしてから、/settings#oauth-connections の認証済みアプリを開いて、クライアントアクセスを確認または取り消してください。

キーを安全に保管する

  • APIキーはシークレットマネージャーまたは暗号化された認証情報に保管してください。
  • キーをソースコントロールにコミットしたり、ブラウザのコードに露出させたりしないでください。
  • キーが漏洩した可能性がある場合は、直ちにローテーションしてください。
  • 開発環境と本番環境には別々のキーを使用してください。

認証のトラブルシューティング

  • 401 Unauthorized レスポンスは、キーが欠落している、不正な形式である、失効している、または無効であることを意味します。
  • 403 Forbidden レスポンスは、キーは有効だがその認証情報クラスまたはアカウントロールではその操作を実行できないことを意味します。
  • ヘッダーが Bearer で始まり、その後にスペース1つと完全なキーが続いていることを確認してください。
  • キーが、リソースをリクエストしているアカウントに属していることを確認してください。