---
title: 'GPT-4.1 mini API: 모델 ID, 1M 컨텍스트, 도구 호출 | RunAPI'
description: RunAPI의 OpenAI 호환 Chat Completions API로 gpt-4.1-mini 호출. 더 작은 GPT-4.1 모델로 1M 토큰 컨텍스트, 32K 출력, 이미지 입력, 도구를 지원합니다.
url: https://runapi.ai/ko/models/gpt/4.1-mini.md
canonical: https://runapi.ai/ko/models/gpt/4.1-mini
locale: ko
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
en: https://runapi.ai/models/gpt/4.1-mini
zh-CN: https://runapi.ai/zh-CN/models/gpt/4.1-mini
es: https://runapi.ai/es/models/gpt/4.1-mini
ja: https://runapi.ai/ja/models/gpt/4.1-mini
de: https://runapi.ai/de/models/gpt/4.1-mini
fr: https://runapi.ai/fr/models/gpt/4.1-mini
pt-BR: https://runapi.ai/pt-BR/models/gpt/4.1-mini
ko: https://runapi.ai/ko/models/gpt/4.1-mini
it: https://runapi.ai/it/models/gpt/4.1-mini
nl: https://runapi.ai/nl/models/gpt/4.1-mini
pl: https://runapi.ai/pl/models/gpt/4.1-mini
tr: https://runapi.ai/tr/models/gpt/4.1-mini
zh-TW: https://runapi.ai/zh-TW/models/gpt/4.1-mini
zh-HK: https://runapi.ai/zh-HK/models/gpt/4.1-mini
ar: https://runapi.ai/ar/models/gpt/4.1-mini
x-default: https://runapi.ai/models/gpt/4.1-mini
model: GPT
provider: OpenAI
variant_id: gpt-4.1-mini
sdk_model_id: gpt-4.1-mini
modality: text
billing_unit: 1K 토큰
status: active
---
> HTML version: https://runapi.ai/ko/models/gpt/4.1-mini
> Site index for agents: https://runapi.ai/llms.txt
# gpt-4.1-mini API
RunAPI로 GPT 패밀리의 gpt-4.1-mini를 호출하세요. 토큰당 요금, 구독 없음, 응답이 시작되기 전에 실패한 요청은 과금되지 않습니다.
**OpenAI / [GPT](https://runapi.ai/ko/models/gpt.md)**
**운영 중 · text · 상업적 사용 지원**
## GPT-4.1 mini는 어떤 작업에 맞나
GPT-4.1 mini는 OpenAI GPT-4.1 패밀리의 작은 모델로, 2025년 4월 14일 스냅샷 gpt-4.1-mini-2025-04-14로 출시되었습니다. GPT-4.1과 같은 1,047,576토큰 컨텍스트 윈도우와 최대 32,768토큰 출력을 유지하며, OpenAI는 빠른 지시 수행과 도구 호출 워크로드를 대상으로 합니다.
텍스트와 이미지 입력을 받고, 추론 단계 없이 답합니다. OpenAI는 이 모델에서 함수 호출과 구조화된 출력을 지원하며, 더 복잡한 작업에는 GPT-5 mini를 권장합니다.
RunAPI에서는 OpenAI 호환 Chat Completions 엔드포인트(/v1/chat/completions)로 gpt-4.1-mini를 호출합니다. OpenAI SDK의 연결 주소를 https://runapi.ai/v1로 지정하세요. 같은 API 키로 gpt-4.1과 더 새로운 GPT 모델도 호출할 수 있어서, 모델 ID만 바꿔 전환할 수 있습니다.
**모델 ID:** gpt-4.1-mini
**출시일:** 2025년 4월 14일
**컨텍스트 윈도우:** 1,047,576 토큰
**최대 출력:** 32,768 토큰
**입력:** 텍스트와 이미지
**추론:** 없음(비추론 모델)
**RunAPI 엔드포인트:** OpenAI Chat Completions
## GPT-4.1 mini 체험하기
원하는 모델을 선택하고 몇 초 만에 생성해보세요.
**모델:**
- **Chat completion** — `chat_completion` · `gpt-4.1-mini` · 입력 $0.40 / 100만 토큰 | 출력 $1.60 / 100만 토큰
**프롬프트:** 만들고 싶은 것을 설명하세요...
**예상 금액:** 입력 $0.40 / 100만 토큰 | 출력 $1.60 / 100만 토큰
- [생성](https://runapi.ai/ko/login)
RunAPI로 생성하려면 로그인하세요.
### 변형 전환
- [codex-auto-review](https://runapi.ai/ko/models/gpt/codex-auto-review.md)
- [gpt-4.1](https://runapi.ai/ko/models/gpt/4.1.md)
- **gpt-4.1-mini** (current)
- [gpt-4o-mini](https://runapi.ai/ko/models/gpt/4o-mini.md)
- [gpt-5-pro](https://runapi.ai/ko/models/gpt/5-pro.md)
- [gpt-5.2](https://runapi.ai/ko/models/gpt/5.2.md)
- [gpt-5.2-pro](https://runapi.ai/ko/models/gpt/5.2-pro.md)
- [gpt-5.3-codex](https://runapi.ai/ko/models/gpt/5.3-codex.md)
- [gpt-5.3-codex-spark](https://runapi.ai/ko/models/gpt/5.3-codex-spark.md)
- [gpt-5.4](https://runapi.ai/ko/models/gpt/5.4.md)
- [gpt-5.4-mini](https://runapi.ai/ko/models/gpt/5.4-mini.md)
- [gpt-5.4-nano](https://runapi.ai/ko/models/gpt/5.4-nano.md)
- [gpt-5.4-pro](https://runapi.ai/ko/models/gpt/5.4-pro.md)
- [gpt-5.5](https://runapi.ai/ko/models/gpt/5.5.md)
- [gpt-5.5-pro](https://runapi.ai/ko/models/gpt/5.5-pro.md)
- [gpt-5.6-luna](https://runapi.ai/ko/models/gpt/5.6-luna.md)
- [gpt-5.6-sol](https://runapi.ai/ko/models/gpt/5.6-sol.md)
- [gpt-5.6-terra](https://runapi.ai/ko/models/gpt/5.6-terra.md)
- [gpt-6-astra](https://runapi.ai/ko/models/gpt/6-astra.md)
- [gpt-6-luna](https://runapi.ai/ko/models/gpt/6-luna.md)
- [gpt-6-sol](https://runapi.ai/ko/models/gpt/6-sol.md)
- [gpt-6.1-sol](https://runapi.ai/ko/models/gpt/6.1-sol.md)
- [gpt-live-1](https://runapi.ai/ko/models/gpt/live-1.md)
사용 가능한 버전 23개
gpt-4.1-mini는 RunAPI에서 제공하는 GPT 패밀리 모델 중 하나입니다. 다른 모델과 같은 API key를 사용하며, 요청의 모델 ID만 바꾸면 전환됩니다. 각 호출은 동기식이고 입력, 출력, 캐시 토큰 기준으로 USD로 과금되며 구독이나 최소 사용액이 없습니다. 응답이 시작되기 전에 실패한 요청은 과금되지 않습니다. 스트리밍이 시작된 뒤에는 클라이언트 연결이 끊겨도 이미 생성된 토큰이 과금됩니다.
- 구독 없이 USD 토큰당 과금
- 응답 시작 전에 실패한 요청은 과금 없음
- 토큰 단위 스트리밍
- 모델 ID 하나만 바꿔 모델 전환
- 모든 모델과 공급자에 API key 하나, 청구서 하나
## 사용 지표
- **API 호출 / 일:** 3
- **성공률:** 33.3%
- **평균 생성 시간:** 5.1s
이 모델에 대한 검증된 고객 피드백이 아직 없습니다.
## 스펙
| 필드 | 값 |
|---|---|
| 제공자 | OpenAI |
| 모델 ID | gpt-4.1-mini |
| 모달리티 | 텍스트 |
| 작업 유형 | Synchronous |
| API 엔드포인트 | `/v1/chat/completions` |
| | `/v1/responses` |
| | `/v1/messages` |
| | `/v1beta/models/gpt-4.1-mini:generateContent` |
| | `/v1beta/models/gpt-4.1-mini:streamGenerateContent` |
| 청구 단위 | 1K 토큰 |
| 카탈로그 상태 | 운영 중 |
**사용 방법**
## 이 모델을 3단계로 사용하기
1. **키 받기** - 무료로 가입하고 대시보드에서 gpt-4.1-mini용 API 키를 만드세요.
2. **요청 보내기** - /v1/chat/completions로 gpt-4.1-mini 모델 ID와 매개변수를 포함한 POST 요청을 보내세요.
3. **결과 받기** - 엔드포인트에서 완료된 gpt-4.1-mini 응답을 직접 읽으세요.
## 이 모델이 제공하는 것
- **endpoint 구성** — 1개의 공개 endpoint를 제공합니다: chat_completion.
- **사용량 기반 과금** — 1K 토큰 기준으로 측정되며 구독 없이 이용 가능합니다.
## GPT-4.1 mini 요금
| 엔드포인트 | 가격 |
|---|---|
| `chat_completion` | 입력: $0.40 / 100만 토큰
출력: $1.60 / 100만 토큰
캐시 읽기: $0.10 / 100만 토큰 |
**API 레퍼런스**
## 엔드포인트 사양
| Field | Value |
|---|---|
| 엔드포인트 | `POST /v1/chat/completions` |
| 모델 ID | `gpt-4.1-mini` |
| 작업 유형 | `chat_completion` |
## 요청 매개변수
이 엔드포인트에 게시된 요청 매개변수가 없습니다.
**Request example**
```json
{
"model": "gpt-4.1-mini",
"messages": [
{
"role": "user",
"content": "이 분기별 수익 데이터를 분석하고 주요 트렌드, 이상 현상, 세 가지 권고 사항이 포함된 요약을 작성해 주세요."
}
]
}
```
### 모델 스킬 — gpt-4.1-mini
스킬을 한 번 설치한 후, 이 페이지의 변형 ID를 사용해 개발을 시작하세요.
Base URL: `https://runapi.ai`
| Endpoint | Protocol |
|---|---|
| `POST /v1/chat/completions` | OpenAI compatible |
| `POST /v1/responses` | OpenAI Responses |
| `POST /v1/messages` | Anthropic compatible |
| `POST /v1beta/models/gpt-4.1-mini:generateContent` | Gemini generateContent |
| `POST /v1beta/models/gpt-4.1-mini:streamGenerateContent` | Gemini streamGenerateContent |
RunAPI API key와 `model: "gpt-4.1-mini"`를 지정해 OpenAI / Anthropic / Google Gen AI SDK를 사용하세요.
### gpt-4.1-mini 사용 방법
1. **설치** — GPT 라인용 model skill을 설치하세요. 문서, 요청 형식, 가격 안내가 코딩 작업 공간에 로드됩니다.
2. **설정** — SDK가 https://runapi.ai 를 가리키도록 하고 RunAPI API key를 설정하세요. 같은 key로 모든 모델과 공급자를 사용할 수 있습니다.
3. **호출** — 이 모델이 지원하는 API 형식으로 요청을 보내고, model 필드에 이 페이지의 모델 ID를 지정하세요. RunAPI가 공급자에게 전달합니다.
4. **수신** — 같은 호출에서 응답을 읽거나 생성되는 대로 스트리밍으로 받으세요. usage 필드에서 과금되는 토큰을 확인할 수 있습니다.
### gpt-4.1-mini 비교
- **VS CODEX-AUTO-REVIEW: 더 작은 GPT-4.1 모델; 1M 컨텍스트, 이미지 입력, 도구를 OpenAI 호환 API로** — codex-auto-review
- **VS GPT-4.1: 더 작은 GPT-4.1 모델; 1M 컨텍스트, 이미지 입력, 도구를 OpenAI 호환 API로** — OpenAI의 비추론 모델 GPT-4.1; 1M 컨텍스트, 이미지 입력, 도구를 OpenAI 호환 API로
- **VS GPT-4O-MINI: 더 작은 GPT-4.1 모델; 1M 컨텍스트, 이미지 입력, 도구를 OpenAI 호환 API로** — 일상적인 텍스트 작업에 적합한 빠르고 경제적인 GPT-4o 모델
## 사용 사례
**Chat**
LLM을 채팅과 추론에 사용합니다.
**코드**
구현 작업을 생성하고 리뷰합니다.
**자동화**
모델을 backend 작업에 연결합니다.
## GPT-4.1 mini 자주 묻는 질문
### gpt-4.1 대신 gpt-4.1-mini를 써야 할 때는 언제인가요?
큰 모델이 필요 없는 빠르고 대량의 지시 수행과 도구 호출에는 gpt-4.1-mini를 쓰세요. 까다로운 지시에는 gpt-4.1이 맞습니다. 두 모델의 컨텍스트 윈도우, 출력 한도, 입력 유형은 같습니다.
### GPT-4.1 mini는 이미지를 받나요?
네. 텍스트와 이미지를 입력할 수 있습니다. RunAPI에서는 Chat Completions 요청의 messages[].content[]에서 텍스트 옆에 image_url 파트를 추가하세요.
### GPT-4.1 mini는 답하기 전에 추론하나요?
아니요. gpt-4.1과 마찬가지로 추론 단계가 없습니다. 더 복잡한 작업에는 OpenAI가 GPT-5 mini를 권장합니다.
### RunAPI에서 GPT-4.1 mini를 호출하려면 어떻게 하나요?
OpenAI SDK의 연결 주소를 https://runapi.ai/v1로 지정하고 RunAPI API 키를 설정한 뒤, model을 gpt-4.1-mini로 지정한 Chat Completions 요청을 보내세요. 도구는 표준 OpenAI tools 형식을 사용합니다.
### gpt-4.1-mini는 어떻게 선택하나요?
quickstart에 표시된 모델 ID를 전달하세요.
### 가격은 사용량 기반인가요?
네. 호출 또는 단위 기준으로 측정됩니다.
### 나중에 variant를 바꿀 수 있나요?
네. variant는 요청 매개변수입니다. model ID만 변경하면 되며 코드 변경, 재인증, 별도 청구 설정이 필요하지 않습니다. 모든 variant는 같은 API key와 요청 형식을 공유합니다.
### streaming을 지원하나요?
streaming이 가능한 경우 RunAPI는 엔드투엔드로 전송합니다. LLM 모델은 token 단위 streaming을 지원하며 미디어 모델은 비동기 작업 polling 또는 webhook callback으로 결과를 전달합니다.
### 품질 문제는 어디에 보고하나요?
공개 GitHub repo에 issue를 열거나 contact@runapi.ai로 이메일을 보내세요. 특정 생성 결과를 조사할 수 있도록 task ID와 model ID를 포함하세요.
### 별도 제공사 계정이 필요한가요?
아니요. RunAPI API key만 있으면 이 variant와 카탈로그의 모든 모델에 접근할 수 있습니다. 원래 제공사의 계정은 필요하지 않습니다.
### 관련
- [gpt-6-luna](https://runapi.ai/ko/models/gpt/6-luna.md) — OpenAI 제공 · 입력 $0.08-$0.16 / 100만 토큰 | 출력 $0.40-$0.60 / 100만 토큰
- [gpt-4o-mini](https://runapi.ai/ko/models/gpt/4o-mini.md) — OpenAI 제공 · 입력 $0.12 / 100만 토큰 | 출력 $0.48 / 100만 토큰
- [codex-auto-review](https://runapi.ai/ko/models/gpt/codex-auto-review.md) — OpenAI 제공 · 입력 $0.16-$0.32 / 100만 토큰 | 출력 $0.96-$1.44 / 100만 토큰
- [gpt-5.4-nano](https://runapi.ai/ko/models/gpt/5.4-nano.md) — OpenAI 제공 · 입력 $0.16 / 100만 토큰 | 출력 $1.00 / 100만 토큰
### 오늘 GPT로 시작하세요.
- [무료 계정 만들기](https://runapi.ai/ko/login)
- [빠른 시작 읽기 →](https://runapi.ai/ko/docs/api/openai/chat-completions)
## 팀과 함께 구축하고 계신가요?
엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.
[문의하기](https://runapi.ai/ko/contact.md)
---
## More from RunAPI
- [Home](https://runapi.ai/ko/.md)
### 제품
- [모델 카탈로그](https://runapi.ai/ko/models.md)
- [요금](https://runapi.ai/ko/pricing.md)
- [제공사](https://runapi.ai/ko/models#all-models)
### 개발자
- [문서](https://runapi.ai/ko/docs/guides)
- [SDK](https://runapi.ai/ko/sdk.md)
- [CLI](https://runapi.ai/ko/cli.md)
- [MCP Server](https://runapi.ai/ko/mcp.md)
- [x402](https://runapi.ai/ko/x402.md)
### 가이드
- [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md)
- [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md)
- [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md)
### 회사
- [엔터프라이즈](https://runapi.ai/ko/contact.md)
- [문의](https://runapi.ai/ko/contact.md)
### 법적 고지
- [약관](https://runapi.ai/ko/terms.md)
- [개인정보](https://runapi.ai/ko/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)
Contact: contact@runapi.ai
## Structured data
```json
[
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "WebSite",
"name": "RunAPI",
"url": "https://runapi.ai/ko",
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}"
},
"query-input": "required name=search_term_string"
}
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "Organization",
"name": "RunAPI",
"url": "https://runapi.ai/ko",
"logo": {
"@type": "ImageObject",
"url": "https://runapi.ai/koicon.svg"
},
"sameAs": [
"https://github.com/runapi-ai"
]
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "SoftwareApplication",
"name": "GPT gpt-4.1-mini",
"applicationCategory": "DeveloperApplication"
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://runapi.ai/ko"
},
{
"@type": "ListItem",
"position": 2,
"name": "Models",
"item": "https://runapi.ai/ko/models"
},
{
"@type": "ListItem",
"position": 3,
"name": "GPT",
"item": "https://runapi.ai/ko/models/gpt"
},
{
"@type": "ListItem",
"position": 4,
"name": "gpt-4.1-mini",
"item": "https://runapi.ai/ko/models/gpt/4.1-mini"
}
]
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "HowTo",
"name": "gpt-4.1-mini 사용 방법",
"description": "RunAPI로 GPT 패밀리의 gpt-4.1-mini를 호출하세요. 토큰당 요금, 모델 ID, 지원하는 API 형식, 설정 가이드를 제공합니다.",
"totalTime": "PT5M",
"step": [
{
"@type": "HowToStep",
"position": 1,
"name": "설치",
"text": "GPT 라인용 model skill을 설치하세요. 문서, 요청 형식, 가격 안내가 코딩 작업 공간에 로드됩니다.",
"url": "https://runapi.ai/ko/models/gpt/4.1-mini#how-step-1"
},
{
"@type": "HowToStep",
"position": 2,
"name": "설정",
"text": "SDK가 https://runapi.ai 를 가리키도록 하고 RunAPI API key를 설정하세요. 같은 key로 모든 모델과 공급자를 사용할 수 있습니다.",
"url": "https://runapi.ai/ko/models/gpt/4.1-mini#how-step-2"
},
{
"@type": "HowToStep",
"position": 3,
"name": "호출",
"text": "이 모델이 지원하는 API 형식으로 요청을 보내고, model 필드에 이 페이지의 모델 ID를 지정하세요. RunAPI가 공급자에게 전달합니다.",
"url": "https://runapi.ai/ko/models/gpt/4.1-mini#how-step-3"
},
{
"@type": "HowToStep",
"position": 4,
"name": "수신",
"text": "같은 호출에서 응답을 읽거나 생성되는 대로 스트리밍으로 받으세요. usage 필드에서 과금되는 토큰을 확인할 수 있습니다.",
"url": "https://runapi.ai/ko/models/gpt/4.1-mini#how-step-4"
}
]
},
{
"@context": "https://schema.org",
"inLanguage": "ko",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "gpt-4.1 대신 gpt-4.1-mini를 써야 할 때는 언제인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "큰 모델이 필요 없는 빠르고 대량의 지시 수행과 도구 호출에는 gpt-4.1-mini를 쓰세요. 까다로운 지시에는 gpt-4.1이 맞습니다. 두 모델의 컨텍스트 윈도우, 출력 한도, 입력 유형은 같습니다."
}
},
{
"@type": "Question",
"name": "GPT-4.1 mini는 이미지를 받나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "네. 텍스트와 이미지를 입력할 수 있습니다. RunAPI에서는 Chat Completions 요청의 messages[].content[]에서 텍스트 옆에 image_url 파트를 추가하세요."
}
},
{
"@type": "Question",
"name": "GPT-4.1 mini는 답하기 전에 추론하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "아니요. gpt-4.1과 마찬가지로 추론 단계가 없습니다. 더 복잡한 작업에는 OpenAI가 GPT-5 mini를 권장합니다."
}
},
{
"@type": "Question",
"name": "RunAPI에서 GPT-4.1 mini를 호출하려면 어떻게 하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "OpenAI SDK의 연결 주소를 https://runapi.ai/v1로 지정하고 RunAPI API 키를 설정한 뒤, model을 gpt-4.1-mini로 지정한 Chat Completions 요청을 보내세요. 도구는 표준 OpenAI tools 형식을 사용합니다."
}
},
{
"@type": "Question",
"name": "gpt-4.1-mini는 어떻게 선택하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "quickstart에 표시된 모델 ID를 전달하세요."
}
},
{
"@type": "Question",
"name": "가격은 사용량 기반인가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "네. 호출 또는 단위 기준으로 측정됩니다."
}
},
{
"@type": "Question",
"name": "나중에 variant를 바꿀 수 있나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "네. variant는 요청 매개변수입니다. model ID만 변경하면 되며 코드 변경, 재인증, 별도 청구 설정이 필요하지 않습니다. 모든 variant는 같은 API key와 요청 형식을 공유합니다."
}
},
{
"@type": "Question",
"name": "streaming을 지원하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "streaming이 가능한 경우 RunAPI는 엔드투엔드로 전송합니다. LLM 모델은 token 단위 streaming을 지원하며 미디어 모델은 비동기 작업 polling 또는 webhook callback으로 결과를 전달합니다."
}
},
{
"@type": "Question",
"name": "품질 문제는 어디에 보고하나요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "공개 GitHub repo에 issue를 열거나 contact@runapi.ai로 이메일을 보내세요. 특정 생성 결과를 조사할 수 있도록 task ID와 model ID를 포함하세요."
}
},
{
"@type": "Question",
"name": "별도 제공사 계정이 필요한가요?",
"acceptedAnswer": {
"@type": "Answer",
"text": "아니요. RunAPI API key만 있으면 이 variant와 카탈로그의 모든 모델에 접근할 수 있습니다. 원래 제공사의 계정은 필요하지 않습니다."
}
}
]
}
]
```