n1n Docs
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
WeChat
QQ
Telegram
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. IDE/Plugin/App Setting
  • n1n AI Gateway
  • 🔥 Quick Start in 10 Minutes
  • Quick Start Guide
  • Online Debugging Instructions
  • Send Request
  • Contact Us
  • Basic Introduction
    • Group Detailed Table
    • Specialties of Groups and Price Differences
    • Large Model API URL
  • Chat Model
    • ChatGPT API
      • ChatGPT Audio
        • Gemini Image Generation [Chat Compatible]
        • Audio to Transcriptions (Whisper-1)
        • Audio to Transcriptions (GPT-4o-transcribe)
        • Create Speech
        • Create Translations (Unsupport)
      • ChatGPT Chat
        • Chat Completion Chunk Object
        • Chat Completion Object
        • Create Chat Completions (Stream)
        • Create Chat Completions Deepseek v3.1 thinking (Stream)
        • Create Chat Completions (Not Stream)
        • Chat API [Chat Compatible]
        • Create Chat Image Recognition (Stream)
        • Create Chat Image Recognition (Stream) - base64
        • Create Chat Image Recognition (Not Stream)
        • Create Chat Image Generation (Not Stream)
        • Official Function Calling
        • Official N test
        • List Models
        • Create Chat Function (Only Not Stream)
        • Create Structured Output Format
        • Create Chat Reasoning Effort
      • ChatGPT Responses
        • Responses API vs Chat API
        • Create Responses
        • Create Function
        • Create Responses (Stream)
        • Create Responses (Reasoning Effort)
        • Create Deep Research (Very Expensive)
        • Create Web Search
        • Create Responses (GPT-5 Reasoning Effort)
      • ChatGPT Completions
        • Completions Object
        • Create Completions
      • ChatGPT Embeddings
        • Embeddings Object
        • Create Embeddings
      • Web Search
        • Web Search
    • Anthropic Claude API
      • Chat Completion Object
      • Chat Completion Chunk Object
      • Create Chat Completions (Stream) [Official Format]
      • Create Function (Stream) [Official Format]
      • Create Chat thinking [Official Format]
      • Create Chat thinking
      • Create Chat Completions (Stream)
      • Create Chat Completions (Not Stream)
      • Create Chat Image Recognition (Stream)
      • Create Chat Image Recognition (Not Stream)
    • Gemini API
      • Official Format
        • Chat API [Official Format]
        • Chat API - Stream [Official Format]
        • Chat + Thinking - Stream [Official Format]
        • Image Generation [Official Format]
        • Image Edit [Official Format] Gemini-2.5-Flash-Image-Preview
        • Image Edit [Official Format]
        • Image Understanding [Official Format]
        • Structured Output [Official Format]
        • Function [Official Format]
        • Document Understanding [Official Format]
        • Video Understanding - base64 [Official Format]
        • Chat - Read Web Page [Official Format] (in development)
        • Video Understanding - URL [Official Format] (in development)
        • Imagen 3 Image Generation [Official Format] (in development)
      • Chat Compatible
        • Gemini Image Generation [Chat Compatible]
        • Chat API [Chat Compatible]
        • Image Recognition [Chat Compatible]
        • Chat + Read File [Chat Compatible]
  • Image Generation
    • README
    • Image Object
    • Midjourney
      • Upload Image
      • Submit Imagine Task
      • Fetch Status with Task ID
      • List Task by ID
      • Fetch Task Image Seed
      • Submit Action
      • Submit Blend
      • Submit Describe
      • Submit Shorten
      • Submit Modal
      • Submit Swap Face
    • Ideogram
      • Generate 3.0 Generate Image
      • Generate 3.0 Image Edit
      • Generate 3.0 Remix
      • Generate 3.0 Reframe
      • Generate 3.0 Replace Background
      • Text to Image
      • Remix
      • Upscale
      • Describe
    • GPT-Image-1
      • Create GPT-Image-1
      • Edit GPT-Image-1
      • Mask GPT-Image-1
    • DALL·E 3
      • Create DALL·E 3
    • FLUX
      • GPT Compatible
        • Flux Create (OpenAI DALL-E-3 Format)
        • Flux Edit (OpenAI DALL-E-3 Format)
      • Replicate (Official Format)
        • Flux Aspect Ratio
        • Tutorial
        • Query Task
        • Create Task (black-forest-labs/flux-kontext-dev)
    • Fal.ai
      • Status Code
      • Fetch Result by Request ID
      • /fal-ai/nano-banana Image Generation
      • /fal-ai/nano-banana/edit Image Edit
    • Dreamina
      • Create Image
      • Edit Image
    • Doubao-Seedream
      • doubao-seedream-3-0-t2i-250415
      • doubao-seededit-3-0-i2i-250628
      • doubao-seedream-4-0-250828 Text to Image
      • doubao-seedream-4-0-250828 Image to Image
      • doubao-seedream-4-0-250828 Generation via Multi-Image
      • doubao-seedream-4-5-251128 Text to One Image
      • doubao-seedream-4-5-251128 Generation (One Image + Text)
      • doubao-seedream-4-5-251128 Multi-Image to One Image
      • doubao-seedream-4-5-251128 Multi-Image Generation
      • doubao-seedream-4-5-251128 One Image to Multi-Image
      • doubao-seedream-4-5-251128 Multi-Image to Multi-Image
    • Qwen-Image
      • qwen-image-edit-2509
    • Stable-Diffusion
  • Video Generation
    • Veo
      • United Format
        • Status Code
        • Create Video
        • Create Video with Image
        • Query
        • Create Video (from Referal Image)
      • OpenAI Format
        • Create Video with Image
        • Query
        • Video Download
    • luma
      • Official API Format
        • Status Code
        • Create Video
        • Extend Video
      • Query
        • Query by Task ID
        • Fetch Task Batch
    • Kling
      • Callback协议
      • Image Generation
      • Text to Video
      • Image to Video
      • Query by Task ID (Free)
      • Video Generation (from Multi-Image)
      • Virtual Try-On
      • Lip-Sync
      • Video Extend
      • Video Effects
    • Runway
      • Status Code
      • Create Video
      • Query by Task ID (Free)
    • Dreamina
      • Status Code
      • United Format
        • Create Video
        • Query
      • Official Format
      • Create Video
      • Query by Task ID (Free)
    • Hailuo
      • Status Code
      • Create Video
      • Query by Task ID
      • Image to Video
      • Video Generation by First_Last_Frame
    • Doubao
      • Text to Video
      • Image to Video - First Frame
      • Seedance-Lite from First_Last_Frame
      • Image to Video -base64
      • Seedance-Lite from Referral Image
      • Query by Task ID
      • Query Task List (Default)
      • Query Task List - Filter Multiple Task ID
    • Sora
      • United Format
        • Query
        • Create Video with Image, Sora-2
        • Create Video, Sora-2
        • Create Video, Sora-2-pro
        • Create Video with Character
      • Chat Compatible
        • Create Video
        • Create Video with Image
        • Video Generation (Continued Edit)
      • OpenAI Official Format
        • Query
        • Video Download
        • Create Video with Image
        • Create Video with Shot/Scene
        • Create Video with Image -Private
        • Create Video with Character
        • Video Edit
      • Create Characters
    • Grok
      • United Format
        • Create Video
        • Query
        • Create Video
        • Query
    • Tongyi Wan
      • Video Generation
      • Query
  • GPTs
    • GPT-4-All (Image Analysis)
    • GPT-4-All (Image Generation)
    • GPTs Dialogue
  • Platform API
    • Fetch Token List
    • Create Token
    • Fetch Model List of Token
    • Fetch Account Information
  • Suno
    • Readme
    • Parameters
    • Submit Task
      • Generation (GPT_Description_Prompt)
      • Generation (Prompt)
      • Generation (Continuation)
      • Generation (Persona)
      • Generation (by Song)
      • Generation (Extend by Another Song)
      • Lyrics Generation
      • Song Concatation
    • Query
      • Fetch Task Batch
      • Query by Task ID
      • Fetch WAV
  • Rerank
    • Rerank API
  • NodeJS Setting
    • NodeJS Basic Dialogue
  • Fal-ai
    • Tutorial
    • Falai-veo3 Video Generation
      • /fal-ai/veo3
      • /fal-ai/veo3/fast/image-to-video
      • /fal-ai/veo3/fast
      • /fal-ai/veo3/requests/{request_id}
      • /fal-ai/veo3/image-to-video
    • Fetch Result by Request ID
    • /fal-ai/flux-1/dev
    • /fal-ai/flux-1/dev/image-to-image
    • /fal-ai/flux-1/dev/redux
    • /fal-ai/flux-1/schnell/redux
    • /fal-ai/flux-pro/kontext
    • /fal-ai/flux-pro/kontext/text-to-image
    • /fal-ai/flux-pro/kontext/max
    • /fal-ai/flux-pro/kontext/max/multi
    • /fal-ai/wan/v2.2-a14b/image-to-image
    • /fal-ai/bytedance/seedream/v4/text-to-image
    • /fal-ai/bytedance/seedream/v4/edit
    • /fal-ai/vidu/reference-to-image
    • /fal-ai/imagen4/preview
    • /fal-ai/qwen-image-edit-lora
    • /fal-ai/qwen-image-edit-plus
    • /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
    • /fal-ai/kling-video/v2.5-turbo/pro/image-to-video
    • /fal-ai/flux-lora
    • /fal-ai/flux-lora/image-to-image
    • /fal-ai/flux-lora/inpainting
    • /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
    • /fal-ai/qwen-image-edit-lora
  • Replicate
    • Tutorial
    • Flux Aspect Ratio
    • 查询任务
    • 创建任务 black-forest-labs/flux-kontext-dev
    • 创建任务-通过模型version(predictions)
    • 创建任务 stability-ai/stable-diffusion
    • 创建任务 stability-ai/sdxl
    • 创建任务 stability-ai/stable-diffusion-inpainting
    • 创建任务 stability-ai/stable-diffusion-img2img
    • 创建任务 lucataco/flux-schnell-lora
    • 创建任务 lucataco/flux-dev-lora
    • 创建任务 andreasjansson/stable-diffusion-animation
    • 创建任务 sujaykhandekar/object-removal
    • 创建任务 cjwbw/rembg
    • 创建任务 lucataco/animate-diff
    • 创建任务 ideogram-ai/ideogram-v2-turbo
    • 创建任务 minimax/video-01-live
    • 创建任务 minimax/video-01
    • 创建任务 recraft-ai/recraft-v3
    • 创建任务 recraft-ai/recraft-v3-svg
    • 创建任务 black-forest-labs/flux-1.1-pro-ultra
    • 创建任务 black-forest-labs/flux-kontext-pro
    • 创建任务 black-forest-labs/flux-kontext-max
    • 创建任务 flux-kontext-apps/multi-image-kontext-max
    • 创建任务 flux-kontext-apps/multi-image-kontext-pro
    • 创建任务 lucataco/remove-bg
    • 创建任务 riffusion/riffusion
    • 创建任务 black-forest-labs/flux-fill-dev
    • 创建任务 black-forest-labs/flux-fill-pro
    • 创建任务 google/imagen-4-fast
    • 创建任务 google/imagen-4-ultra
    • 创建任务 google/imagen-4
    • 创建任务 prunaai/vace-14b
    • 创建任务 bytedance/seedream-4
  • Python Setting
    • Python OpenAI 官方库(使用 AutoGPT,Langchain等)
    • Python 连续对话
    • Python 使用语音转文本
    • Python 使用文本转语音
    • Python 使用 Embeddings 向量化
    • Python 调用 DALL·E
    • Python 简单调用 OpenAI Function Calling Demo
    • Python 简单 Langchain 调用 OpenAI Demo
    • Python Llama_index 配置
    • Python 使用 GPT-4o 识别图片 - 本地图片
    • Python 库流式输出
    • GPT Realtime 模型调用
    • Python Request 请求流式输出 Demo
    • Python 使用 GPT-Image-1 创建编辑图片
    • Python 基础对话
    • Python 使用 GPT-4o 识别图片
    • Python 使用 Claude 识别图片
  • PHP Setting
    • PHP Demo (Image Edit)
  • IDE/Plugin/App Setting
    • LobeChat 配置教程
    • Cherry Studio 调用 Claude MCP
    • CodeX CLI 配置使用教程
    • Claude Code 安装使用教程
    • Gemini CLI 配置使用教程
    • Dify 添加模型
    • Cline 配置教程
    • Aider 配置教程
    • Cursor 配置教程
    • ChatBox(推荐使用)
    • 开源 GPT Academic 配置教程
    • NextChat 设置教程
    • Zotero GPT 配置方法
    • Claude Dev 配置教程
    • 沉浸式翻译 设置 GPT 翻译
    • ChatGPT Sidebar 插件
    • ChatGPT-on-WeChat 配置教程
  • FAQ
    • 问题自查方法
    • 入门必看
      • 我注册了,key 在哪?
      • 如何充值?没有美金能充吗?
      • 可以使用哪些大模型 API ?
      • 如何获取 OpenAI Key ? 如何获取 Claude Key ? 如何获取 Gemini Key ?
      • 怎么更换模型使用?
      • 接口在中国大陆能使用吗?
      • 按量计费还是按月支付?
      • 为什么有 3 个 Base URL 到底用哪个?
      • 使用 Anthropic Claude,填写那个 URL?Claude-3-5-sonnet 模型的 Base URL 要填什么?
      • 怎么检查一次调用消耗了多少 Token?
      • 提示和补全分别指什么?
      • 请问我余额为负了怎么回事?
    • 常见误区
      • Playground 功能好差?
      • 明明余额还有很多,为什么显示令牌无法使用?
      • 接口调用很卡,有办法稳定么?
      • Key 为什么不能用?为什么我调用 API 没反应?
      • 咱们这的接口请求数限制是怎样的,多个 Key 一起跑是不是并发更大?
      • 单个 Key 的并发或 RPM、TPM 有限制吗?
      • 新建令牌参数怎么填?
      • 为什么调用接口返回“无效的令牌”?
    • 使用疑问
      • 可以使用 o1 吗?满血版 o1
      • n1n 支持 Text Embedding 吗?
      • API 接口返回报错,报错代码 400 401 403 404 405 413 429 500 503 504 524 是什么意思?
      • 支持各类开源软件 ChatBox、Dify、Cling 等等接入 n1n 吗?
      • 怎么在 VBA 里对接?代码示例有吗?
      • 能使用 .env 存放 API Key 吗?
      • 示例中用 OpenAI,如果用 Claude 3.5 也可以用吧?
    • 隐私安全
      • 你们会保留对大模型的调用记录和调用内容吗?
      • 请问你们的 API,是真的在调用官方的模型输出,还是魔改的?就怕买的是 OpenAI 的接口,输出的是你们自己训练的开源模型结果。
    • 商务合作问题
      • 企业合作怎么开通,价格如何?
      • 企业合作的话是怎么签订合同?
      • 能开发票吗?开出来的票是什么类目?
      • 企业合作有没有更多折扣?
      • 为什么有的分组价格接近原价?
    • 其他
      • 密码忘记了怎么办?在哪里可以找回密码?
  • LLM Wiki
    • 基础概念
      • 大语言模型(LLM)
      • Token 与分词
  • Help Center
    • AI 返回字段:思考相关
    • HTTP 状态码及其含义
  • Links
    • 大模型API接口企业站
    • 大模型API接口国际站
  • Terms & Privacy
    • Privacy Policy
    • User Agreement
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
WeChat
QQ
Telegram
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
🇺🇸 English
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. IDE/Plugin/App Setting

