--- 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-HK/models/gpt/4.1-mini.md canonical: https://runapi.ai/zh-HK/models/gpt/4.1-mini locale: zh-HK 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-HK/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-HK/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 **Prompt:** 描述你想要生成的內容... **預計費用：** 輸入 $0.40 / 百萬 tokens | 輸出 $1.60 / 百萬 tokens - [生成](https://runapi.ai/zh-HK/login) 登入以使用 RunAPI 生成內容。 ### 切換 variant - [codex-auto-review](https://runapi.ai/zh-HK/models/gpt/codex-auto-review.md) - [gpt-4.1](https://runapi.ai/zh-HK/models/gpt/4.1.md) - **gpt-4.1-mini** (current) - [gpt-4o-mini](https://runapi.ai/zh-HK/models/gpt/4o-mini.md) - [gpt-5-pro](https://runapi.ai/zh-HK/models/gpt/5-pro.md) - [gpt-5.2](https://runapi.ai/zh-HK/models/gpt/5.2.md) - [gpt-5.2-pro](https://runapi.ai/zh-HK/models/gpt/5.2-pro.md) - [gpt-5.3-codex](https://runapi.ai/zh-HK/models/gpt/5.3-codex.md) - [gpt-5.3-codex-spark](https://runapi.ai/zh-HK/models/gpt/5.3-codex-spark.md) - [gpt-5.4](https://runapi.ai/zh-HK/models/gpt/5.4.md) - [gpt-5.4-mini](https://runapi.ai/zh-HK/models/gpt/5.4-mini.md) - [gpt-5.4-nano](https://runapi.ai/zh-HK/models/gpt/5.4-nano.md) - [gpt-5.4-pro](https://runapi.ai/zh-HK/models/gpt/5.4-pro.md) - [gpt-5.5](https://runapi.ai/zh-HK/models/gpt/5.5.md) - [gpt-5.5-pro](https://runapi.ai/zh-HK/models/gpt/5.5-pro.md) - [gpt-5.6-luna](https://runapi.ai/zh-HK/models/gpt/5.6-luna.md) - [gpt-5.6-sol](https://runapi.ai/zh-HK/models/gpt/5.6-sol.md) - [gpt-5.6-terra](https://runapi.ai/zh-HK/models/gpt/5.6-terra.md) - [gpt-6-astra](https://runapi.ai/zh-HK/models/gpt/6-astra.md) - [gpt-6-luna](https://runapi.ai/zh-HK/models/gpt/6-luna.md) - [gpt-6-sol](https://runapi.ai/zh-HK/models/gpt/6-sol.md) - [gpt-6.1-sol](https://runapi.ai/zh-HK/models/gpt/6.1-sol.md) - [gpt-live-1](https://runapi.ai/zh-HK/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 收費 | API endpoint | 價格 | |---|---| | `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": "分析這份季度收入數據，並撰寫摘要，列出主要趨勢、異常情況及三項建議。" } ] } ``` ### 快速開始 — gpt-4.1-mini 結構一致 · variant 已固定於 model 中 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"` 調用。 ### 四步使用 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 顯示嘅 model ID。 ### 這個 variant 的 rate limit 係多少？ 每個 key 的 rate limit 會按使用層級而定。請查看定價頁了解最新限制。 ### 之後可以切換 variant 嗎？ 可以——variant 只係一個旗標。只要更改 model 參數就可以切換。 ### 支援 streaming 嗎？ 在可用 streaming 的情況下，RunAPI 會端到端串流。 ### 我應該在邊度回報品質問題？ 可以在公開 GitHub repo 開 issue，或者電郵支援團隊。 ### 需要獨立的供應商帳戶嗎？ 不需要。你的 RunAPI API key 足以存取此 variant 及目錄中的所有其他模型，無需底層供應商帳戶。 ### RELATED - [gpt-6-luna](https://runapi.ai/zh-HK/models/gpt/6-luna.md) — 由 OpenAI 提供 · 輸入 $0.08-$0.16 / 百萬 tokens | 輸出 $0.40-$0.60 / 百萬 tokens - [gpt-4o-mini](https://runapi.ai/zh-HK/models/gpt/4o-mini.md) — 由 OpenAI 提供 · 輸入 $0.12 / 百萬 tokens | 輸出 $0.48 / 百萬 tokens - [codex-auto-review](https://runapi.ai/zh-HK/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-HK/models/gpt/5.4-nano.md) — 由 OpenAI 提供 · 輸入 $0.16 / 百萬 tokens | 輸出 $1.00 / 百萬 tokens ### 開始用 GPT 建立產品。 - [建立免費帳戶](https://runapi.ai/zh-HK/login) - [閱讀快速開始 →](https://runapi.ai/zh-HK/docs/api/openai/chat-completions) ## 正在與團隊一起建立？ 我們可以協助企業設定、整合和技術問題。 [聯絡我們](https://runapi.ai/zh-HK/contact.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-HK/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [x402](https://runapi.ai/zh-HK/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) ### 法律 - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "SoftwareApplication", "name": "GPT gpt-4.1-mini", "applicationCategory": "DeveloperApplication" }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/zh-HK" }, { "@type": "ListItem", "position": 2, "name": "Models", "item": "https://runapi.ai/zh-HK/models" }, { "@type": "ListItem", "position": 3, "name": "GPT", "item": "https://runapi.ai/zh-HK/models/gpt" }, { "@type": "ListItem", "position": 4, "name": "gpt-4.1-mini", "item": "https://runapi.ai/zh-HK/models/gpt/4.1-mini" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "HowTo", "name": "四步使用 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-HK/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-HK/models/gpt/4.1-mini#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "調用", "text": "使用該模型支援的 API 格式送出請求，並將 model 欄位設為本頁顯示的模型 ID。RunAPI 會將請求轉發給供應商。", "url": "https://runapi.ai/zh-HK/models/gpt/4.1-mini#how-step-3" }, { "@type": "HowToStep", "position": 4, "name": "接收", "text": "從同一次調用中讀取回應，或在生成過程中以串流方式接收。usage 欄位顯示您被收費的 token。", "url": "https://runapi.ai/zh-HK/models/gpt/4.1-mini#how-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@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 顯示嘅 model ID。" } }, { "@type": "Question", "name": "這個 variant 的 rate limit 係多少？", "acceptedAnswer": { "@type": "Answer", "text": "每個 key 的 rate limit 會按使用層級而定。請查看定價頁了解最新限制。" } }, { "@type": "Question", "name": "之後可以切換 variant 嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以——variant 只係一個旗標。只要更改 model 參數就可以切換。" } }, { "@type": "Question", "name": "支援 streaming 嗎？", "acceptedAnswer": { "@type": "Answer", "text": "在可用 streaming 的情況下，RunAPI 會端到端串流。" } }, { "@type": "Question", "name": "我應該在邊度回報品質問題？", "acceptedAnswer": { "@type": "Answer", "text": "可以在公開 GitHub repo 開 issue，或者電郵支援團隊。" } }, { "@type": "Question", "name": "需要獨立的供應商帳戶嗎？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。你的 RunAPI API key 足以存取此 variant 及目錄中的所有其他模型，無需底層供應商帳戶。" } } ] } ] ```