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

# 빠른 시작

> 세 가지 간단한 단계로 GravitexAI를 시작하세요

## 1단계: 계정 설정

### 1.1 계정 발급

<Note>
  GravitexAI는 **공개 회원가입을 제공하지 않습니다**. 서비스를 이용하려면 BD(Business Development) 팀에 연락하여 계정을 발급받으세요.
</Note>

다음 채널 중 하나를 통해 BD 팀에 연락하세요:

<CardGroup cols={2}>
  <Card title="BD 팀 전화" icon="phone" href="tel:+8613603055233">
    전화: **+86 136 0305 5233**
  </Card>

  <Card title="BD 팀 이메일" icon="envelope" href="mailto:bd@gravitex.ai">
    [bd@gravitex.ai](mailto:bd@gravitex.ai)로 이메일 보내기
  </Card>
</CardGroup>

계정이 발급되면 [GravitexAI 콘솔](https://maas.gravitex.ai)에 접속할 수 있는 로그인 정보를 받게 됩니다.

### 1.2 크레딧 충전

콘솔에 로그인하여 충전하세요:

1. "Personal Center" 클릭
2. "Billing Recharge"를 클릭하여 결제 (Alipay, WeChat 지원)

세금계산서 발행 또는 은행 이체가 필요한 경우 BD 팀에 문의하세요.

## 2단계: API 키 생성

### 2.1 키 생성

1. 네비게이션에서 "Model Center" 클릭
2. "API Keys" 클릭
3. "Create New"를 클릭하여 키 생성

## 3단계: API 호출 시작

### 3.1 연결 정보

| 설정                     | 값                            |
| ---------------------- | ---------------------------- |
| **API URL (Base URL)** | `https://api.gravitex.ai/v1` |
| **API Key**            | 생성한 키                        |
| **요청 형식**              | OpenAI API 완전 호환             |

### 3.2 테스트 호출

curl로 빠르게 테스트:

```bash theme={null}
curl https://api.gravitex.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "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.gravitex.ai/v1"
    )

    response = client.chat.completions.create(
        model="gpt-5.4",
        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.gravitex.ai/v1'
    });

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

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

  <Tab title="Java">
    ```java theme={null}
    OpenAiService service = new OpenAiService(
        "YOUR_API_KEY", 
        Duration.ofSeconds(60), 
        "https://api.gravitex.ai/v1"
    );

    ChatCompletionRequest request = ChatCompletionRequest.builder()
        .model("gpt-5.4")
        .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>

## 다음 단계

축하합니다! GravitexAI 설정이 완료되었습니다. 다음으로 진행할 수 있습니다:

<Columns cols={2}>
  <Card title="API 문서 보기" icon="book" href="/ko/api-reference/introduction">
    전체 API 사양 알아보기
  </Card>

  <Card title="앱 연동" icon="puzzle-piece" href="/ko/integrations/cursor">
    다양한 도구에 GravitexAI 연동
  </Card>
</Columns>

## FAQ

<AccordionGroup>
  <Accordion title="모델을 전환하려면?">
    요청의 `model` 파라미터만 변경하면 됩니다:

    ```json theme={null}
    {
      "model": "gpt-5.4",
      "model": "claude-sonnet-4-6",
      "model": "gemini-3.1-pro-preview"
    }
    ```
  </Accordion>

  <Accordion title="어떤 프로그래밍 언어를 지원하나요?">
    GravitexAI는 OpenAI API와 호환되며, OpenAI SDK를 지원하는 모든 언어를 사용할 수 있습니다:

    * Python
    * JavaScript/TypeScript
    * Java
    * C#/.NET
    * Go
    * Ruby
    * PHP
  </Accordion>

  <Accordion title="잔액을 확인하려면?">
    콘솔에 로그인하여 다음을 확인하세요:

    * 계정 잔액
    * 사용 내역
    * 소비 통계
  </Accordion>

  <Accordion title="계정은 어떻게 발급받나요?">
    GravitexAI는 공개 회원가입을 제공하지 않습니다. 모든 계정은 BD 팀에서 발급합니다. 온보딩 후 다음 혜택을 받을 수 있습니다:

    * 전담 1:1 BD 지원
    * 맞춤형 모델 플랜 및 할당량
    * 빠른 기술 지원 및 이슈 해결

    시작하려면 [bd@gravitex.ai](mailto:bd@gravitex.ai)로 이메일을 보내거나 +86 136 0305 5233로 전화하세요.
  </Accordion>

  <Accordion title="문제가 발생했나요?">
    1. API 문서 확인
    2. 일반적인 오류 검토
    3. 지원팀 연락: [bd@gravitex.ai](mailto:bd@gravitex.ai)
  </Accordion>
</AccordionGroup>

<Tip>
  API 키를 안전하게 보관하고, 콘솔에서 사용 로그를 정기적으로 확인하여 비용을 최적화하세요. 즐거운 코딩 되세요\~
</Tip>