Gemini CLI 配置使用教程

Gemini CLI 中文使用指南#

基本介绍#

Gemini CLI 是谷歌提供的开源命令行 AI 工具,将 Gemini 的强大功能直接带入您的终端。它提供轻量级的 Gemini 访问方式,为您提供从提示到模型的最直接路径。通过设置中转代理,您可以在网络受限的情况下正常使用 Gemini CLI 服务。

🚀 为什么选择 Gemini CLI?#

🧠 强大的 Gemini 2.5 Pro:访问 100 万 token 上下文窗口
🔧 内置工具:Google 搜索基础功能、文件操作、Shell 命令、网页抓取
🔌 可扩展:支持 MCP(模型上下文协议)进行自定义集成
💻 终端优先:专为在命令行中工作的开发者设计
🛡️ 开源:Apache 2.0 许可证

📦 安装方式#

快速安装#

使用 npx 即时运行(无需安装)#

使用 npm 全局安装#

使用 Homebrew 安装(macOS/Linux)#

系统要求#

Node.js 版本 20 或更高
macOS、Linux 或 Windows

配置使用#

1. 设置环境变量#

在使用中转站之前,您需要配置以下环境变量:
注意:您也可以将这些环境变量添加到 .bashrc、.zshrc 或其他 shell 配置文件中,这样每次启动终端时都会自动设置这些变量。

