> ## 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.

# クイックスタート

> APIYI を使って、わずか 3 つの簡単なステップでさまざまな AI モデルにアクセスしましょう。

## ステップ 1: アカウント設定

### 1.1 アカウント登録

[APIYIウェブサイト](https://api.apiyi.com) にアクセスして登録してください:

* メールアドレスで登録します（大学または会社のメールアドレスを推奨）
* メールアドレスを認証します
* コンソールにログインします

### 1.2 アカウントのチャージ

コンソールでアカウントにチャージしてください:

1. 「チャージ」メニューをクリックします
2. チャージ金額を選択します（最低 \$5、金額が高いほどボーナスも増えます、[プロモーションポリシーを確認](/ja/faq/recharge-promotions)）
3. 支払いを完了します（Alipay、WeChat に対応）

<Note>
  新規ユーザーは初回チャージ時に追加ボーナスを受け取れます。残高はすぐに反映されます。初回ボーナスの反映については、[Enterprise WeChat でご連絡ください](https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec)。
</Note>

## ステップ 2: API Key を作成

### 2.1 キーを生成

1. バックエンドのナビゲーションで、「Token」セクションをクリックします: [https://api.apiyi.com/token](https://api.apiyi.com/token)
2. \[Default Token] を直接コピーできます（右側に Copy アイコンがあります）
3. または、新しい token を作成します: 右上の「New」ボタンをクリックし、キー名を入力します（例: test-key）。「確認」をクリックして新しい token を作成します。

## ステップ 3: 呼び出しを開始

### 3.1 アクセス情報を取得

* **API アドレス (Base\_Url)**: `https://api.apiyi.com`
* **API Key**: 先ほど作成したキー
* **Request Format**: OpenAI API 形式と完全互換です

### 3.2 テスト呼び出し

curl を使った簡単なテスト:

```bash theme={null}
curl https://api.apiyi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

### 3.3 コード例

<Tabs>
  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://api.apiyi.com/v1"
    )

    response = client.chat.completions.create(
        model="gpt-4.1-mini",
        messages=[
            {"role": "user", "content": "Hello!"}
        ]
    )

    print(response.choices[0].message.content)
    ```
  </Tab>

  <Tab title="Node.js">
    ```javascript theme={null}
    import OpenAI from 'openai';

    const openai = new OpenAI({
      apiKey: 'YOUR_API_KEY',
      baseURL: 'https://api.apiyi.com/v1'
    });

    const response = await openai.chat.completions.create({
      model: 'gpt-4.1-mini',
      messages: [{ role: 'user', content: 'Hello!' }]
    });

    console.log(response.choices[0].message.content);
    ```
  </Tab>

  <Tab title="Java">
    ```java theme={null}
    // Using official OpenAI Java library
    OpenAiService service = new OpenAiService(
        "YOUR_API_KEY",
        Duration.ofSeconds(60),
        "https://api.apiyi.com/v1"
    );

    ChatCompletionRequest request = ChatCompletionRequest.builder()
        .model("gpt-4.1-mini")
        .messages(List.of(
            new ChatMessage(ChatMessageRole.USER, "Hello!")
        ))
        .build();

    ChatCompletionResult result = service.createChatCompletion(request);
    System.out.println(result.getChoices().get(0).getMessage().getContent());
    ```
  </Tab>
</Tabs>

## 次のステップ

おめでとうございます！APIYI の統合に成功しました。次に、以下を行えます。

<CardGroup cols={2}>
  <Card title="APIドキュメントを表示" icon="book" href="/ja/api-manual">
    完全な API インターフェースのドキュメントについて学ぶ
  </Card>

  <Card title="モデル一覧を確認" icon="bot" href="/ja/api-capabilities/model-info">
    対応しているすべての AI モデルを表示
  </Card>

  <Card title="アプリに統合する" icon="plug" href="/ja/scenarios/engineering/langchain">
    APIYI をさまざまなツールに統合する
  </Card>

  <Card title="使用状況統計を確認" icon="chart-line" href="https://api.apiyi.com/log">
    コンソールで使用状況を監視する
  </Card>
</CardGroup>

## FAQ

### モデルを切り替えるには？

リクエスト内の `model` パラメータを変更するだけです。

```json theme={null}
{
  "model": "gpt-4.1",                     // Use GPT-4.1
  "model": "claude-sonnet-4-20250514",    // Use Claude 4 Sonnet
  "model": "gemini-2.5-pro"               // Use Gemini 2.5 Pro
}
```

### どのプログラミング言語がサポートされていますか？

APIYI は OpenAI API 標準と互換性があり、OpenAI SDK がサポートするすべての言語に対応しています。

* Python
* JavaScript/TypeScript
* Java
* C#/.NET
* Go
* Ruby
* PHP
* ほか多数...

### 残高を確認するには？

[コンソール](https://api.apiyi.com/account/profile) にログインすると、以下を確認できます。

* アカウント残高
* 利用履歴
* 消費統計

API からプログラムで照会することもできます。

* [残高照会 API](/ja/api-capabilities/balance-query): API 経由でアカウント残高、有効期限などを取得します
* [残高アラート設定](/ja/faq/balance-alerts): 残高不足時に自動通知し、サービス中断を防ぎます

### 問題が発生した場合は？

1. [API ドキュメント](/ja/api-manual) を確認してください
2. [よくあるエラー](/ja/faq/invalid-api-key) を確認してください
3. サポートに連絡してください: [support@apiyi.com](mailto:support@apiyi.com)

<Info>
  ヒント: API key は安全に保管し、コンソールで利用ログを定期的に確認してください。各リクエストには、コスト最適化のためのメッセージ履歴が含まれています。
  どうぞご利用ください！
</Info>