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

# 자주 묻는 질문

> ARouter에 관한 자주 묻는 질문 — 인증, 결제, 모델, 속도 제한 등.

## 시작하기

<AccordionGroup>
  <Accordion title="ARouter란 무엇인가요?">
    ARouter는 통합 API 게이트웨이입니다. OpenAI, Anthropic, Google, DeepSeek, xAI 등 세계 최고의 AI 모델에 단일 OpenAI 호환 API로 접근할 수 있습니다.

    API key 하나, 결제 계정 하나, 통합 하나만 관리하면 됩니다. ARouter가 라우팅, 인증, 장애 조치, 사용량 추적을 투명하게 처리합니다.
  </Accordion>

  <Accordion title="어떻게 시작하나요?">
    1. [https://api.arouter.ai](https://api.arouter.ai)에서 계정 생성
    2. 대시보드에서 API key 생성
    3. OpenAI 호환 클라이언트의 base URL을 `https://api.arouter.ai/v1`로 설정
    4. 첫 번째 요청 전송

    단계별 가이드는 [빠른 시작](/ko/quickstart)을 참조하세요.
  </Accordion>

  <Accordion title="지원을 받으려면 어떻게 하나요?">
    * **GitHub Issues**: [github.com/arouter-ai](https://github.com/arouter-ai)
    * **이메일**: 대시보드에서 연락처 정보 확인
    * **문서**: 지금 보고 계십니다!
  </Accordion>
</AccordionGroup>

## 결제

<AccordionGroup>
  <Accordion title="어떻게 청구되나요?">
    ARouter는 크레딧 기반 시스템을 사용합니다. 크레딧을 미리 구매하면 요청당 token 사용량에 따라 소비됩니다.

    잔액과 거래 내역은 [대시보드](https://arouter.ai/billing) 또는 [API](/ko/guides/billing-and-credits)에서 확인할 수 있습니다.
  </Accordion>

  <Accordion title="ARouter의 요청 가격은 어떻게 책정되나요?">
    ARouter는 상위 제공업체가 공개한 추론 요금을 그대로 적용합니다. 크레딧 구매 시 플랫폼 수수료가 부과됩니다.

    Token 수는 상위 제공업체가 보고한 값과 정확히 일치하며 각 응답의 `usage` 필드에 반영됩니다.
  </Accordion>

  <Accordion title="크레딧은 만료되나요?">
    결제 약관에 따라 미사용 크레딧은 구매 후 1년 후에 만료될 수 있습니다.
  </Accordion>

  <Accordion title="환불 정책은 어떻게 되나요?">
    미사용 크레딧의 환불 요청은 구매 후 24시간 이내에 해야 합니다. 그 이후에는 미사용 크레딧이 환불되지 않습니다.

    플랫폼 수수료는 환불되지 않으며, 암호화폐 결제도 환불되지 않습니다.
  </Accordion>

  <Accordion title="BYOK에 수수료가 있나요?">
    예. 먼저 월간 무료 허용량이 있으며, 그 이상 사용하면 소액의 ARouter 플랫폼 수수료가 발생하고 추론 비용은 본인 제공업체 key로 청구됩니다.
  </Accordion>

  <Accordion title="잔액을 확인하려면 어떻게 하나요?">
    API 경유:

    ```bash theme={null}
    curl https://api.arouter.ai/api/v1/balance \
      -H "Authorization: Bearer lr_live_xxxx"
    ```

    또는 대시보드 [https://arouter.ai/billing](https://arouter.ai/billing)에서 확인할 수 있습니다.
  </Accordion>

  <Accordion title="크레딧이 아직 반영되지 않았습니다. 어떻게 해야 하나요?">
    구매를 완료했는데 잔액이 즉시 업데이트되지 않는다면, 결제 정산이 완료될 때까지 잠시 기다려 주세요.

    청구가 성공했는데도 크레딧이 반영되지 않는다면, 구매 세부 정보를 첨부하여 대시보드를 통해 지원팀에 문의하시면 결제를 추적해 드립니다.
  </Accordion>

  <Accordion title="어떤 결제 방법을 사용할 수 있나요?">
    ARouter는 대시보드에서 카드 기반 크레딧 구매와 x402 등 지원되는 결제 방식을 통한 암호화폐 충전을 지원합니다.
  </Accordion>

  <Accordion title="무료 플랜이 있나요?">
    계정에 무료 크레딧이나 프로모션 사용량이 포함된 경우, 해당 요청은 프로덕션 용도보다는 테스트 용도로 사용하는 것이 좋습니다. 계정 수준 및 플랜 수준의 제한은 여전히 적용됩니다.
  </Accordion>
</AccordionGroup>

## 모델

<AccordionGroup>
  <Accordion title="어떤 모델을 지원하나요?">
    ARouter는 OpenAI, Anthropic, Google, DeepSeek, xAI, Mistral, Meta, Qwen, MiniMax, Groq, Kimi, Cohere, NVIDIA, Dashscope의 모델을 지원합니다.

    `GET /v1/models`를 사용하여 계정에서 이용 가능한 전체 목록을 확인하세요:

    ```bash theme={null}
    curl https://api.arouter.ai/v1/models \
      -H "Authorization: Bearer lr_live_xxxx"
    ```

    자세한 내용은 [모델](/ko/models)과 [제공업체](/ko/providers)를 참조하세요.
  </Accordion>

  <Accordion title="사용할 모델을 지정하려면 어떻게 하나요?">
    `model` 필드에 `provider/model` 형식을 사용하세요:

    * `openai/gpt-5.4`
    * `anthropic/claude-sonnet-4.6`
    * `google/gemini-2.5-flash`
    * `deepseek/deepseek-v3.2`

    전체 참조는 [모델 라우팅](/ko/model-routing)을 참조하세요.
  </Accordion>

  <Accordion title="ARouter가 최적의 모델을 자동으로 선택할 수 있나요?">
    예. `model`을 `"auto"`로 설정하면 ARouter의 라우팅 서비스가 요청에 가장 적합한 모델을 선택합니다:

    ```json theme={null}
    {
      "model": "auto",
      "messages": [{ "role": "user", "content": "Hello!" }]
    }
    ```

    응답에는 항상 실제 사용된 모델을 나타내는 `model` 필드가 포함됩니다. 자세한 내용은 [모델 라우팅 — 자동 라우팅](/ko/model-routing#auto-routing)을 참조하세요.
  </Accordion>

  <Accordion title="여러 후보 모델을 제공할 수 있나요?">
    예. `models` 배열을 `route`와 함께 사용하세요:

    ```json theme={null}
    {
      "models": ["anthropic/claude-opus-4.5", "openai/gpt-5.4"],
      "route": "fallback",
      "messages": [...]
    }
    ```

    ARouter는 순서대로 모델을 평가하고 첫 번째 성공 결과를 반환합니다. 자세한 내용은 [모델 라우팅](/ko/model-routing)을 참조하세요.
  </Accordion>
</AccordionGroup>

## API 기술

<AccordionGroup>
  <Accordion title="인증은 어떻게 하나요?">
    ARouter는 세 가지 인증 방법을 지원합니다:

    * **Bearer token**: `Authorization: Bearer lr_live_xxxx` (OpenAI SDK, fetch)
    * **API Key header**: `X-Api-Key: lr_live_xxxx` (Anthropic SDK)
    * **쿼리 파라미터**: `?key=lr_live_xxxx` (Gemini SDK)

    각 SDK의 자세한 설정은 [인증 가이드](/ko/authentication)를 참조하세요.
  </Accordion>

  <Accordion title="속도 제한은 어떻게 되나요?">
    속도 제한은 API key별로 적용되며 대시보드에서 설정할 수 있습니다. 기본 제한은 플랜에 따라 다릅니다.

    모든 응답에 속도 제한 헤더가 포함됩니다:

    * `X-RateLimit-Limit`
    * `X-RateLimit-Remaining`
    * `X-RateLimit-Reset`

    자세한 내용은 [API 참조](/ko/api-reference/introduction)를 참조하세요.
  </Accordion>

  <Accordion title="어떤 엔드포인트를 사용할 수 있나요?">
    ARouter가 제공하는 엔드포인트:

    * `/v1/chat/completions` — OpenAI 호환 채팅
    * `/v1/embeddings` — OpenAI 호환 embeddings
    * `/v1/models` — 이용 가능한 모델 목록
    * `/v1/messages` — Anthropic 네이티브
    * `/v1beta/models/{model}:generateContent` — Gemini 네이티브
    * `/api/v1/balance` — 계정 잔액
    * `/api/v1/transactions` — 거래 내역
    * `/api/v1/keys` — API key 관리
    * `/{provider}/{path}` — 제공업체 프록시

    전체 목록은 [API 참조](/ko/api-reference/introduction)를 참조하세요.
  </Accordion>

  <Accordion title="어떤 입력 형식을 지원하나요?">
    ARouter가 지원하는 형식:

    * **텍스트**: 모든 모델
    * **이미지**: 비전 지원 모델 (URL 또는 base64)
    * **PDF**: Anthropic Claude와 Google Gemini

    자세한 내용은 [멀티모달](/ko/guides/features/multimodal)을 참조하세요.
  </Accordion>

  <Accordion title="ARouter는 스트리밍을 지원하나요?">
    예. 요청에 `stream: true`를 설정하세요. ARouter는 모든 제공업체에 대해 Server-Sent Events (SSE) 스트리밍을 지원합니다.

    SSE 형식, 오류 처리, 취소를 포함한 전체 가이드는 [스트리밍](/ko/guides/streaming)을 참조하세요.
  </Accordion>

  <Accordion title="어떤 SDK를 지원하나요?">
    ARouter는 다음 SDK와 호환됩니다:

    * **Python**: OpenAI SDK (`pip install openai`)
    * **Node.js / TypeScript**: OpenAI SDK (`npm install openai`)
    * **Go**: ARouter Go SDK (`go get github.com/arouter-ai/arouter-go`)
    * **Anthropic SDK**: Python과 Node.js
    * **Google Gemini SDK**: Python
    * **모든 HTTP 클라이언트**: cURL, fetch 등

    설정 가이드는 [SDK](/ko/sdks/overview) 섹션을 참조하세요.
  </Accordion>
</AccordionGroup>

## 개인정보 및 데이터

<AccordionGroup>
  <Accordion title="ARouter가 내 프롬프트를 저장하나요?">
    ARouter는 기본적으로 프롬프트 내용을 저장하지 않습니다. 요청 본문은 상위 제공업체로 전달되며 ARouter에 보관되지 않습니다.

    사용량 메타데이터(token 수, 모델, 타임스탬프, 비용)는 결제 및 분석 목적으로 저장됩니다.

    전체 정책은 [데이터 수집](/ko/guides/privacy/data-collection)을 참조하세요.
  </Accordion>

  <Accordion title="어떤 제공업체가 내 데이터를 볼 수 있나요?">
    귀하의 특정 요청을 처리하는 상위 제공업체만 프롬프트 내용을 볼 수 있습니다. `model` 필드로 선택한 제공업체가 요청을 처리합니다. ARouter는 투명한 프록시 역할을 합니다.

    상위 제공업체 데이터 정책에 대한 자세한 내용은 [제공업체 로깅](/ko/guides/privacy/provider-logging)을 참조하세요.
  </Accordion>

  <Accordion title="제공업체가 내 데이터로 모델을 학습하지 못하게 할 수 있나요?">
    `provider.data_collection: "deny"`를 사용하여 모델 학습에 요청 데이터를 사용하지 않는 제공업체로만 라우팅을 제한하세요:

    ```json theme={null}
    {
      "model": "anthropic/claude-sonnet-4.6",
      "provider": {"data_collection": "deny"}
    }
    ```

    또는 제로 데이터 리텐션 적용을 위해 `provider.zdr: true`를 사용하세요. [제공업체 라우팅 — 데이터 수집 정책](/ko/provider-routing#data-collection-policy)을 참조하세요.
  </Accordion>

  <Accordion title="ARouter는 제로 데이터 리텐션 (ZDR)을 지원하나요?">
    예. 요청에 `provider.zdr: true`를 설정하면 제로 데이터 리텐션 계약을 맺은 제공업체로만 라우팅이 제한됩니다. [제공업체 라우팅](/ko/provider-routing#zero-data-retention-zdr)을 참조하세요.
  </Accordion>
</AccordionGroup>

## 모델과 제공업체

<AccordionGroup>
  <Accordion title=":nitro, :floor, :free 같은 모델 변형이란 무엇인가요?">
    모델 ID에 접미사를 추가하여 라우팅 동작을 변경할 수 있습니다:

    * `:nitro` — 처리량이 가장 높은 인스턴스로 라우팅
    * `:floor` — 비용이 가장 낮은 인스턴스로 라우팅
    * `:free` — 무료 플랜 인스턴스 사용 (속도 제한 적용)
    * `:thinking` — 확장된 Chain-of-Thought 추론 활성화
    * `:extended` — 더 큰 컨텍스트 윈도우 버전 사용

    ```json theme={null}
    {"model": "openai/gpt-5.4:nitro"}
    ```

    전체 참조는 [모델 변형](/ko/guides/features/model-variants)을 참조하세요.
  </Accordion>

  <Accordion title="ARouter는 이미지와 PDF를 지원하나요?">
    예. `content` 배열에 텍스트와 함께 이미지 URL 또는 base64 인코딩된 이미지를 전달하세요. PDF는 Anthropic Claude와 Google Gemini에서 지원됩니다.

    ```json theme={null}
    {
      "model": "openai/gpt-5.4",
      "messages": [{
        "role": "user",
        "content": [
          {"type": "text", "text": "이 이미지에 무엇이 있나요?"},
          {"type": "image_url", "image_url": {"url": "https://..."}}
        ]
      }]
    }
    ```

    예시는 [멀티모달](/ko/guides/features/multimodal)을 참조하세요.
  </Accordion>

  <Accordion title="ARouter는 도구 호출을 지원하나요?">
    예. ARouter는 OpenAI 도구 호출 표준을 사용하여 모든 주요 제공업체에서 도구/함수 호출을 지원합니다. 요청에 `tools`와 `tool_choice`를 전달하세요.

    전체 가이드는 [도구 호출](/ko/guides/features/tool-calling)을 참조하세요.
  </Accordion>

  <Accordion title="ARouter는 구조화된 출력 / JSON 모드를 지원하나요?">
    예. 유효한 JSON 출력에는 `response_format: {"type": "json_object"}`를, 스키마 강제 출력에는 `response_format: {"type": "json_schema", "json_schema": {...}}`를 사용하세요.

    자세한 내용은 [구조화된 출력](/ko/guides/features/structured-outputs)을 참조하세요.
  </Accordion>

  <Accordion title="ARouter는 프롬프트 캐싱을 지원하나요?">
    예. OpenAI, DeepSeek, xAI, Groq 모델은 프롬프트 캐싱을 자동으로 지원합니다. Anthropic의 경우 명시적 캐싱에 `cache_control` 블록을 사용하세요. Google Gemini는 자동 및 명시적 캐싱을 모두 지원합니다.

    전체 가이드는 [프롬프트 캐싱](/ko/guides/features/prompt-caching)을 참조하세요.
  </Accordion>
</AccordionGroup>

## 계정 관리

<AccordionGroup>
  <Accordion title="API key에 지출 한도를 설정할 수 있나요?">
    예. API key 생성 또는 업데이트 시 `spending_limit`을 설정하여 해당 key의 지출 상한을 설정할 수 있습니다:

    ```bash theme={null}
    curl -X POST https://api.arouter.ai/v1/keys \
      -H "Authorization: Bearer lr_live_xxxx" \
      -d '{"name": "production", "spending_limit": 100.00}'
    ```

    자세한 내용은 [Key 관리](/ko/guides/key-management)를 참조하세요.
  </Accordion>

  <Accordion title="key가 접근할 수 있는 제공업체를 제한하려면 어떻게 하나요?">
    key 생성 시 `allowed_providers`를 설정하세요:

    ```json theme={null}
    {
      "name": "openai-only-key",
      "allowed_providers": ["openai", "anthropic"]
    }
    ```

    자세한 내용은 [Key 관리](/ko/guides/key-management)를 참조하세요.
  </Accordion>

  <Accordion title="여러 API key를 가질 수 있나요?">
    예. 다양한 환경, 서비스, 사용 사례에 대해 여러 API key를 만들 수 있습니다. 각 key는 독립적인 지출 한도, 제공업체 제한, 사용량 추적을 가집니다.

    [대시보드](https://arouter.ai/keys) 또는 [Key 관리 API](/ko/api-reference/keys/create-key)에서 key를 관리하세요.
  </Accordion>

  <Accordion title="애플리케이션에서 사용자별로 사용량을 추적할 수 있나요?">
    예. 각 요청에 최종 사용자의 불투명한 식별자가 포함된 `user` 필드를 전달하세요. 이후 활동 내보내기에서 사용자별 사용량을 확인할 수 있습니다.

    ```json theme={null}
    {"model": "openai/gpt-5.4", "user": "user_12345", "messages": [...]}
    ```

    자세한 내용은 [사용자 추적](/ko/guides/administration/user-tracking)을 참조하세요.
  </Accordion>

  <Accordion title="여러 사람이 계정을 공유할 수 있나요?">
    예. [조직 관리](/ko/guides/administration/organization-management)를 사용하여 공유 조직을 만들고, 팀원을 초대하고, 공유 크레딧을 관리하고, 권한을 제어하세요.
  </Accordion>
</AccordionGroup>