開発者 v1.0

APIマスターヴォールト

SwashiのAI Agentsにプログラムでアクセスし、コンテンツ生成、プロダクトインテリジェンス、分析をアプリケーションから直接自動化できます。

概要

Master API Vaultは、開発者、創業者、自動化チーム向けに設計されたRESTベースのAPIです。予測可能なJSON出力、高速な応答時間、そして実際のプロダクションワークロードに対応するスケーラブルなインフラストラクチャを提供します。全機能をご覧いただくか、利用可能なプランをご確認ください。

認証

リクエストはx-api-keyヘッダーを使用して認証します。

BASH
curl -X POST https://api.swashi.io/v1/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"scaling strategy"}'

レート制限

プラットフォームの安定性を確保するため、リクエストにはレート制限が適用されます。

  • 1分あたり60リクエスト
  • 1日あたり1,000リクエスト（無料プラン）
  • 有料プランではより高い制限が利用可能

レスポンスオブジェクト

すべてのレスポンスは標準JSON形式で返されます。

JSON
{
  "status": "success",
  "data": {
    "id": "gen_839201",
    "content": "Dropshipping automation...",
    "usage": {
      "tokens": 150,
      "model": "swashi-core"
    }
  }
}

エラーハンドリング

エラーは200番台以外のHTTPコードと構造化されたメッセージを返します。

JSON
{
  "status": "error",
  "code": 401,
  "message": "Unauthorized request"
}