---
title: gemini-3-flash-preview API — Gemini 價格與規格 | RunAPI
description: 透過 RunAPI 使用 gemini-3-flash-preview——Gemini 系列。按次計費、model ID、規格與開發者入門指南。
url: https://runapi.ai/zh-TW/models/gemini/3-flash-preview.md
canonical: https://runapi.ai/zh-TW/models/gemini/3-flash-preview
locale: zh-TW
site: RunAPI
image: https://runapi.ai/assets/opengraph-f702f2b1.png
alternates:
  en: https://runapi.ai/models/gemini/3-flash-preview
  zh-CN: https://runapi.ai/zh-CN/models/gemini/3-flash-preview
  es: https://runapi.ai/es/models/gemini/3-flash-preview
  ja: https://runapi.ai/ja/models/gemini/3-flash-preview
  de: https://runapi.ai/de/models/gemini/3-flash-preview
  fr: https://runapi.ai/fr/models/gemini/3-flash-preview
  pt-BR: https://runapi.ai/pt-BR/models/gemini/3-flash-preview
  ko: https://runapi.ai/ko/models/gemini/3-flash-preview
  it: https://runapi.ai/it/models/gemini/3-flash-preview
  nl: https://runapi.ai/nl/models/gemini/3-flash-preview
  pl: https://runapi.ai/pl/models/gemini/3-flash-preview
  tr: https://runapi.ai/tr/models/gemini/3-flash-preview
  zh-TW: https://runapi.ai/zh-TW/models/gemini/3-flash-preview
  zh-HK: https://runapi.ai/zh-HK/models/gemini/3-flash-preview
  ar: https://runapi.ai/ar/models/gemini/3-flash-preview
  x-default: https://runapi.ai/models/gemini/3-flash-preview
model: Gemini
provider: Google
variant_id: gemini-3-flash-preview
sdk_model_id: gemini-3-flash-preview
modality: text
billing_unit: 1K tokens
status: active
---

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


# gemini-3-flash-preview API

透過 RunAPI 使用 Gemini 系列的 gemini-3-flash-preview。按次計費，無訂閱費，失敗的生成不收費。

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

gemini-3-flash-preview 在 Gemini 系列中，兼顧品質與成本的最佳平衡。

- 以美元按次計費
- 生成失敗不收費
- 模型支援時可串流輸出
- Model skill setup

## 價格

### `chat_completion`

- Input: $0.50 / 1M tokens
- Output: $3.00 / 1M tokens
- Cache read: $0.05 / 1M tokens

### `stream_generate_content`

- Input: $0.30 / 1M tokens
- Output: $1.80 / 1M tokens
- Cache read: $0.03 / 1M tokens


失敗的生成不收費

## 技術細節

| Field | Value |
|---|---|
| Model ID | `gemini-3-flash-preview` |
| 供應商 | Google |
| 模態 | text |
| 任務類型 | synchronous |
| 計費單位 | 1K tokens |
| API endpoint | `/v1/chat/completions` |
|  | `/v1/responses` |
|  | `/v1/messages` |
|  | `/v1beta/models/gemini-3-flash-preview:generateContent` |
|  | `/v1beta/models/gemini-3-flash-preview:streamGenerateContent` |
| 商用授權 | 是 — 已透過 API 包含 |
| 目錄狀態 | 可直接上線 |

**Request example**

```json
{
  "model": "gemini-3-flash-preview",
  "contents": [
    {
      "parts": [
        {
          "text": "Analyze this codebase and suggest three performance improvements with before/after examples."
        }
      ]
    }
  ]
}
```

## 快速開始 — gemini-3-flash-preview

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

Use the OpenAI or Anthropic SDK with your RunAPI API key and `model: "gemini-3-flash-preview"`.

## 四步驟使用 gemini-3-flash-preview

1. **安裝** — 安裝此 model line 的 model skill。
2. **設定** — 將 model 欄位設定為此頁面顯示的完整 model ID。
3. **呼叫** — 使用您的 prompt、inputs 和 callback 設定送出型別化請求。
4. **接收** — 讀取 RunAPI 的 task 回應、webhook callback 或快取輸出 URL。

## gemini-3-flash-preview 有什麼不同

- **VS GEMINI-2.5-FLASH: gemini-3-flash-preview** — Speed/cost optimized; 1M context; older generation baseline
- **VS GEMINI-2.5-PRO: gemini-3-flash-preview** — Best reasoning in 2.5 gen; 1M context
- **VS GEMINI-3.1-PRO-PREVIEW: gemini-3-flash-preview** — gemini-3.1-pro-preview

## 最適合

- **客服支援** — 從私有知識庫回答顧客問題，減少工單量。
- **文件分析** — 起草合約摘要，並標示關鍵條款供律師審閱。
- **程式碼生成** — 在 CI 中自動產生單元測試、程式碼審查與重構建議。

## 關於 gemini-3-flash-preview 的常見問題

### 模型 ID 在不同版本之間會保持穩定嗎？

RunAPI 會維持 model ID 穩定，並在不改變請求格式的情況下處理相容版本更新。

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

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

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

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

### 它支援串流嗎？

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

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

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


### Gemini 的其他 variant

