---
title: Gemini 3.1 Flash-Lite API：模型 ID、100 萬上下文與 OpenAI SDK | RunAPI
description: 透過 RunAPI 的 OpenAI 相容 Chat Completions API 呼叫 gemini-3.1-flash-lite。100 萬 token 上下文，65K 輸出，可調整思考，支援文字輸入。
url: https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite.md
canonical: https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite
locale: zh-TW
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/models/gemini/3.1-flash-lite
  zh-CN: https://runapi.ai/zh-CN/models/gemini/3.1-flash-lite
  es: https://runapi.ai/es/models/gemini/3.1-flash-lite
  ja: https://runapi.ai/ja/models/gemini/3.1-flash-lite
  de: https://runapi.ai/de/models/gemini/3.1-flash-lite
  fr: https://runapi.ai/fr/models/gemini/3.1-flash-lite
  pt-BR: https://runapi.ai/pt-BR/models/gemini/3.1-flash-lite
  ko: https://runapi.ai/ko/models/gemini/3.1-flash-lite
  it: https://runapi.ai/it/models/gemini/3.1-flash-lite
  nl: https://runapi.ai/nl/models/gemini/3.1-flash-lite
  pl: https://runapi.ai/pl/models/gemini/3.1-flash-lite
  tr: https://runapi.ai/tr/models/gemini/3.1-flash-lite
  zh-TW: https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite
  zh-HK: https://runapi.ai/zh-HK/models/gemini/3.1-flash-lite
  ar: https://runapi.ai/ar/models/gemini/3.1-flash-lite
  x-default: https://runapi.ai/models/gemini/3.1-flash-lite
model: Gemini
provider: Google
variant_id: gemini-3.1-flash-lite
sdk_model_id: gemini-3.1-flash-lite
modality: text
billing_unit: 1K tokens
status: active
---

> HTML version: https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite
> Site index for agents: https://runapi.ai/llms.txt


# gemini-3.1-flash-lite API

透過 RunAPI 調用 Gemini 系列的 gemini-3.1-flash-lite。按 token 計費，無需訂閱，回應開始前失敗的請求不收費。

