ガイド
- クイックスタート
- 認証とキー
- キーの保護
- モデル、エイリアス、フォールバック
- モデルの自動選択(silicon/auto)
- チャット補完
- ストリーミング
- 構造化出力とツール
- Logprobs
- ビジョン
- Responses、Claude、Ollama
- 埋め込み、リランク、音声、画像
- ファイルとバッチ
- ドキュメントと検索
- LoRA アダプター
- プロジェクトタグとコスト
- プレフィックスキャッシュ
- ヘッダー、レート制限、利用上限
- エラー
- Versioning and the sandbox
- プライバシーとデータ保持
- 検証可能なレシート
- データレジデンシー
- 料金
- 課金
- リクエストごとの支払い(x402)
- オンチェーンオラクル
- エージェントクレジット(裏付けのあるコンピュートライン)
- ステータス
- SDK
- Swift SDK
- 連携
- ノードを運用する
- Linux エージェント
- コンピュート API
- アーキテクチャ
- 変更履歴
- 用語集
API リファレンス
オペレーターガイド
Linux エージェント
ノードエージェントを使うと、承認されたオペレーターは Linux の GPU マシンやサーバーを、AI 推論以外の作業(レンダリング、学習ジョブ、マイニング、将来的にはサーバー)に提供できます。各ジョブはお使いのマシン上でコンテナとして実行され、コントロールプレーンに報告されます。
無効: 作業を受け付けていません
エージェントは実装済みですが、ネットワークはまだ Linux エージェントを受け付けておらず、ジョブも送りません。現在エージェントを起動しても、登録も実行も行われません。Linux エージェントが無効であることをログに記録し、10 分ごとに再確認します。支払いも無効です。このページでは、有効になった後の動作を説明します。
できること
- オペレーター認証情報(
snop_...)を使い、HTTPS でコントロールプレーンに接続します。これはエンジンノードが使うものと同じです。ポートは開きません。 - マシンの情報を通知します。CPU、メモリ、GPU(モデルと VRAM。
nvidia-smiまたはrocm-smiで取得)、空きディスク、リージョン、選択した作業内容と価格です。 - ジョブを取得し、Podman または Docker のコンテナで実行し、ログを送信し、1 分ごとに使用量を報告します。ネットワークからの停止要求、ジョブの終了、制限時間の到達のいずれかでジョブを停止します。
ジョブの分離方法
すべてのジョブは次の設定で実行されます。設定はエージェントが行い、顧客は変更できません。
- 特権モードなし、ホストのネットワーク、プロセス、IPC、ユーザー名前空間なし、公開ポートなし、ジョブ専用の作業ディレクトリ以外のホストパスなし
- すべての capability を削除、新しい権限の取得なし、非特権ユーザー、読み取り専用のルートファイルシステム
- お客様が設定した CPU、メモリ、プロセス、共有メモリの上限と、厳格な制限時間
- GPU は許可した場合のみ
- イメージはダイジェスト指定のみ。環境変数は専用ファイル経由で渡し、コマンドラインには載せません
作業ごとのネットワーク
レンダリングと学習のジョブは、外向きの通信を許可しない限りネットワークを使えません。マイニングは専用ネットワーク上で外向きの通信のみ可能です。サーバーは Silicon Network のリレー経由でのみ受信するよう設計されていますが、その経路はまだ実装されていないため、ネットワークはオペレーターのマシン上のサーバーをまだ提供していません。
ジョブはお客様自身が実行するため、そのコマンドと環境変数を確認できます。作業ディレクトリ内のディスク使用量には上限がありません。ジョブが容量を使い切っても問題ないボリュームに、エージェントの状態ディレクトリを置いてください。
価格と収益
作業ごとに価格を自分で設定します。学習とレンダリングは GPU 1 時間あたりの USD、マイニングとサーバーは 1 時間あたりです。ネットワークは、オンラインのマシンのオファーとしてのみ価格を表示し、市場価格としては表示しません。各ジョブの時間はコントロールプレーンが自ら計測し、その計測値とエージェントの計測値のうち小さいほうを請求します。支払いが無効の間は、完了した作業は保留中の収益として表示されるだけです。
インストール
Linux(x86_64 または arm64)、Python 3.11 以降、Podman 4 または Docker 24 以降が必要です。NVIDIA GPU には NVIDIA Container Toolkit、AMD GPU には ROCm が必要です。まずダッシュボードの Nodes ページでオペレーターになってください。詳しい手順、設定例、systemd ユニットは、リポジトリの node-agent/README.md にあります。
# as root, on the Linux machinegit clone https://github.com/ekempinski/siliconnetwork /opt/silicon-node-agentpython3 -m venv /opt/silicon-node-agent/.venv/opt/silicon-node-agent/.venv/bin/pip install --require-hashes \ -r /opt/silicon-node-agent/node-agent/requirements.txt # the credential, readable by root onlyinstall -d -m 700 /etc/silicon-node-agentsh -c 'umask 077; printf "%s\n" "snop_..." > /etc/silicon-node-agent/credential' # the config: accepts nothing until you list workloads and pricescp /opt/silicon-node-agent/node-agent/agent.example.toml /etc/silicon-node-agent/agent.toml # check the config and the hardware (sends nothing)cd /opt/silicon-node-agent/node-agent/opt/silicon-node-agent/.venv/bin/python -m silicon_node_agent check/opt/silicon-node-agent/.venv/bin/python -m silicon_node_agent detect作業内容を列挙し、それぞれに価格を設定するまで、設定は何も受け付けません。check と detect は何も送信しません。
Mac で AI 推論を提供するには、ノードを運用するをご覧ください。