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

# FAQ 概要

> APIYI のよくある質問の完全な索引です。開始方法、モデル呼び出し、token とログ、課金、エンタープライズサービス、アカウントログインを、トピック別または症状別に参照できます。

APIYI の FAQ 記事はすべてここに索引されています。APIYI を初めてご利用ですか？ **はじめに** と **よくある質問** から始めてください。すでに連携済みで、特定のエラーに遭遇していますか？ **症状別トラブルシューティング** に進んでください。すべて読み通したいですか？ 下の **トピック別に見る** をご覧ください。

## 🚀 3ステップで始める

<CardGroup cols={3}>
  <Card title="ステップ1: 登録" icon="mail" href="/ja/faq/email-registration">
    Gmail、Outlook、Foxmail、大学のメールアドレスに対応しています。GitHubでサインインすることもできます
  </Card>

  <Card title="ステップ2: KEYを作成" icon="key" href="/ja/faq/token-management">
    コンソールからデフォルトの token を取得するか、専用の KEY を作成して、そのグループを選択します
  </Card>

  <Card title="ステップ3: ベース URLを設定" icon="link" href="/ja/faq/base-url-config">
    OpenAI 形式では `/v1` を、Claude ではルートドメインを、Gemini では `/v1beta` を使用します
  </Card>
</CardGroup>

## 🔥 よくある質問

<CardGroup cols={2}>
  <Card title="KEY を作成するには？" icon="key" href="/ja/faq/token-management">
    デフォルト token の取得と新しい KEY の作成を、手順を追って解説します
  </Card>

  <Card title="Base URL の設定方法は？" icon="link" href="/ja/faq/base-url-config">
    `/v1`、ルートドメイン、または `/v1beta` のどれがどのモデルに適用されるか
  </Card>

  <Card title="適切な AI モデルはどう選べばよいですか？" icon="compass" href="/ja/faq/model-selection-guide">
    用途、コスト、速度でモデルを選ぶ方法
  </Card>

  <Card title="なぜ API Key が無効なのですか？" icon="triangle-alert" href="/ja/faq/invalid-api-key">
    10回中9回は Base URL と KEY の組み合わせが一致していません — まずここを確認してください
  </Card>

  <Card title="残高があるのにリクエストを実行できないのはなぜですか？" icon="credit-card" href="/ja/faq/balance-insufficient">
    事前差し引きの仕組みと、過大な max\_tokens 値
  </Card>

  <Card title="モデルのレート倍率はどういう意味ですか？" icon="calculator" href="/ja/faq/model-multiplier">
    レート倍率は RMB 基準です — 固定レートを適用して USD 換算値を求めます
  </Card>

  <Card title="どのチャージ特典がありますか？" icon="gift" href="/ja/faq/recharge-promotions">
    初回チャージ特典、段階別特典、エンタープライズ向けポリシー
  </Card>

  <Card title="Web アプリと API が異なるのはなぜですか？" icon="layers" href="/ja/faq/webapp-vs-api-difference">
    同じモデルでも、公式サイトでは API 経由より賢く感じるのはなぜか
  </Card>
</CardGroup>

***

## 🔧 症状別のトラブルシューティング

実際に見えている症状に一致する行を探してください。1つの症状が複数のトピックにまたがることがあるため、この表では観測できる挙動ごとにトラブルシューティング記事を再整理しています。