**Google / [Gemini](https://runapi.ai/zh-TW/models/gemini.md)**
**可直接上線 · text · 可商用**

## Gemini 3.1 Flash-Lite 適合用來做什麼

Gemini 3.1 Flash-Lite 是 Google Gemini 3 系列中低延遲、低成本的模型。Google 將它用於大量的簡單工作，例如翻譯、分類與實體擷取、文件分流，以及在模型之間分派請求。穩定版 gemini-3.1-flash-lite 於 2026 年 5 月 7 日正式推出（GA）。上下文視窗為 1,048,576 token，最多輸出 65,536 token。

思考可以調整：Google 提供從 minimal 到 high 共四個思考等級，思考 token 會計入輸出。Google 在這個模型上支援函式呼叫與結構化輸出。

Google 的模型接受文字、圖片、影片、音訊與 PDF 輸入。在 RunAPI 上，gemini-3.1-flash-lite 只接受文字輸入。可透過 OpenAI 相容的 Chat Completions 端點（/v1/chat/completions）、OpenAI Responses、Anthropic Messages 或 Gemini generateContent 傳送請求。Google 指定 Gemini 3.5 Flash-Lite 為後繼模型，它在 RunAPI 上的模型 ID 為 gemini-3.5-flash-lite。

**模型 ID:** gemini-3.1-flash-lite
**發布日期:** 2026 年 5 月 7 日（正式推出）
**上下文視窗:** 1,048,576 token
**最大輸出:** 65,536 token
**思考:** 可調整，從 minimal 到 high
**最早停用日期（Google）:** 2027 年 5 月 7 日
**RunAPI 上的端點:** OpenAI Chat Completions，文字輸入



<!-- catalog-model-detail-slot: model-playground -->

## 試用 Gemini 3.1 Flash-Lite

選擇任一模型，幾秒內即可開始生成。


**模型:**
- **Chat completion** — `chat_completion` · `gemini-3.1-flash-lite` · 輸入 $0.25 / 百萬 tokens | 輸出 $1.50 / 百萬 tokens

**提示詞:** 描述您想創作的內容...

**預估：** 輸入 $0.25 / 百萬 tokens | 輸出 $1.50 / 百萬 tokens

- [生成](https://runapi.ai/zh-TW/login)
請登入以使用 RunAPI 生成。
<!-- /catalog-model-detail-slot: model-playground -->

### 切換 variant

- [gemini-2.5-flash](https://runapi.ai/zh-TW/models/gemini/2.5-flash.md)
- [gemini-2.5-flash-lite](https://runapi.ai/zh-TW/models/gemini/2.5-flash-lite.md)
- [gemini-2.5-pro](https://runapi.ai/zh-TW/models/gemini/2.5-pro.md)
- [gemini-3-flash-preview](https://runapi.ai/zh-TW/models/gemini/3-flash-preview.md)
- **gemini-3.1-flash-lite** (current)
- [gemini-3.1-pro-preview](https://runapi.ai/zh-TW/models/gemini/3.1-pro-preview.md)
- [gemini-3.5-flash](https://runapi.ai/zh-TW/models/gemini/3.5-flash.md)
- [gemini-3.5-flash-lite](https://runapi.ai/zh-TW/models/gemini/3.5-flash-lite.md)
- [gemini-3.6-flash](https://runapi.ai/zh-TW/models/gemini/3.6-flash.md)
- [gemini-3.7-flash](https://runapi.ai/zh-TW/models/gemini/3.7-flash.md)
- [gemini-3.8-flash](https://runapi.ai/zh-TW/models/gemini/3.8-flash.md)

11 個版本可用





gemini-3.1-flash-lite 是 RunAPI 上 Gemini 系列的模型之一。它與其他所有模型使用同一組 API key，只需修改請求中的模型 ID 即可切換。每次調用皆為同步調用，依輸入、輸出與快取 token 以 USD 計費，無訂閱，無最低消費。回應開始前失敗的請求不收費；回應開始串流輸出後，已生成的 token 會計費，即使用戶端中斷連線。

- 依 token 以 USD 計費，無需訂閱
- 回應開始前失敗的請求不收費
- 逐 token 串流輸出
- 修改一個模型 ID 即可切換模型
- 所有模型與供應商共用一組 API key、一張帳單

## 使用指標

- **API 呼叫次數 / 天:** 6
- **成功率:** 100.0%
- **平均生成時間:** 1.9s

此模型目前尚無已驗證的客戶回饋。



## 技術細節

| 欄位 | 值 |
|---|---|
| 提供者 | Google |
| 模型 ID | gemini-3.1-flash-lite |
| 模態 | 文字 |
| 任務類型 | Synchronous |
| API 端點 | `/v1/chat/completions` |
|  | `/v1/responses` |
|  | `/v1/messages` |
|  | `/v1beta/models/gemini-3.1-flash-lite:generateContent` |
|  | `/v1beta/models/gemini-3.1-flash-lite:streamGenerateContent` |
| 計費單位 | 1K tokens |
| 目錄狀態 | 可直接上線 |



**使用方式**

## 3 個步驟使用此模型

1. **取得 API 金鑰** - 免費註冊後，從控制台建立 gemini-3.1-flash-lite 的 API 金鑰。
2. **傳送請求** - 向 /v1/chat/completions 傳送 POST 請求，並傳入 gemini-3.1-flash-lite 模型 ID 與參數。
3. **取得結果** - 直接從端點讀取已完成的 gemini-3.1-flash-lite 回應。



<!-- catalog-model-detail-slot: feature-cards -->

## 此模型提供的功能

- **Endpoint 覆蓋範圍** — 公開 1 個公共 endpoint：chat_completion。
- **用量計費** — 依 1K tokens 計量，無需訂閱。
<!-- /catalog-model-detail-slot: feature-cards -->



## Gemini 3.1 Flash-Lite 價格

| API endpoint | 價格 |
|---|---|
| `chat_completion` | 輸入: $0.25 / 百萬 tokens<br>輸出: $1.50 / 百萬 tokens<br>快取讀取: $0.03 / 百萬 tokens |



**API 參考**

## 端點規格

| Field | Value |
|---|---|
| 端點 | `POST /v1/chat/completions` |
| 模型 ID | `gemini-3.1-flash-lite` |
| 工作類型 | `chat_completion` |


<!-- catalog-model-detail-slot: request-parameters -->

## 請求參數

此端點尚未發布請求參數。
<!-- /catalog-model-detail-slot: request-parameters -->

**Request example**

```json
{
  "model": "gemini-3.1-flash-lite",
  "messages": [
    {
      "role": "user",
      "content": "分析這個程式碼庫，提出三項效能改善建議，並附上修改前後的範例。"
    }
  ]
}
```

### 快速開始 — gemini-3.1-flash-lite

相同格式 · 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/gemini-3.1-flash-lite:generateContent` | Gemini generateContent |
| `POST /v1beta/models/gemini-3.1-flash-lite:streamGenerateContent` | Gemini streamGenerateContent |

使用 OpenAI / Anthropic / Google Gen AI SDK，搭配您的 RunAPI API key 與 `model: "gemini-3.1-flash-lite"` 調用。

### 四步驟使用 gemini-3.1-flash-lite

1. **安裝** — 安裝 Gemini 系列對應的 model skill，它會把文件、請求格式與價格說明載入您的程式開發工作區。
2. **設定** — 將 SDK 指向 https://runapi.ai，並設定您的 RunAPI API key。同一組 key 適用於所有模型與供應商。
3. **調用** — 使用該模型支援的 API 格式送出請求，並將 model 欄位設為本頁顯示的模型 ID。RunAPI 會將請求轉發給供應商。
4. **接收** — 從同一次調用中讀取回應，或在生成過程中以串流方式接收。usage 欄位顯示您被計費的 token。

### gemini-3.1-flash-lite 有什麼不同

- **VS GEMINI-2.5-FLASH: Gemini 3.1 Flash-Lite；100 萬上下文，可調整思考；透過 OpenAI 相容 Chat Completions 傳送文字請求** — 針對速度／成本最佳化；1M 上下文；上一代基準模型
- **VS GEMINI-2.5-FLASH-LITE: Gemini 3.1 Flash-Lite；100 萬上下文，可調整思考；透過 OpenAI 相容 Chat Completions 傳送文字請求** — Gemini 2.5 Flash-Lite；100 萬上下文，預設關閉思考；OpenAI 相容 Chat Completions
- **VS GEMINI-2.5-PRO: Gemini 3.1 Flash-Lite；100 萬上下文，可調整思考；透過 OpenAI 相容 Chat Completions 傳送文字請求** — 2.5 世代中推理能力最強；1M 上下文

## 使用情境

**客服支援**

從私有知識庫回答顧客問題，減少工單量。

**文件分析**

起草合約摘要，並標示關鍵條款供律師審閱。

**程式碼生成**

在 CI 中自動產生單元測試、程式碼審查與重構建議。



## 關於 Gemini 3.1 Flash-Lite 的常見問題

### 該用 Gemini 3.1 Flash-Lite 還是 Gemini 3.5 Flash-Lite？

Google 指定 Gemini 3.5 Flash-Lite 為 3.1 Flash-Lite 的後繼模型。新專案建議從 gemini-3.5-flash-lite 開始；如果現有的工作負載、提示集或評估是以 gemini-3.1-flash-lite 建立，就繼續使用它。兩個模型在 RunAPI 上共用同一組 API key。

### Gemini 3.1 Flash-Lite 還能用多久？

Google 將 2027 年 5 月 7 日列為 gemini-3.1-flash-lite 的最早停用日期。預覽版模型已於 2026 年 5 月停用，請使用穩定版模型 ID。

### 能用 OpenAI SDK 呼叫 Gemini 3.1 Flash-Lite 嗎？

可以。將 OpenAI SDK 指向 https://runapi.ai/v1，使用你的 RunAPI API key，傳送 model 為 gemini-3.1-flash-lite 的 Chat Completions 請求。工具採用標準的 OpenAI tools 格式。

### 在 RunAPI 上可以對 gemini-3.1-flash-lite 傳送圖片或音訊嗎？

目前不行。Google 的模型能讀取圖片、影片、音訊與 PDF，但 RunAPI 對 gemini-3.1-flash-lite 只接受文字輸入，包含媒體部分的請求會被拒絕。

### 如何選擇 gemini-3.1-flash-lite？

傳入 quickstart 顯示的 model ID。

### 這個 variant 的速率限制是多少？

每個金鑰的速率限制會依使用方案而調整。請查看定價頁面以了解目前限制。

### 之後可以切換 variant 嗎？

可以——variant 只是旗標。只要變更 model 參數即可切換。

### 它支援串流嗎？

只要支援串流，RunAPI 就會端到端串流。

### 我該在哪裡回報品質問題？

請在公開 GitHub repo 提交 issue，或寄信給支援。


### RELATED

- [gemini-2.5-flash-lite](https://runapi.ai/zh-TW/models/gemini/2.5-flash-lite.md) — 由 Google 提供 · 輸入 $0.10 / 百萬 tokens | 輸出 $0.40 / 百萬 tokens
- [gemini-3.5-flash-lite](https://runapi.ai/zh-TW/models/gemini/3.5-flash-lite.md) — 由 Google 提供 · 輸入 $0.15 / 百萬 tokens | 輸出 $1.25 / 百萬 tokens
- [gemini-2.5-flash](https://runapi.ai/zh-TW/models/gemini/2.5-flash.md) — 由 Google 提供 · 輸入 $0.30 / 百萬 tokens | 輸出 $2.50 / 百萬 tokens
- [gemini-3-flash-preview](https://runapi.ai/zh-TW/models/gemini/3-flash-preview.md) — 由 Google 提供 · 輸入 $0.50 / 百萬 tokens | 輸出 $3.00 / 百萬 tokens · 輸入 $0.30 / 百萬 tokens | 輸出 $1.80 / 百萬 tokens

### 開始使用 Gemini 進行開發。

- [建立免費帳戶](https://runapi.ai/zh-TW/login)
- [閱讀快速入門 →](https://runapi.ai/zh-TW/docs/api/openai/chat-completions)
## 正在與團隊一起打造？

我們可以協助企業接入、整合與技術問題。

[聯絡我們](https://runapi.ai/zh-TW/contact.md)



---

## More from RunAPI

- [Home](https://runapi.ai/zh-TW/.md)
### 產品
- [模型目錄](https://runapi.ai/zh-TW/models.md)
- [價格](https://runapi.ai/zh-TW/pricing.md)
- [提供商](https://runapi.ai/zh-TW/models#all-models)
### 開發者
- [文件](https://runapi.ai/zh-TW/docs/guides)
- [SDK](https://runapi.ai/zh-TW/sdk.md)
- [CLI](https://runapi.ai/zh-TW/cli.md)
- [MCP Server](https://runapi.ai/zh-TW/mcp.md)
- [x402](https://runapi.ai/zh-TW/x402.md)
### 指南
- [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md)
- [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md)
- [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md)
### 公司
- [企業版](https://runapi.ai/zh-TW/contact.md)
- [聯絡我們](https://runapi.ai/zh-TW/contact.md)
### 法律
- [服務條款](https://runapi.ai/zh-TW/terms.md)
- [隱私權](https://runapi.ai/zh-TW/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-TW",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-TWicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "SoftwareApplication",
    "name": "Gemini gemini-3.1-flash-lite",
    "applicationCategory": "DeveloperApplication"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://runapi.ai/zh-TW"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Models",
        "item": "https://runapi.ai/zh-TW/models"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Gemini",
        "item": "https://runapi.ai/zh-TW/models/gemini"
      },
      {
        "@type": "ListItem",
        "position": 4,
        "name": "gemini-3.1-flash-lite",
        "item": "https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "HowTo",
    "name": "四步驟使用 gemini-3.1-flash-lite",
    "description": "透過 RunAPI 調用 Gemini 系列的 gemini-3.1-flash-lite：按 token 計費、模型 ID、支援的 API 格式與接入指南。",
    "totalTime": "PT5M",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "安裝",
        "text": "安裝 Gemini 系列對應的 model skill，它會把文件、請求格式與價格說明載入您的程式開發工作區。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "設定",
        "text": "將 SDK 指向 https://runapi.ai，並設定您的 RunAPI API key。同一組 key 適用於所有模型與供應商。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "調用",
        "text": "使用該模型支援的 API 格式送出請求，並將 model 欄位設為本頁顯示的模型 ID。RunAPI 會將請求轉發給供應商。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite#how-step-3"
      },
      {
        "@type": "HowToStep",
        "position": 4,
        "name": "接收",
        "text": "從同一次調用中讀取回應，或在生成過程中以串流方式接收。usage 欄位顯示您被計費的 token。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3.1-flash-lite#how-step-4"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "該用 Gemini 3.1 Flash-Lite 還是 Gemini 3.5 Flash-Lite？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Google 指定 Gemini 3.5 Flash-Lite 為 3.1 Flash-Lite 的後繼模型。新專案建議從 gemini-3.5-flash-lite 開始；如果現有的工作負載、提示集或評估是以 gemini-3.1-flash-lite 建立，就繼續使用它。兩個模型在 RunAPI 上共用同一組 API key。"
        }
      },
      {
        "@type": "Question",
        "name": "Gemini 3.1 Flash-Lite 還能用多久？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Google 將 2027 年 5 月 7 日列為 gemini-3.1-flash-lite 的最早停用日期。預覽版模型已於 2026 年 5 月停用，請使用穩定版模型 ID。"
        }
      },
      {
        "@type": "Question",
        "name": "能用 OpenAI SDK 呼叫 Gemini 3.1 Flash-Lite 嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。將 OpenAI SDK 指向 https://runapi.ai/v1，使用你的 RunAPI API key，傳送 model 為 gemini-3.1-flash-lite 的 Chat Completions 請求。工具採用標準的 OpenAI tools 格式。"
        }
      },
      {
        "@type": "Question",
        "name": "在 RunAPI 上可以對 gemini-3.1-flash-lite 傳送圖片或音訊嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "目前不行。Google 的模型能讀取圖片、影片、音訊與 PDF，但 RunAPI 對 gemini-3.1-flash-lite 只接受文字輸入，包含媒體部分的請求會被拒絕。"
        }
      },
      {
        "@type": "Question",
        "name": "如何選擇 gemini-3.1-flash-lite？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "傳入 quickstart 顯示的 model ID。"
        }
      },
      {
        "@type": "Question",
        "name": "這個 variant 的速率限制是多少？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "每個金鑰的速率限制會依使用方案而調整。請查看定價頁面以了解目前限制。"
        }
      },
      {
        "@type": "Question",
        "name": "之後可以切換 variant 嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以——variant 只是旗標。只要變更 model 參數即可切換。"
        }
      },
      {
        "@type": "Question",
        "name": "它支援串流嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "只要支援串流，RunAPI 就會端到端串流。"
        }
      },
      {
        "@type": "Question",
        "name": "我該在哪裡回報品質問題？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "請在公開 GitHub repo 提交 issue，或寄信給支援。"
        }
      }
    ]
  }
]
```