🚀 快速开始#

基本使用#

在当前目录启动#

包含多个目录#

使用特定模型#

脚本非交互模式#

获取简单文本响应:
获取结构化 JSON 输出:

快速示例#

启动新项目#

分析现有代码#

📋 主要功能#

代码理解与生成#

查询和编辑大型代码库
使用多模态能力从 PDF、图片或草图生成新应用
使用自然语言调试问题和故障排除

自动化与集成#

自动化操作任务,如查询拉取请求或处理复杂的变基操作
使用 MCP 服务器连接新功能
在脚本中非交互式运行以实现工作流自动化

高级功能#

使用内置 Google 搜索获取实时信息
对话检查点以保存和恢复复杂会话
自定义上下文文件(GEMINI.md)为您的项目定制行为

常用命令和功能示例#

探索代码库#

> 描述这个系统架构的主要组成部分
> 有哪些安全机制?
> 为新开发者提供一份分步骤的入门文档

处理现有代码#

> 为 GitHub issue #123 实现一个初稿
> 帮我将这个代码库迁移到最新版本的 Java。先制定一个计划

自动化工作流程#

> 制作一个幻灯片,展示过去 7 天的 git 历史,按功能和团队成员分组
> 制作一个全屏 Web 应用用于墙上显示,展示我们互动最多的 GitHub issues