| 見えている内容                                   | 考えられる原因                                      | 確認先                                                                                                             |
| ----------------------------------------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| API Key が無効 / 401                         | Base URL と KEY が一致していない、または KEY の入力ミス        | [無効な API Key](/ja/faq/invalid-api-key) · [Base URL の設定](/ja/faq/base-url-config)                                |
| 残高があるのにリクエストが失敗する                         | 事前差し引きの仕組み、または max\_tokens の設定が大きすぎる         | [残高不足](/ja/faq/balance-insufficient) · [事前差し引き](/ja/faq/pre-deduction-quota)                                    |
| リクエストがタイムアウトする、またはストリーミング中に切断される          | クライアントのタイムアウトが短すぎる；推論モデルは遅い                  | [API タイムアウトの回避](/ja/faq/timeout-configuration)                                                                  |
| 429 の同時実行数エラー                             | 同時実行数のクォータに達した                               | [API の同時実行数制限](/ja/faq/api-concurrency)                                                                         |
| 出力が文の途中で切れる                               | max\_tokens が未設定、または小さすぎる                    | [max\_tokens とは](/ja/faq/max-tokens)                                                                            |
| 特定のモデルが動作しない                              | アカウント権限がロックされている、または token model のホワイトリストにない | [一部のモデルを使えないのはなぜか](/ja/faq/model-availability) · [token model のホワイトリスト](/ja/faq/token-model-whitelist)          |
| 画像生成が失敗する / 空の結果が返る                       | Google のコンテンツ安全フィルターが作動した                    | [Nano Banana の失敗](/ja/faq/nano-banana-image-failure)                                                            |
| 出力が参照画像と大きく異なる                            | 参照画像は base64 でアップロードする必要がある                  | [画像が参照と異なる](/ja/faq/image-result-differs-from-reference)                                                        |
| 白背景の画像に黒い点が出る                             | AI Studio ルートでの既知の挙動                         | [白背景のアーティファクト](/ja/faq/white-background-image-artifacts)                                                        |
| タスク ID で画像結果をポーリングしたい                     | 画像生成は同期のみ                                    | [非同期の画像 API はあるか](/ja/faq/image-async-api)                                                                      |
| モデルが別ベンダーだと主張する / バージョンを明言できない            | モデルの自己認識は信頼できない                              | [Claude が Qwen だと主張する](/ja/faq/claude-identity-confusion) · [モデルは自分のバージョンを知らない](/ja/faq/model-version-identity) |
| Web アプリは賢いのに、API はそうでもない                  | Web アプリにはシステムプロンプトとツールが含まれているが、API は素のモデル    | [Web アプリと API の違い](/ja/faq/webapp-vs-api-difference)                                                            |
| 見覚えのない呼び出しが KEY にある                       | KEY が漏えいしている可能性がある — 追跡して無効化する               | [予期しない KEY の使用を調査する](/ja/faq/troubleshoot-key-usage) · [キーを安全に管理する](/ja/faq/key-security-management)            |
| 課金が合わない                                   | 使用量ベースと呼び出しごとの課金が異なって見える                     | [ログで課金を読む](/ja/faq/log-billing-explained) · [モデルの倍率](/ja/faq/model-multiplier)                                  |
| 画像または動画のダウンロードが遅い                         | 特定のサーバーで海外 CDN ルーティングが発生している                 | [CDN のダウンロードが遅い](/ja/faq/cdn-download-slow)                                                                     |
| プロキシは必要か                                  | 直接接続で動作するため、プロキシは不要                          | [プロキシは必要か](/ja/faq/network-proxy)                                                                               |
| GitHub ログインで「Account already bound」と表示される | その GitHub アカウントは別のメールアドレスに紐付いている             | [GitHub の紐付けエラー](/ja/faq/github-bindng-bindng-error)                                                            |
| パスワードを忘れた                                 | メールでリセットするか、サポートに सहायता を求める                | [パスワードを忘れた](/ja/faq/forgot-password)                                                                            |

***

## 📚 トピック別に見る

### 🧭 サイトの機能 (3)