- [gemini-2.5-flash](https://runapi.ai/zh-TW/models/gemini/2.5-flash.md) — `gemini-2.5-flash` · Input $0.30 / 1M tokens | Output $2.50 / 1M tokens
- [gemini-2.5-pro](https://runapi.ai/zh-TW/models/gemini/2.5-pro.md) — `gemini-2.5-pro` · Input $1.25-$2.50 / 1M tokens | Output $10.00-$15.00 / 1M tokens
- [gemini-3.1-pro-preview](https://runapi.ai/zh-TW/models/gemini/3.1-pro-preview.md) — `gemini-3.1-pro-preview` · Input $1.00-$2.00 / 1M tokens | Output $7.00-$10.50 / 1M tokens
- [gemini-3.5-flash](https://runapi.ai/zh-TW/models/gemini/3.5-flash.md) — `gemini-3.5-flash` · Input $1.50 / 1M tokens | Output $9.00 / 1M tokens · Input $0.90 / 1M tokens | Output $5.40 / 1M tokens
- [gemini-3.6-flash](https://runapi.ai/zh-TW/models/gemini/3.6-flash.md) — `gemini-3.6-flash` · Input $1.50 / 1M tokens | Output $7.50 / 1M tokens · Input $0.90 / 1M tokens | Output $4.50 / 1M tokens

### 其他模型的替代方案

- [Claude](https://runapi.ai/zh-TW/models/claude.md) — Anthropic's LLM for complex reasoning, code, analysis, and extended-context tasks.
- [DeepSeek](https://runapi.ai/zh-TW/models/deepseek.md) — Reasoning-first LLMs via RunAPI — flash for fast, low-cost work; pro for complex agentic tasks.
- [Embedding](https://runapi.ai/zh-TW/models/embedding.md) — OpenAI 文字嵌入，用於語意搜尋、檢索、分群與排序 workflow。

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

- [建立免費帳戶](https://runapi.ai/zh-TW/login)
- [閱讀快速入門 →](https://runapi.ai/docs/api/gemini/generate-content)

---

## More from RunAPI

- [Home](https://runapi.ai/zh-TW/.md)
- [模型](https://runapi.ai/zh-TW/models.md)
- [AI 影片 API 比較](https://runapi.ai/zh-TW/ai-video-api-comparison.md)
- [OpenClaw 整合](https://runapi.ai/zh-TW/openclaw.md)
- [OpenClaw 最佳 API](https://runapi.ai/zh-TW/best-api-for-openclaw.md)
- [OpenClaw 圖片生成](https://runapi.ai/zh-TW/openclaw-image-generation.md)
- [Hermes Agent 整合](https://runapi.ai/zh-TW/hermes-agent.md)
- [價格](https://runapi.ai/zh-TW/pricing.md)
- [Claude API 價格](https://runapi.ai/zh-TW/claude-api-pricing.md)
- [ChatGPT API 價格](https://runapi.ai/zh-TW/chatgpt-api-pricing.md)
- [OpenAI API 價格](https://runapi.ai/zh-TW/openai-api-pricing.md)
- [Gemini API 價格](https://runapi.ai/zh-TW/gemini-api-pricing.md)
- [Claude Code 價格](https://runapi.ai/zh-TW/claude-code-pricing.md)
- [Claude Code API](https://runapi.ai/zh-TW/claude-code-api.md)
- [Claude Code 對比 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md)
- [Claude Max 對比 API](https://runapi.ai/zh-TW/claude-max-vs-api.md)
- [Requesty 替代方案](https://runapi.ai/zh-TW/requesty-alternative.md)
- [文件](https://runapi.ai/zh-TW/docs/guides)
- [SDK](https://runapi.ai/zh-TW/sdk.md)
- [技能](https://runapi.ai/zh-TW/skills.md)
- [MCP Server](https://runapi.ai/zh-TW/mcp.md)
- [CLI](https://runapi.ai/zh-TW/cli.md)
- [意見回饋](https://runapi.makethisbetter.dev)
- [聯絡我們](mailto:support@runapi.ai)
- [服務條款](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-flash-preview",
    "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-flash-preview",
        "item": "https://runapi.ai/zh-TW/models/gemini/3-flash-preview"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "HowTo",
    "name": "四步驟使用 gemini-3-flash-preview",
    "description": "透過 RunAPI 使用 gemini-3-flash-preview——Gemini 系列。按次計費、model ID、規格與開發者入門指南。",
    "totalTime": "PT5M",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "安裝",
        "text": "安裝此 model line 的 model skill。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3-flash-preview#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "設定",
        "text": "將 model 欄位設定為此頁面顯示的完整 model ID。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3-flash-preview#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "呼叫",
        "text": "使用您的 prompt、inputs 和 callback 設定送出型別化請求。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3-flash-preview#how-step-3"
      },
      {
        "@type": "HowToStep",
        "position": 4,
        "name": "接收",
        "text": "讀取 RunAPI 的 task 回應、webhook callback 或快取輸出 URL。",
        "url": "https://runapi.ai/zh-TW/models/gemini/3-flash-preview#how-step-4"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-TW",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "模型 ID 在不同版本之間會保持穩定嗎？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "RunAPI 會維持 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，或寄信給支援。"
        }
      }
    ]
  }
]
```