Tailscaleロゴ

Apertureを使い始める

サインアップ・プロバイダー設定・テストリクエストのクイックスタート

最終検証日：
翻訳: 竹洞 陽一郎

Aperture by Tailscaleは、現在ベータ版です。

ベータ期間中、Aperture by Tailscaleは、Apertureのサインアップ時に作成される無料アカウントを含め、どのTailscaleアカウントでも追加費用なしで利用できます。
aperture.tailscale.com からアクセスを申請してください。

このガイドでは、Apertureへのサインアップ、最初のLLMプロバイダーの設定、すべてが正しく動作することを確認するためのテストリクエストの送信について、順を追って説明します。
始める前にApertureが何をするのかをより詳しく知りたい場合は、Apertureとは？を参照してください。

前提条件

始める前に、次のものが揃っていることを確認してください。

ステップ1: Apertureにサインアップする

  1. aperture.tailscale.com にアクセスし、サインアップフォームに記入します。Tailscaleアカウントを持っていない場合は、サインアップの過程で無料アカウントが作成されます。
  2. お使いのデバイスから、Apertureダッシュボード（http://<aperture-hostname>/ui）にアクセスできることを確認します。

ステップ2: LLMプロバイダーを設定する

Apertureダッシュボード（http://<aperture-hostname>/ui）を開き、「設定（Settings）」ページに移動して、少なくとも1つのLLMプロバイダーを追加します。

「設定」ページには、2つの編集モードがあります。 

{
  "providers": {
    "anthropic": {
      "baseurl": "https://api.anthropic.com",
      "apikey": "<anthropic-api-key>",
      "models": [
        "claude-sonnet-4-6",
        "claude-opus-4-7"
      ],
      "authorization": "x-api-key",
      "compatibility": {
        "anthropic_messages": true
      }
    }
  }
}

プロバイダーごとの手順については、LLMプロバイダーをセットアップするを参照してください。
利用可能なすべての設定については、構成リファレンスを参照してください。

このステップを省略した場合、Apertureは、一般的なモデルを含むOpenAIとAnthropicのデフォルト設定を使用します。
ただし、リクエストを成功させるには、自分のAPIキーを追加する必要があります。

ステップ3: テストリクエストを送信する

tailnet内のデバイスからリクエストを送信して、Apertureがプロバイダーへルーティングしていることを確認します。
サポートされているいずれのAPI形式でもテストできます。
モデル名は、ステップ2で設定したモデルに置き換えてください。

Anthropic API形式:

curl -s http://<aperture-hostname>/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "max_tokens": 25,
    "messages": [{"role": "user", "content": "respond with: hello"}]
  }'

OpenAI Chat API形式:

curl -s http://<aperture-hostname>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "respond with: hello"}]
  }'

OpenAI Responses API形式:

curl -s http://<aperture-hostname>/v1/responses \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": [{"role": "user", "content": "respond with: hello"}]
  }'

リクエストが成功すれば、Apertureはプロバイダーへルーティングしています。
Apertureダッシュボード（http://<aperture-hostname>/ui）を開き、利用履歴でそのリクエストを確認してください。

デバイスがtailnetに参加していない場合は、ts-unplug経由で接続し、上記の例の http://<aperture-hostname> を http://localhost:<port-number> に置き換えてください。

次のステップ

プロバイダーが動作することを確認したら、Apertureを最大限に活用するために、以下の機能を確認してください。