> ## 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 всего за три простых шага, чтобы получить доступ к различным моделям ИИ.

## Шаг 1: Настройка аккаунта

### 1.1 Регистрация аккаунта

Перейдите на [сайт APIYI](https://api.apiyi.com), чтобы зарегистрироваться:

* Зарегистрируйтесь с помощью email (рекомендуется университетский или корпоративный email)
* Подтвердите адрес email
* Войдите в консоль

### 1.2 Пополнение аккаунта

Пополните ваш аккаунт в консоли:

1. Нажмите меню «Пополнение»
2. Выберите сумму пополнения (минимум \$5, при более крупных суммах вы получите больше бонусов, [смотрите политику акций](/ru/faq/recharge-promotions))
3. Завершите оплату (поддерживаются Alipay, WeChat)

<Note>
  Новые пользователи получают дополнительный бонус при первом пополнении. Баланс зачисляется сразу. Для бонусных кредитов при первом пополнении [свяжитесь с нами в Enterprise WeChat](https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec) для ручного зачисления.
</Note>

## Шаг 2: Создайте API Key

### 2.1 Сгенерируйте Key

1. В навигации бэкенда нажмите раздел «Token»: [https://api.apiyi.com/token](https://api.apiyi.com/token)
2. Вы можете напрямую скопировать \[Default Token] (справа есть иконка Copy)
3. Или создайте новый token: нажмите кнопку «New» в правом верхнем углу, задайте имя вашему key (например, test-key), нажмите подтверждение, чтобы создать новый token.

## Шаг 3: Начало вызовов

### 3.1 Получите информацию для доступа

* **Адрес API (Base\_Url)**: `https://api.apiyi.com`
* **API Key**: The key you just created
* **Формат запроса**: Полностью совместим с форматом 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="/ru/api-manual">
    Ознакомиться с полной документацией интерфейса API
  </Card>

  <Card title="Ознакомиться со списком моделей" icon="bot" href="/ru/api-capabilities/model-info">
    Просмотреть все поддерживаемые модели ИИ
  </Card>

  <Card title="Интегрировать в приложения" icon="plug" href="/ru/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 запроса баланса](/ru/api-capabilities/balance-query): Получите баланс аккаунта, дату истечения срока и многое другое через API
* [Настройка уведомлений о балансе](/ru/faq/balance-alerts): Автоматически уведомляйте при низком балансе, чтобы избежать прерывания сервиса

### Что делать, если я столкнулся с проблемами?

1. Проверьте [API Documentation](/ru/api-manual)
2. Ознакомьтесь с [Common Errors](/ru/faq/invalid-api-key)
3. Свяжитесь со службой поддержки: [support@apiyi.com](mailto:support@apiyi.com)

<Info>
  Совет: надежно храните свой API key и регулярно проверяйте журналы использования в консоли. Для оптимизации затрат у каждого запроса сохраняется история сообщений.
  Удачного использования!
</Info>