near-ai-cloud について
NEAR AI Cloud は、機密 TEE 内でリクエストを処理する OpenAI 互換の推論サービスです。ハードウェア証明とモデル応答に関連する暗号署名を検証したい開発者向けです。
主な機能
- 01OpenAI 互換のチャット補完
- 02Intel TDX 機密 VM 内での推論
- 03NVIDIA TEE GPU のアテステーション
- 04チャット応答への署名
- 05モデル、証明、署名の各エンドポイント
活用シーン
- 01OpenAI SDK からチャットリクエストを送信
- 02GPU と CPU のハードウェア証明を検証
- 03チャット署名を証明済み鍵と照合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ near/ agent-skills --skill near-ai-cloudインストール後、Claude Code で/near-ai-cloudを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/chat-verification.mde2ee-chat.mdgateway-verification.mdmodel-verification.mdprivate-vs-anonymised.mdspecialized-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/completions | POST | OpenAI 互換のチャット補完 |
/v1/models | GET | 利用可能なモデルの一覧 |
/v1/attestation/report?model={model} | GET | モデルアテステーション(GPU + CPU)— API キーが必要です |
/v1/attestation/report | GET | ゲートウェイアテステーション — 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 |
| ゲートウェイの検証 + TLS | references/gateway-verification.md |
| チャットメッセージの検証 | references/chat-verification.md |
| エンドツーエンド暗号化チャット(E2EE) | references/e2ee-chat.md |
| 特殊なエンドポイント | references/specialized-endpoints.md |
上流ドキュメント(最新の値を優先)
- OpenAI 互換性 — ストリーミング、推論、Files API の動作
- ステートレス Responses API —
resp_*ステートレスレスポンス - プロンプトキャッシュ
- ウェブ検索 — サーバー側の最新ウェブ検索結果
- 推論のためのステーキング — ステーキング報酬で支払う
- 使用状況レポート API
- モデルの検出と更新
リソース
- NEAR AI Cloud:https://cloud.near.ai
- ドキュメント:https://docs.near.ai/cloud/introduction-検証例:https://github.com/near-examples/nearai-cloud-verification-example
- 完全版 Verifier:https://github.com/nearai/nearai-cloud-verifier
- NVIDIA NRAS API:https://docs.api.nvidia.com/attestation/reference/attestmultigpu_1
- TEE アテステーションエクスプローラー:https://proof.t16z.com/
- DCAP QVL(TDX 検証):https://github.com/Phala-Network/dcap-qvl
コメント
Markdown 対応