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

# 빠른 시작

> 다양한 AI 모델에 접근하기 위해 APIYI를 단 세 단계로 시작하세요.

## 1단계: 계정 설정

### 1.1 계정 등록

등록하려면 [APIYI 웹사이트](https://api.apiyi.com)를 방문하십시오.

* 이메일로 등록합니다(대학 또는 회사 이메일 권장)
* 이메일 주소를 인증합니다
* 콘솔에 로그인합니다

### 1.2 계정 충전

콘솔에서 계정을 충전합니다.

1. "충전" 메뉴를 클릭합니다
2. 충전 금액을 선택합니다(최소 \$5이며, 금액이 클수록 보너스가 더 많습니다, [프로모션 정책 보기](/ko/faq/recharge-promotions))
3. 결제를 완료합니다(Alipay, WeChat 지원)

<Note>
  새 사용자는 첫 충전 시 추가 보너스를 받습니다. 잔액은 즉시 적립됩니다. 첫 번째 보너스 적립의 경우, 수동 적립을 위해 [Enterprise WeChat으로 문의하십시오](https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec).
</Note>

## 2단계: API Key 생성

### 2.1 Key 생성

1. 백엔드 내비게이션에서 “토큰” 섹션을 클릭합니다: [https://api.apiyi.com/token](https://api.apiyi.com/token)
2. \[기본 토큰]을 직접 복사할 수 있습니다(오른쪽에 복사 아이콘이 있습니다)
3. 또는 새 토큰을 생성할 수 있습니다: 오른쪽 상단의 “새로 만들기” 버튼을 클릭하고, 키 이름을 입력한 다음(예: test-key), 확인을 클릭하여 새 토큰을 생성합니다.

## 3단계: 호출 시작

### 3.1 액세스 정보 가져오기

* **API 주소 (Base\_Url)**: `https://api.apiyi.com`
* **API Key**: 방금 생성한 키
* **요청 형식**: 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="/ko/api-manual">
    전체 API 인터페이스 문서를 알아봅니다
  </Card>

  <Card title="모델 목록 살펴보기" icon="bot" href="/ko/api-capabilities/model-info">
    지원되는 모든 AI 모델을 확인합니다
  </Card>

  <Card title="앱에 통합하기" icon="plug" href="/ko/scenarios/engineering/langchain">
    APIYI를 다양한 도구에 통합합니다
  </Card>

  <Card title="사용 통계 보기" icon="chart-line" href="https://api.apiyi.com/log">
    콘솔에서 사용량을 모니터링합니다
  </Card>
</CardGroup>

## 자주 묻는 질문

### 모델을 어떻게 전환합니까?

요청에서 `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](/ko/api-capabilities/balance-query): API를 통해 계정 잔액, 만료일 등 확인
* [잔액 알림 설정](/ko/faq/balance-alerts): 잔액이 부족할 때 자동 알림을 받아 서비스 중단을 방지

### 문제가 발생하면 어떻게 합니까?

1. [API 문서](/ko/api-manual)를 확인하십시오
2. [자주 발생하는 오류](/ko/faq/invalid-api-key)를 검토하십시오
3. 지원팀에 문의하십시오: [support@apiyi.com](mailto:support@apiyi.com)

<Info>
  팁: API 키는 안전하게 보관하고 콘솔에서 사용 로그를 정기적으로 확인하십시오. 모든 요청에는 비용 최적화를 위한 메시지 기록이 있습니다.
  즐겁게 사용하시기 바랍니다!
</Info>