HOODY EXECファイルがAPIです。コメント1行ですべてが変わります。
TypeScript関数を書くと、即座にライブHTTPエンドポイントになります。認証、CORS、モード、AIを制御するコメントを1行追加するだけ。設定不要。ミドルウェア不要。
// @mode serverless
// @cors reflective
// @token my-secret-key
return { message: 'Hello!', time: Date.now() };
# ライブ URL:
https://proj-cont-exec-1.us1.containers.hoody.com/hello
2つのモード。1つのコメント。
各スクリプトはモードを選択します。ステートフルなリアルタイムアプリにはWorker。分離されたエフェメラル実行にはServerless。コメント1行で切り替えられます。
Workerモード
- 永続的なV8アイソレート — 常にウォーム状態
- すべてのリクエスト間で状態を共有
- WebSocketサポート
- 最初のリクエスト後はコールドスタートなし
Serverlessモード
- リクエストごとに新しいV8アイソレート
- 完全な分離、状態の漏洩なし
- @concurrentで同時実行数を設定可能
- Webhookや散発的なトラフィックに最適
すべての動作。1行で。
ファイルの先頭にコメントを追加するだけ。コード変更なし、設定ファイルなし、ミドルウェアなし。コメントを変えれば、動作が即座に変わります。
実行モード
永続的なWorker VMか、リクエストごとに新しいServerlessアイソレートかを選択します。状態、WebSocket、コールドスタートの動作を決定します。
CORS制御
'reflective'でリクエストオリジンをミラー、'*'ですべてのオリジンを開放、または特定のURLに限定できます。ミドルウェアは不要です。
リクエストタイムアウト
タイムアウトをミリ秒単位で設定します。デフォルトは30秒。長時間実行スクリプトには0または'unlimited'を使用。暴走実行を防ぎます。
同時実行数の上限
Serverlessのみ: 同時実行数の上限を設定します。直列処理には'false'を設定 — Webhookの順序保証に必須です。
エンドポイント認証
共有シークレットで任意のエンドポイントを保護します。クライアントはBearer、Basic、X-Tokenヘッダー、またはクエリパラメーターで認証できます。定数時間比較を使用します。
WebSocketサポート
リアルタイムの双方向接続を有効にします。Workerモードが必要です。ws.message、ws.open、ws.closeハンドラーが自動的に注入されます。
AIヘルパー
Vercel AI SDKのgenerateText、streamText、generateObjectを注入します。インポート不要、APIキーの設定不要。モデルは事前に設定されています。
AIモデル選択
スクリプトごとにデフォルトのAIモデルを上書きします。デフォルト: google/gemini-2.5-flash-lite。15以上のプロバイダーの300以上のモデルをサポート。
AWS統合
コメント1行でスクリプト内にAWS SDKを有効化します。S3、DynamoDB、Lambda、その他のAWSサービスに直接アクセスできます。
マジックコメント完全リファレンス。
すべてのコメント、すべての値、すべてのデフォルト。一か所にまとめて。
スクリプトの実行モードを設定します。'worker'は永続的なVMを作成し、'serverless'（デフォルト）はリクエストごとに新しいVMを作成します。
構文
WebhookからWebSocketまで数分で。
即座のHTTP APIからリアルタイムAIプロキシまで — 6つのパターンで全範囲をカバー。
即座のAPI
Expressのセットアップを完全にスキップ。ファイルを作成するだけで、ライブHTTPエンドポイントになります。高トラフィックにはWorker、分離にはServerlessを使用。
Webhookレシーバー
Serverlessによる分離でStripe、GitHub、SlackのWebhookを受信します。@concurrent falseで直列処理と一貫した順序保証を実現。
WebSocketサーバー
チャットサーバー、ライブダッシュボード、SSEストリーム。Workerモードで共有ルーム状態を持つ永続的な接続を維持します。
AI MITMプロキシ
AIリクエストをインターセプトして制御します。安全チェックの追加、プロンプトの変更、機密データのブロック、使用量の追跡 — すべて1つのスクリプトで。
レート制限
リクエスト間で共有オブジェクトにIPごとのリクエスト数を記録します。Workerモードでインメモリレート制限が簡単に実装できます。
スクリプト合成
すべてのスクリプトはHTTPエンドポイントです。fetch()で他のスクリプトを呼び出せます。シンプルな関数からマイクロサービスを構成 — キューもサービスディスカバリーも不要。
すべてのAPIサーフェス、1か所に。
スクリプト実行、管理、バリデーション、テンプレート、ルーティング、モニタリング、マジックコメント制御 — すべて1つのAPIに。
モニタリングとマジックAPI
8エンドポイントGET /api/v1/exec/monitor/stats
実行とスクリプト
7エンドポイントGET/POST /:path
バリデーション
6エンドポイントPOST /api/v1/exec/validate/script
テンプレートとルーティング
6エンドポイントGET /api/v1/exec/templates/list