> For the complete documentation index, see [llms.txt](https://runyourai.gitbook.io/userguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://runyourai.gitbook.io/userguide/api/guide/runyourfree.md).
# 무료 모델 호출하기
**RunYour Free**(`runyour/free`)는 API 키 계정의 **크레딧을 차감하지 않고** API를 호출할 수 있는 특수 모델 alias입니다.
기존 RunYour API와 동일한 Base URL과 인증 방식을 그대로 사용하며, 모델 ID만 `runyour/free`로 변경하면 됩니다. 별도 설정이나 코드 수정이 필요하지 않습니다.
***
#### 지원 모델 문자열
아래 두 가지 모델 문자열은 동일하게 동작합니다 (대소문자 무관).
모델 문자열
비고
runyour/free
요청 시 사용 가능
runyourai/free
GET /v1/models 모델 목록에 표시되는 공식 ID
> 응답의 `model` 필드에는 내부 백엔드 ID가 아닌, **요청 시 사용한 alias**(`runyour/free` 또는 `runyourai/free`)가 그대로 반환됩니다.
***
#### 과금 정책
**크레딧 차감 없음** `runyour/free`로 성공한 API 호출은 계정 크레딧에서 **차감되지 않습니다**.
**사용량 로그는 기록됨** 호출마다 토큰 사용량(입력 / 출력 / 합계)과 해당 백엔드 모델 기준의 예상 비용은 로그에 저장됩니다. 이는 투명성 및 분석 목적이며, 실제 청구로 이어지지 않습니다.
{% hint style="info" %}
대시보드 API 사용 내역에서 비용 수치가 표시될 수 있습니다. 이 값은 "**만약 일반 모델을 사용했다면 차감됐을 예상 금액**"이며, RunYour Free 호출에 대해서는 실제로 차감되지 않습니다.
{% endhint %}
***
#### 백엔드 동작
각 요청은 등록된 무료 백엔드 모델 중 **하나가 랜덤으로 선택**되어 처리됩니다. 동작 방식과 제한은 선택된 백엔드 모델을 따릅니다.
{% hint style="warning" %}
무료 백엔드는 OpenAI 네이티브 Responses 스트림을 지원하지 않습니다. 스트리밍이 필요한 경우 `POST /v1/chat/completions`에 `stream: true` 옵션을 사용하세요.
{% endhint %}
***
#### 코드 예시
**OpenAI SDK (TypeScript)**
```typescript
const completion = await client.chat.completions.create({
model: "runyour/free",
messages: [{ role: "user", content: "Hello!" }],
});
```
**OpenAI SDK (Python)**
```python
completion = client.chat.completions.create(
model="runyour/free",
messages=[{"role": "user", "content": "Hello!"}],
)
```
**스트리밍 예시 (TypeScript)**
```typescript
const stream = await client.chat.completions.create({
model: "runyour/free",
messages: [{ role: "user", content: "Hello!" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content || "");
}
```
***
#### 요약