| 質問                                                                               | 一言で                                   |
| -------------------------------------------------------------------------------- | ------------------------------------- |
| [Tokens & Groups](/ja/faq/token-and-groups)                                      | KEYを作成してグループを選ぶ方法                     |
| [What is a Group? User Group vs Token Group Explained](/ja/faq/groups-explained) | tokenに選択されたグループが実際に適用されます             |
| [Why Doesn't APIYI Offer One-Click Integration?](/ja/faq/one-click-integration)  | モデルごとに統合方法が異なるため、代わりにAIアシスタントをお使いください |

### ⚙️ モデルとAPI (15)

| 質問                                                                                       | 一言で                                  |
| ---------------------------------------------------------------------------------------- | ------------------------------------ |
| [GoogleのモデルはAI StudioまたはVertexで動作しますか？](/ja/faq/google-upstream-aistudio-vertex)         | デフォルトのグループは公式のAI Studioルートを使用します     |
| [白背景の画像に黒い斑点、汚れたような部分、またはぼやけた色ブロックが出るのはなぜですか？](/ja/faq/white-background-image-artifacts) | 真っ白ではなく、淡い背景で指示してください                |
| [適切なAIモデルの選び方は？](/ja/faq/model-selection-guide)                                          | ユースケース、コスト、速度で選択します                  |
| [なぜ一部のモデルを使えないのですか？](/ja/faq/model-availability)                                         | 一部のモデルは、まず権限の解除が必要です                 |
| [なぜ公式WebアプリとAPIで結果が異なるのですか？](/ja/faq/webapp-vs-api-difference)                           | Webアプリはシステムpromptを追加しますが、APIは素のモデルです |
| [AIモデルはなぜ自分のバージョンを知らないのですか？](/ja/faq/model-version-identity)                             | モデル自身の認識は信頼できません                     |
| [なぜClaudeがQwenやDeepSeekだと主張するのですか？](/ja/faq/claude-identity-confusion)                   | モデルの差し替えではなく、本人性の幻覚です                |
| [モデル名の -c サフィックスは何を意味しますか？](/ja/faq/model-name-suffix-c)                                 | 課金が異なる別ルートを示します                      |
| [Base URLの設定方法は？ /v1、ルートドメイン、/v1beta の違い](/ja/faq/base-url-config)                       | OpenAI、Claude、Gemini それぞれに1つの形式があります |
| [APIのタイムアウトを避けるにはどうすればよいですか？](/ja/faq/timeout-configuration)                             | クライアントのタイムアウトを長くします。推論モデルは遅いです       |
| [APIの同時実行数の制限は何ですか？](/ja/faq/api-concurrency)                                            | 制限はモデルの種類によって異なり、引き上げ可能です            |
| [max\_tokensとは何ですか？ 未設定だとどうなりますか？](/ja/faq/max-tokens)                                   | 出力長の上限です。未設定の場合はデフォルトがあります           |
| [Nano Bananaの画像生成失敗によくある原因](/ja/faq/nano-banana-image-failure)                           | 多くはGoogleのコンテンツ安全機能が発動しているためです       |
| [生成画像が参照画像と大きく異なるのはなぜですか？](/ja/faq/image-result-differs-from-reference)                  | 参照画像はbase64でエンコードする必要があります           |
| [非同期画像APIはありますか？ タスクIDで結果を照会できますか？](/ja/faq/image-async-api)                             | 同期のみで、タスクIDの照会はできません                 |

### 🔑 Tokens とログ (9)

| Question                                                              | 一行で                               |
| --------------------------------------------------------------------- | --------------------------------- |
| [KEY はどう作成しますか？](/ja/faq/token-management)                            | デフォルトの token を取得するか、コンソールで新規作成します |
| [token に利用可能モデルを設定する必要はありますか？](/ja/faq/token-model-whitelist)         | 任意ですが、プロジェクトを分離する場合は推奨です          |
| [API Key を安全に管理するにはどうすればよいですか？](/ja/faq/key-security-management)      | IP ホワイトリスト、モデルのホワイトリスト、日々の習慣です    |
| [token 課金モードの違いは何ですか？](/ja/faq/token-billing-modes)                   | 5つの課金モードと、それぞれが適する場面です            |
| [自分の呼び出し記録を確認するにはどうすればよいですか？](/ja/faq/call-logs)                      | コンソールのログページで呼び出しと課金の詳細を確認できます     |
| [ログの課金額はどう読み取ればよいですか？](/ja/faq/log-billing-explained)                 | 使用量ごとか呼び出しごとか、使用量からコストを算出する方法です   |
| [呼び出しログはどれくらい保持され、いつクリアされますか？](/ja/faq/log-retention-policy)          | 現在の月と直前の2か月分で、5日にクリアされます          |
| [トラブルシューティングのためにバックエンドで詳細ログを表示できますか？](/ja/faq/user-logs-control)      | 管理者は一時的に詳細ログを有効化できます              |
| [予期しない API Key の使用を調査するにはどうすればよいですか？](/ja/faq/troubleshoot-key-usage) | ログで実際の IP を追跡し、KEY を無効化します        |

### 🏢 エンタープライズサービス (7)

| 質問                                                                            | ひとことで                            |
| ----------------------------------------------------------------------------- | -------------------------------- |
| [Enterprise グループとは何ですか？ いつ使うべきですか？](/ja/faq/enterprise-group-vertex-fallback) | モデルごとのグループで、供給がより安定し、レート倍率が高いです  |
| [APIYI のエンタープライズサービスは信頼できますか？ モデルは本物ですか？](/ja/faq/enterprise-trust)           | 透明な公式リレーで、ルーティング変更やモデル差し替えはありません |
| [エンタープライズユーザーと個人ユーザーの違いは何ですか？](/ja/faq/enterprise-vs-individual)              | アカウントの種類は同じで、違いはサポートと価格設定にあります   |
| [エンタープライズのお客様はどうやってチャージしますか？](/ja/faq/enterprise-recharge)                    | 銀行振込を推奨し、VAT請求書に対応しています          |
| [大学のお客様は、安心して精算するにはどうすればよいですか？](/ja/faq/university-reimbursement)             | 請求書、購入明細書、押印書類をご用意します            |
| [APIYI は SLA 保証を提供していますか？](/ja/faq/sla-guarantee)                             | はい。課金異常の補償とクレジットの補充を含みます         |
| [Agent ミニプログラムにはアルゴリズム届出が必要ですか？](/ja/faq/agent-miniapp-algorithm-filing)      | 通常は必要です。一般的な手続きをここで案内します         |

### 💰 課金とセキュリティ (14)

| 質問                                                               | 一言で                                     |
| ---------------------------------------------------------------- | --------------------------------------- |
| [公式料金と同じなら、なぜAPIYIで買うのですか？](/ja/faq/official-pricing-advantages) | 公式と同じ価格にチャージ特典が付き、グループ割引とも併用可能です        |
| [APIYIはどうして公式料金より安いのですか？](/ja/faq/why-cheaper-than-official)     | 一括購入とベンダー分配で、モデルの品質低下はありません             |
| [モデルの「倍率」とは何を意味しますか？](/ja/faq/model-multiplier)                  | RMB建ての単位です。USD換算には固定レートを適用します           |
| [100 RMB でどれだけの計算能力が得られますか？](/ja/faq/rmb-to-computing-power)     | 換算比率はお使いのシステム側で決まります                    |
| [APIYI はキャッシュ課金に対応していますか？](/ja/faq/cache-billing)                | 主要なルートはすべて対応しており、キャッシュヒット率はベンダーごとに異なります |
| [API 呼び出しの事前控除メカニズムとは何ですか？](/ja/faq/pre-deduction-quota)         | 事前に見積もって控除し、実際の利用量で精算します                |
| [残高があるのにリクエストを実行できないのはなぜですか？](/ja/faq/balance-insufficient)      | 事前控除のチェック、または max\_tokens の設定が高すぎるためです  |
| [残高アラートはどう設定しますか？](/ja/faq/balance-alerts)                       | メール、グループボット、または残高アラート API で設定できます       |
| [APIYI はどの支払い方法に対応していますか？](/ja/faq/payment-methods)              | WeChat、Alipay、USDT、Stripe、PayPal などです   |
| [どのチャージ特典がありますか？](/ja/faq/recharge-promotions)                   | 初回特典や段階別ボーナス、請求書発行に対応しています              |
| [代理店パートナーはどう申し込みますか？友達紹介でリベートを得られますか？](/ja/faq/referral-program) | 紹介報酬は標準で有効です。申し込みは不要です                  |
| [APIYI の返金ポリシーとは何ですか？](/ja/faq/refund-policy)                    | 条件、手続き、手数料、請求書に関する注意事項です                |
| [コンテンツの安全性とコンプライアンスはどのように確保されますか？](/ja/faq/content-safety)       | モデレーションの仕組みと違反対応です                      |
| [APIYI はどのようにデータセキュリティを確保していますか？](/ja/faq/data-security)         | 暗号化された転送、最小限の保存、アクセス制御です                |

### 🌐 ネットワークと接続 (3)

| 質問                                                                | 一言で                         |
| ----------------------------------------------------------------- | --------------------------- |
| [API を使うのにプロキシは必要ですか？](/ja/faq/network-proxy)                     | 直接接続で利用できます。プロキシやVPNは不要です   |
| [APIYI のサーバーはどこにありますか？ どのサーバーを選べばよいですか？](/ja/faq/server-location) | ノードの設置場所、レイテンシー測定、購入のアドバイス  |
| [CDN の画像/動画ダウンロードが遅い場合はどうすればよいですか？](/ja/faq/cdn-download-slow)    | 特定サーバーでの海外 CDN ルーティングを診断します |

### 👤 アカウントとログイン (6)

| 質問                                                                                  | 1行での回答                             |
| ----------------------------------------------------------------------------------- | ---------------------------------- |
| [APIYI は登録にどのメールプロバイダーをサポートしていますか?](/ja/faq/email-registration)                     | Gmail、Outlook、Foxmail、大学のメールアドレスです |
| [Passkey でのサインイン方法は?](/ja/faq/passkey-login)                                        | 一度連携すれば、指紋認証または顔認証で使用できます          |
| [GitHub ログインで「アカウントはすでに連携されています」と表示されるのはなぜですか?](/ja/faq/github-bindng-bindng-error) | その GitHub アカウントは別のメールアドレスに連携されています |
| [パスワードを忘れた場合はどうすればよいですか?](/ja/faq/forgot-password)                                  | メールでリセットするか、サポートに помощиを依頼してください  |
| [なぜ私の API Key は無効なのですか?](/ja/faq/invalid-api-key)                                   | Base URL と KEY の不一致が原因であることがほとんどです |
| [アカウントを削除するにはどうすればよいですか?](/ja/faq/account-deletion)                                 | ワンクリックで削除できます。データは復元できません          |

***

## 💬 まだお困りですか？

<CardGroup cols={2}>
  <Card title="ユースケース" icon="layout-grid" href="/ja/scenarios">
    Cherry Studio、Claude Code、Cursor などの統合ガイド
  </Card>

  <Card title="モデル料金" icon="circle-dollar-sign" href="/en/models">
    すべてのモデルのライブ料金表と詳細ページ
  </Card>

  <Card title="最新情報" icon="radio-tower" href="/en/live/index">
    モデルの状態、供給変更、障害に関する日次更新
  </Card>

  <Card title="お知らせ" icon="megaphone" href="/en/changelog">
    新モデルのリリース、価格変更、機能更新
  </Card>
</CardGroup>

まだうまくいきませんか？ 直接お問い合わせください：

* 📧 **Email**: [support@apiyi.com](mailto:support@apiyi.com)
* 🌐 **コンソール**: [api.apiyi.com](https://api.apiyi.com)
* 💰 **料金**: [料金ページ](https://api.apiyi.com/account/pricing)

<Note>
  ご質問がここに含まれていない場合は、サポートまでお送りください。ご提案を確認し、FAQ に追加します。新規ユーザーには無料トライアルのクレジットが付与されるため、チャージ前に統合を検証できます。
</Note>