系统交互#

> 将此目录中的所有图像转换为 png,并使用 exif 数据中的日期重命名它们
> 按支出月份整理我的 PDF 发票

GitHub 集成#

使用 Gemini CLI GitHub Action 将 Gemini CLI 直接集成到您的 GitHub 工作流中:
拉取请求审查:自动代码审查,提供上下文反馈和建议
Issue 分类:基于内容分析自动标记和优先级排序 GitHub issues
按需帮助:在 issues 和拉取请求中提及 @gemini-cli 获取调试、解释或任务委派的帮助
自定义工作流:构建适合您团队需求的自动化、定时和按需工作流

故障排除#

如果您在使用过程中遇到问题,可以参考以下几点:
1.
检查环境变量是否正确设置:
2.
检查网络连接是否稳定,中转站是否可访问:
3.
查看是否有错误信息输出,这些信息通常会指示问题所在
4.
如果使用 SOCKS 代理,确保代理格式正确,例如 socks5://<user>:<pass>@<proxy>:<port>
5.
使用内置命令报告问题:

发布版本说明#

预览版(Preview)#

每周二 UTC 23:59 发布新的预览版本。使用 preview 标签安装:

稳定版(Stable)#

每周二 UTC 20:00 发布新的稳定版本。使用 latest 标签安装:

每夜版(Nightly)#

每天 UTC 00:00 发布每夜版本。使用 nightly 标签安装:

MCP 服务器使用#

在 ~/.gemini/settings.json 中配置 MCP 服务器以扩展 Gemini CLI 的自定义工具:
> @github 列出我的开放拉取请求
> @slack 向 #dev 频道发送今天提交的摘要
> @database 运行查询查找不活跃用户

📚 相关资源#

官方路线图:查看即将推出的功能
NPM 包:包注册表
GitHub Issues:报告 bug 或请求功能
安全建议:安全更新

卸载#

如果您需要卸载 Gemini CLI,请参考官方的卸载指南。
Modified at 2025-12-11 01:21:36
Previous
Claude Code 安装使用教程
Next
Dify 添加模型
Built with