--- title: GPT-4.1 mini API：模型 ID、100 万上下文与工具调用 | RunAPI description: 通过 RunAPI 的 OpenAI 兼容 Chat Completions API 调用 gpt-4.1-mini。GPT-4.1 的小型版本，100 万 token 上下文，32K 输出，支持图像输入和工具。 url: https://runapi.ai/zh-CN/models/gpt/4.1-mini.md canonical: https://runapi.ai/zh-CN/models/gpt/4.1-mini locale: zh-CN 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 tokens status: active --- > HTML version: https://runapi.ai/zh-CN/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。按 token 计费，无需订阅，响应开始前失败的请求不计费。 **OpenAI / [GPT](https://runapi.ai/zh-CN/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 token 上下文窗口和 32,768 token 最大输出，OpenAI 将它用于快速的指令遵循和工具调用工作负载。 它接受文本和图像输入，不经过推理步骤直接作答。OpenAI 在该模型上支持函数调用和结构化输出，更复杂的任务则推荐 GPT-5 mini。 在 RunAPI 上，把 OpenAI SDK 的 base URL 指向 https://runapi.ai/v1，即可通过 OpenAI 兼容的 Chat Completions 端点（/v1/chat/completions）调用 gpt-4.1-mini。同一个 API key 也能调用 gpt-4.1 和更新的 GPT 模型，只需修改模型 ID 即可切换。 **模型 ID:** gpt-4.1-mini **发布日期:** 2025 年 4 月 14 日 **上下文窗口:** 1,047,576 token **最大输出:** 32,768 token **输入:** 文本和图像 **推理:** 无（非推理模型） **RunAPI 上的端点:** OpenAI Chat Completions ## 体验 GPT-4.1 mini 选择任意模型，几秒内开始生成。 **模型:** - **Chat completion** — `chat_completion` · `gpt-4.1-mini` · 输入 $0.40 / 百万 tokens | 输出 $1.60 / 百万 tokens **提示词:** 描述你想创建的内容…… **预计：** 输入 $0.40 / 百万 tokens | 输出 $1.60 / 百万 tokens - [生成](https://runapi.ai/zh-CN/login) 登录后即可使用 RunAPI 生成。 ### 切换变体 - [codex-auto-review](https://runapi.ai/zh-CN/models/gpt/codex-auto-review.md) - [gpt-4.1](https://runapi.ai/zh-CN/models/gpt/4.1.md) - **gpt-4.1-mini** (current) - [gpt-4o-mini](https://runapi.ai/zh-CN/models/gpt/4o-mini.md) - [gpt-5-pro](https://runapi.ai/zh-CN/models/gpt/5-pro.md) - [gpt-5.2](https://runapi.ai/zh-CN/models/gpt/5.2.md) - [gpt-5.2-pro](https://runapi.ai/zh-CN/models/gpt/5.2-pro.md) - [gpt-5.3-codex](https://runapi.ai/zh-CN/models/gpt/5.3-codex.md) - [gpt-5.3-codex-spark](https://runapi.ai/zh-CN/models/gpt/5.3-codex-spark.md) - [gpt-5.4](https://runapi.ai/zh-CN/models/gpt/5.4.md) - [gpt-5.4-mini](https://runapi.ai/zh-CN/models/gpt/5.4-mini.md) - [gpt-5.4-nano](https://runapi.ai/zh-CN/models/gpt/5.4-nano.md) - [gpt-5.4-pro](https://runapi.ai/zh-CN/models/gpt/5.4-pro.md) - [gpt-5.5](https://runapi.ai/zh-CN/models/gpt/5.5.md) - [gpt-5.5-pro](https://runapi.ai/zh-CN/models/gpt/5.5-pro.md) - [gpt-5.6-luna](https://runapi.ai/zh-CN/models/gpt/5.6-luna.md) - [gpt-5.6-sol](https://runapi.ai/zh-CN/models/gpt/5.6-sol.md) - [gpt-5.6-terra](https://runapi.ai/zh-CN/models/gpt/5.6-terra.md) - [gpt-6-astra](https://runapi.ai/zh-CN/models/gpt/6-astra.md) - [gpt-6-luna](https://runapi.ai/zh-CN/models/gpt/6-luna.md) - [gpt-6-sol](https://runapi.ai/zh-CN/models/gpt/6-sol.md) - [gpt-6.1-sol](https://runapi.ai/zh-CN/models/gpt/6.1-sol.md) - [gpt-live-1](https://runapi.ai/zh-CN/models/gpt/live-1.md) 23 个版本可用 gpt-4.1-mini 是 RunAPI 上 GPT 系列的模型之一。它与其他所有模型使用同一个 API key，只需修改请求中的模型 ID 即可切换。每次调用为同步调用，按输入、输出和缓存 token 以 USD 计费，无订阅，无最低消费。响应开始前失败的请求不计费；响应开始流式输出后，已生成的 token 会计费，即使客户端断开连接。 - 按 token 以 USD 计费，无需订阅 - 响应开始前失败的请求不计费 - 逐 token 流式输出 - 修改一个模型 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 tokens | | 目录状态 | 运行中 | **工作原理** ## 3 步使用此模型 1. **获取 API 密钥** - 免费注册后，在控制台创建用于 gpt-4.1-mini 的 API 密钥。 2. **发送请求** - 向 /v1/chat/completions 发送 POST 请求，并传入 gpt-4.1-mini 模型 ID 和参数。 3. **获取结果** - 直接从端点读取已完成的 gpt-4.1-mini 响应。 ## 该模型的核心能力 - **Endpoint 覆盖** — 提供 1 个公开 endpoint：chat_completion。 - **按量计费** — 按 1K tokens 计量，无需订阅。 ## GPT-4.1 mini 定价 | 端点 | 价格 | |---|---| | `chat_completion` | 输入: $0.40 / 百万 tokens
输出: $1.60 / 百万 tokens
缓存读取: $0.10 / 百万 tokens | **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": "分析这份季度营收数据，总结关键趋势和异常，给出三项建议。" } ] } ``` ### 模型 Skill — gpt-4.1-mini 安装一次 skill，开发时使用本页的变体 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 | 使用 OpenAI / Anthropic / Google Gen AI SDK，配合您的 RunAPI API key 和 `model: "gpt-4.1-mini"` 调用。 ### 用 model skill 使用 gpt-4.1-mini 1. **安装** — 安装 GPT 系列对应的 model skill，它会把文档、请求格式和价格说明加载到您的编码工作区。 2. **配置** — 把 SDK 指向 https://runapi.ai，并设置您的 RunAPI API key。同一个 key 适用于所有模型和供应商。 3. **调用** — 使用该模型支持的 API 格式发送请求，并把 model 字段设置为本页展示的模型 ID。RunAPI 会把请求转发给供应商。 4. **接收** — 从同一次调用中读取响应，或在生成过程中以流式方式接收。usage 字段显示您被计费的 token。 ### gpt-4.1-mini 与其它变体的差异 - **VS CODEX-AUTO-REVIEW: GPT-4.1 的小型版本；100 万上下文，通过 OpenAI 兼容 API 支持图像输入和工具** — codex-auto-review - **VS GPT-4.1: GPT-4.1 的小型版本；100 万上下文，通过 OpenAI 兼容 API 支持图像输入和工具** — OpenAI 非推理模型 GPT-4.1；100 万上下文，通过 OpenAI 兼容 API 支持图像输入和工具 - **VS GPT-4O-MINI: GPT-4.1 的小型版本；100 万上下文，通过 OpenAI 兼容 API 支持图像输入和工具** — 快速且经济的 GPT-4o 模型，适合日常文本任务 ## 应用场景 **客户支持** 基于私有知识库回答客户问题，减少工单量。 **文档分析** 起草合同摘要并标记关键条款供律师审阅。 **代码生成** 在 CI 中自动生成单元测试、代码审查和重构建议。 ## GPT-4.1 mini 常见问题 ### 什么时候该用 gpt-4.1-mini 而不是 gpt-4.1？ 快速、大批量的指令遵循和工具调用，且不需要更大模型时，用 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 key，发送 model 为 gpt-4.1-mini 的 Chat Completions 请求。工具使用标准的 OpenAI tools 格式。 ### 如何选择 gpt-4.1-mini？ 传入 quickstart 中显示的模型 ID。 ### 该变体的限流？ Key 级限流随使用层级伸缩。当前限制见定价页。 ### 能切到其它变体吗？ 可以——变体只是参数，改 model 字段即可。 ### 支持流式吗？ 模型支持流式时，RunAPI 端到端流式。 ### 质量问题在哪里报？ 在公共 GitHub 仓库提 issue 或邮件联系 support。 ### 需要单独的提供方账户吗？ 不需要。你的 RunAPI API key 足以访问此 variant 以及目录中的所有其他模型，无需底层提供方账户。 ### 相关 - [gpt-6-luna](https://runapi.ai/zh-CN/models/gpt/6-luna.md) — 由 OpenAI 提供 · 输入 $0.08-$0.16 / 百万 tokens | 输出 $0.40-$0.60 / 百万 tokens - [gpt-4o-mini](https://runapi.ai/zh-CN/models/gpt/4o-mini.md) — 由 OpenAI 提供 · 输入 $0.12 / 百万 tokens | 输出 $0.48 / 百万 tokens - [codex-auto-review](https://runapi.ai/zh-CN/models/gpt/codex-auto-review.md) — 由 OpenAI 提供 · 输入 $0.16-$0.32 / 百万 tokens | 输出 $0.96-$1.44 / 百万 tokens - [gpt-5.4-nano](https://runapi.ai/zh-CN/models/gpt/5.4-nano.md) — 由 OpenAI 提供 · 输入 $0.16 / 百万 tokens | 输出 $1.00 / 百万 tokens ### 立即体验 GPT。 - [免费注册](https://runapi.ai/zh-CN/login) - [阅读快速开始 →](https://runapi.ai/zh-CN/docs/api/openai/chat-completions) ## 需要团队接入支持？ 我们可以协助团队接入、完成系统集成并解答技术问题。 [联系我们](https://runapi.ai/zh-CN/contact.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "GPT gpt-4.1-mini", "applicationCategory": "DeveloperApplication" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "Models", "item": "https://runapi.ai/zh-CN/models" }, { "@type": "ListItem", "position": 3, "name": "GPT", "item": "https://runapi.ai/zh-CN/models/gpt" }, { "@type": "ListItem", "position": 4, "name": "gpt-4.1-mini", "item": "https://runapi.ai/zh-CN/models/gpt/4.1-mini" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "用 model skill 使用 gpt-4.1-mini", "description": "通过 RunAPI 调用 GPT 系列的 gpt-4.1-mini：按 token 计费、模型 ID、支持的 API 格式和接入指南。", "totalTime": "PT5M", "step": [ { "@type": "HowToStep", "position": 1, "name": "安装", "text": "安装 GPT 系列对应的 model skill，它会把文档、请求格式和价格说明加载到您的编码工作区。", "url": "https://runapi.ai/zh-CN/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/zh-CN/models/gpt/4.1-mini#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "调用", "text": "使用该模型支持的 API 格式发送请求，并把 model 字段设置为本页展示的模型 ID。RunAPI 会把请求转发给供应商。", "url": "https://runapi.ai/zh-CN/models/gpt/4.1-mini#how-step-3" }, { "@type": "HowToStep", "position": 4, "name": "接收", "text": "从同一次调用中读取响应，或在生成过程中以流式方式接收。usage 字段显示您被计费的 token。", "url": "https://runapi.ai/zh-CN/models/gpt/4.1-mini#how-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "什么时候该用 gpt-4.1-mini 而不是 gpt-4.1？", "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 key，发送 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": "Key 级限流随使用层级伸缩。当前限制见定价页。" } }, { "@type": "Question", "name": "能切到其它变体吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以——变体只是参数，改 model 字段即可。" } }, { "@type": "Question", "name": "支持流式吗？", "acceptedAnswer": { "@type": "Answer", "text": "模型支持流式时，RunAPI 端到端流式。" } }, { "@type": "Question", "name": "质量问题在哪里报？", "acceptedAnswer": { "@type": "Answer", "text": "在公共 GitHub 仓库提 issue 或邮件联系 support。" } }, { "@type": "Question", "name": "需要单独的提供方账户吗？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。你的 RunAPI API key 足以访问此 variant 以及目录中的所有其他模型，无需底层提供方账户。" } } ] } ] ```