> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therefrain.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AI プロバイダーを設定する

> 手順書の生成・実行の前に、AI プロバイダーと API キーを設定します。

## 概要

Refrain は 7つの AI プロバイダーで **BYOK（Bring Your Own Key）** に対応しています。インフラ要件、コンプライアンス、予算に合わせて好きなプロバイダーを選択できます。ベンダーロックインはありません。

## 対応プロバイダー

| プロバイダー           | `--model-provider`  | デフォルトモデル                         | 環境変数                                                       |
| ---------------- | ------------------- | -------------------------------- | ---------------------------------------------------------- |
| Anthropic        | `anthropic`         | `claude-sonnet-4-6`              | `ANTHROPIC_API_KEY`                                        |
| OpenAI           | `openai`            | `gpt-4o`                         | `OPENAI_API_KEY`                                           |
| OpenAI 互換        | `openai-compatible` | `gpt-4o`                         | `OPENAI_COMPATIBLE_BASE_URL` + `OPENAI_COMPATIBLE_API_KEY` |
| Gemini           | `google`            | `gemini-2.5-pro`                 | `GOOGLE_GENERATIVE_AI_API_KEY`                             |
| Azure OpenAI     | `azure`             | `gpt-4o`                         | `AZURE_RESOURCE_NAME` + `AZURE_API_KEY`                    |
| Amazon Bedrock   | `bedrock`           | `anthropic.claude-sonnet-4-6-v1` | `AWS_REGION` + AWS 認証情報                                    |
| Google Vertex AI | `vertex`            | `claude-sonnet-4-6@20250514`     | `GOOGLE_VERTEX_PROJECT` + `GOOGLE_VERTEX_LOCATION`         |

## プロバイダー設定

<Tabs>
  <Tab title="Anthropic（デフォルト）">
    ```bash theme={null}
    export ANTHROPIC_API_KEY="sk-ant-..."
    ```

    Anthropic がデフォルトプロバイダーです。追加のフラグは不要です：

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```

    特定のモデルを指定する場合：

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --model "claude-sonnet-4-6" --model-provider anthropic \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```
  </Tab>

  <Tab title="OpenAI">
    ```bash theme={null}
    export OPENAI_API_KEY="sk-..."
    ```

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --model "gpt-4o" --model-provider openai \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```
  </Tab>

  <Tab title="OpenAI 互換">
    OpenAI 互換エンドポイント（ローカルモデル、カスタムデプロイなど）向け：

    ```bash theme={null}
    export OPENAI_COMPATIBLE_BASE_URL="https://your-endpoint.com/v1"
    export OPENAI_COMPATIBLE_API_KEY="your-key"
    ```

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --model "your-model" --model-provider openai-compatible \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```
  </Tab>

  <Tab title="Gemini">
    ```bash theme={null}
    export GOOGLE_GENERATIVE_AI_API_KEY="..."
    ```

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --model "gemini-2.5-pro" --model-provider google \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```
  </Tab>

  <Tab title="Azure OpenAI">
    ```bash theme={null}
    export AZURE_RESOURCE_NAME="your-resource"
    export AZURE_API_KEY="..."
    ```

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --model "gpt-4o" --model-provider azure \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```

    `AZURE_API_VERSION` でオプションの API バージョンを指定できます。
  </Tab>

  <Tab title="Amazon Bedrock">
    ```bash theme={null}
    export AWS_REGION="us-east-1"
    export AWS_ACCESS_KEY_ID="..."
    export AWS_SECRET_ACCESS_KEY="..."
    ```

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --model "anthropic.claude-sonnet-4-6-v1:0" --model-provider bedrock \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```

    IAM ロールによる認証にも対応しています。インスタンスロールを使用する場合はアクセスキーの変数は不要です。
  </Tab>

  <Tab title="Google Vertex AI">
    ```bash theme={null}
    export GOOGLE_VERTEX_PROJECT="your-project"
    export GOOGLE_VERTEX_LOCATION="us-central1"
    ```

    ```bash theme={null}
    npx @refrainai/cli generate -- \
      --model "claude-sonnet-4-6@20250514" --model-provider vertex \
      --url "https://example.com" --goal "..." --output ./runbook.yaml
    ```

    Application Default Credentials（ADC）が自動的に使用されます。必要に応じて `gcloud auth application-default login` を実行してください。
  </Tab>
</Tabs>

## デフォルトモデル

`--model` と `--model-provider` を毎回指定する代わりに、環境変数でデフォルトを設定できます：

```bash theme={null}
export AI_MODEL_ID="claude-sonnet-4-6"
export AI_MODEL_PROVIDER="anthropic"
```

| 変数                  | 説明               |
| ------------------- | ---------------- |
| `AI_MODEL_ID`       | デフォルトの AI モデル ID |
| `AI_MODEL_PROVIDER` | デフォルトの AI プロバイダー |

## 次のステップ

<CardGroup cols={2}>
  <Card title="手順書を生成する" icon="wand-magic-sparkles" href="/ja/guides/generate-runbook">
    AI で最初の手順書を構築。
  </Card>

  <Card title="手順書を実行する" icon="play" href="/ja/guides/execute-runbook">
    生成した手順書を実行。
  </Card>
</CardGroup>