mcpField
N
near-ai-cloud

near-ai-cloud

github.com/nearクラウド・DevOps1669 回インストール4 週間前に更新
リポジトリ

near-ai-cloud について

NEAR AI Cloud は、機密 TEE 内でリクエストを処理する OpenAI 互換の推論サービスです。ハードウェア証明とモデル応答に関連する暗号署名を検証したい開発者向けです。

主な機能

  1. 01OpenAI 互換のチャット補完
  2. 02Intel TDX 機密 VM 内での推論
  3. 03NVIDIA TEE GPU のアテステーション
  4. 04チャット応答への署名
  5. 05モデル、証明、署名の各エンドポイント

活用シーン

  1. 01OpenAI SDK からチャットリクエストを送信
  2. 02GPU と CPU のハードウェア証明を検証
  3. 03チャット署名を証明済み鍵と照合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/near/agent-skills --skill near-ai-cloud

インストール後、Claude Code で/near-ai-cloudを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
chat-verification.md
e2ee-chat.md
gateway-verification.md
model-verification.md
private-vs-anonymised.md
specialized-endpoints.md

詳細

NEAR AI Cloud

Trusted Execution Environment(TEE)を通じた検証可能なプライベート AI 推論です。すべての推論は NVIDIA TEE GPU を備えた Intel TDX の機密 VM 内で実行されます。データは暗号化され、インフラプロバイダー、モデルプロバイダー、NEAR 自身から隔離された状態に保たれます。

クイックスタート

API は OpenAI 互換です。任意の OpenAI SDK で https://cloud-api.near.ai/v1 を指定してください。

import openai

client = openai.OpenAI(
    base_url="https://cloud-api.near.ai/v1",
    api_key="YOUR_API_KEY"  # from cloud.near.ai dashboard
)

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.1",
    messages=[{"role": "user", "content": "Hello, NEAR AI!"}]
)
print(response.choices[0].message.content)
import OpenAI from 'openai';

const openai = new OpenAI({
    baseURL: 'https://cloud-api.near.ai/v1',
    apiKey: 'YOUR_API_KEY',
});

const completion = await openai.chat.completions.create({
    model: 'deepseek-ai/DeepSeek-V3.1',
    messages: [{ role: 'user', content: 'Hello, NEAR AI!' }]
});
console.log(completion.choices[0].message.content);

仕組み

  • すべての推論は NVIDIA TEE GPU を備えた Intel TDX の機密 VM 内で実行されます
  • TLS はロードバランサーではなく TEE 内部で終端されるため、プロンプトが平文で公開されることはありません
  • TEE は、NVIDIA NRAS と Intel TDX を通じて検証可能な暗号学的アテステーション証明を生成します
  • すべてのチャット応答は、TEE の外に持ち出されることのない鍵で署名されます
  • ハードウェアアテステーションを独自に検証し、メッセージ署名と紐付けることができます

検証フロー

1. Generate nonce
2. Request model attestation  →  get signing_address, nvidia_payload, intel_quote
3. Verify GPU attestation     →  submit nvidia_payload to NVIDIA NRAS, check JWT fields
4. Verify CPU attestation     →  verify intel_quote via dcap-qvl or TEE Explorer
5. Verify GPU-CPU binding     →  signing_address + nonce bound in TDX report data; same nonce in NRAS eat_nonce
6. Make chat request           →  use the API as normal
7. Fetch chat signature       →  GET /v1/signature/{chat_id}
8. Verify signature            →  recover signer, compare to attested signing_address

API エンドポイント

ベース URL:https://cloud-api.near.ai

エンドポイントメソッド説明
/v1/chat/completionsPOSTOpenAI 互換のチャット補完
/v1/modelsGET利用可能なモデルの一覧
/v1/attestation/report?model={model}GETモデルアテステーション(GPU + CPU)— API キーが必要です
/v1/attestation/reportGETゲートウェイアテステーション — API キーが必要です
/v1/signature/{chat_id}GETチャットメッセージの署名(Responses API の resp_* も対象)

重要事項

  • ベース URL は https://cloud-api.near.ai/v1 です — 任意の OpenAI SDK で使用できます
  • signing_algo には ecdsa または ed25519 を指定できます
  • アテステーションレポートの取得に API キーが必要になりました — Authorization: Bearer <key>。取得は無料で、課金対象ではありません
  • アテステーションの鮮度を確保するため、nonce にはランダムな 64 文字の 16 進数文字列(32 バイト)を指定してください
  • NRAS の応答は 2 部構成の配列です:[["JWT", "..."], {"GPU-0": "..."}] — 全体の JWT と GPU ごとの JWT
  • モデルアテステーションの signing_address は、チャットメッセージの署名に使用されたアドレスと一致する必要があります
  • チャット署名は永続的に保存され、完了後いつでも照会できます

参考資料

トピックファイル
プライベートモデルと匿名化モデルreferences/private-vs-anonymised.md
モデル TEE の検証references/model-verification.md
ゲートウェイの検証 + TLSreferences/gateway-verification.md
チャットメッセージの検証references/chat-verification.md
エンドツーエンド暗号化チャット(E2EE)references/e2ee-chat.md
特殊なエンドポイントreferences/specialized-endpoints.md

上流ドキュメント(最新の値を優先)

リソース

コメント