n1n Docs
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
WeChat
QQ
Telegram
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. 各插件 / 软件使用教程
  • n1n AI Gateway
  • 🔥10分钟快速上手
  • 快速开始指南
  • 在线调试说明
  • 发出请求
  • 联系我们
  • 基本介绍
    • 分组详细表格
    • 分组的特殊性及价格差异
    • 如何新建指定分组的令牌
    • 大模型API接口调用地址
  • 聊天模型
    • ChatGPT 接口
      • ChatGPT 音频(Audio)
        • gemini图片创作接口 [chat兼容格式]
        • 音频转文字 whisper-1
        • 音频转文字 gpt-4o-transcribe
        • 创建语音
        • 创建翻译 (不支持)
      • ChatGPT 聊天(Chat)
        • 聊天完成对象
        • 聊天完成块对象
        • 创建聊天补全 (流式)
        • 创建聊天补全 (非流)
        • 创建聊天识图 (流式)
        • 创建聊天识图 (流式) base64
        • 创建聊天识图 (非流)
        • 创建聊天创作图 (非流)
        • 官方 Function calling 调用
        • 官方 N 测试
        • 列出模型
        • 创建聊天函数调用(只能非流)
        • 创建结构化输出
        • 控制推理模型努力程度
        • 聊天接口 [chat兼容格式]
        • 创建聊天补全 Deepseek v3.1思考程度(流式)
      • ChatGPT Responses 格式
        • Responses API与Chat API对比
        • 创建模型响应
        • 创建函数调用
        • 创建模型响应(流式返回)
        • 创建模型响应(控制思考长度)
        • 创建深度搜索(巨贵请慎用)
        • 创建网络搜索
        • 创建模型响应 GPT-5 启用思考
      • ChatGPT 自动补全(Completions)
        • 完成对象
        • 创建完成
      • ChatGPT 嵌入(Embeddings)
        • 嵌入对象
        • 创建嵌入
      • Web 搜索
        • Web 搜索
    • Anthropic Claude 接口
      • 聊天完成对象
      • 聊天完成块对象
      • 创建聊天补全 (流式) [原生格式]
      • 创建函数调用 (流式) [原生格式]
      • 创建思考聊天 [原生格式]
      • 创建思考聊天
      • 创建聊天补全 (流式)
      • 创建聊天补全 (非流)
      • 创建聊天识图 (流式)
      • 创建聊天识图 (非流)
    • Gemini 接口
      • 原生格式
        • 文本生成
        • 文本生成-流
        • 文本生成+思考-流
        • 图片生成
        • 图片生成 Gemini-2.5-Flash-Image
        • 图片生成 Gemini-2.5-Flash-Image 控制宽高比
        • 图片生成 Gemini-3-Pro-Image-Preview 控制宽高比 +清晰度
        • 图片编辑
        • 图片理解
        • 格式化输出
        • 函数调用
        • 文档理解
        • URL Context [原生格式]
        • 代码执行
        • Google Search
        • 视频理解
        • URL Context
        • 视频理解 - URL [原生格式] 开发中
        • Imagen 4 开发中
        • 音频理解
        • Embeddings
        • 文本生成 Gemini-3-Pro-Image-Preview:GenerateContent
      • Chat 兼容格式
        • Gemini 图片创作接口 [chat兼容格式]
        • 聊天接口 [chat兼容格式]
        • 识图接口 [Chat 兼容格式]
        • 聊天 + 读取文件接口 [Chat 兼容格式]
  • 绘画模型
    • README
    • 图像对象
    • Midjourney
      • 上传图片
      • 提交Imagine任务
      • 根据任务ID 查询任务状态
      • 根据ID列表查询任务
      • 获取任务图片的seed
      • 执行Action动作
      • 提交Blend任务
      • 提交Describe任务
      • 提交Shorten任务
      • 提交Modal
      • 提交swap_face任务
    • Ideogram
      • Generate 3.0(文生图)Generate
      • Generate 3.0(图片编辑)Edit
      • Generate 3.0(图片重制)Remix
      • Generate 3.0(图片重构)Reframe
      • Generate 3.0(替换背景) Replace Background
      • Ideogram(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
    • GPT-Image-1
      • 创建 gpt-image-1
      • 编辑 gpt-image-1
      • 蒙版 gpt-image-1
    • DALL·E 3
      • 创建 DALL·E 3
    • FLUX 系列
      • GPT 兼容格式
        • Flux 创建(OpenAI DALL-E-3 格式)
        • Flux 编辑(OpenAI DALL-E-3 格式)
      • Replicate 官方格式
        • Flux 分辨率
        • 接入教程
        • 查询任务
        • 创建任务 black-forest-labs/flux-kontext-dev
    • Fal.ai 平台
      • 状态码
      • 获取请求结果
      • /fal-ai/nano-banana 文生图
      • /fal-ai/nano-banana/edit 图片编辑
    • 即梦绘画
      • 创建绘画
      • 编辑图片
    • 豆包系列
      • doubao-seedream-3-0-t2i-250415
      • doubao-seededit-3-0-i2i-250628
      • doubao-seedream-4-0-250828-文生图
      • doubao-seedream-4-0-250828-图生图
      • doubao-seedream-4-0-250828-多图生图
      • doubao-seedream-4-5-251128 文生图(纯文本输入单图输出)
      • doubao-seedream-4-5-251128 图文生图(单图输入单图输出)
      • doubao-seedream-4-5-251128 多图融合(多图输入单图输出)
      • doubao-seedream-4-5-251128 组图输出(多图输出)
      • doubao-seedream-4-5-251128 单张图生组图
      • doubao-seedream-4-5-251128 多参考图生组图
    • 千问 Qwen-Image 系列
      • qwen-image-edit-2509
    • Stable-Diffusion
  • 视频模型
    • veo 视频生成
      • 视频统一格式
        • 状态码
        • 创建视频
        • 创建视频,带图片
        • 查询任务
        • 创建视频(参考图)
      • OpenAI 视频格式
        • openai 创建视频,带图片
        • openai 查询任务
        • openai 下载视频
    • luma 视频生成
      • 官方API格式
        • 状态码
        • 提交生成视频任务
        • 扩展视频
      • 查询任务
        • 查询单个任务
        • 批量获取任务
    • Kling 快手可灵
      • Callback协议
      • 图像生成
      • 文生视频
      • 图生视频
      • 查询任务(免费)
      • 多图参考生视频
      • 虚拟试穿
      • 对口型
      • 视频延长
      • 视频特效
    • Runway 视频生成
      • 状态码
      • 提交视频生成任务
      • 查询视频任务(免费)
    • 即梦 视频生成
      • 状态码
      • 视频统一格式
        • 创建视频
        • 查询任务
      • 官方格式
        • 添加中
      • 提交视频生成任务
      • 查询视频任务(免费)
    • 海螺 视频生成
      • 状态码
      • 提交视频生成任务
      • 视频任务状态查询
      • 图生视频
      • 首尾帧视频
    • 豆包 视频生成
      • 文生视频示例
      • 图生视频-首帧
      • seedance-lite-首尾帧
      • 图生视频-base64编码
      • seedance-lite-参考图
      • 查询单个任务
      • 查询视频生成任务列表-默认
      • 查询视频生成任务列表-搜索多个任务 ID
    • sora 视频生成
      • 统一视频格式
        • 查询任务
        • 创建视频,带图片 sora-2
        • 创建视频 sora-2
        • 创建视频 sora-2-pro
        • 创建视频 (带 Character)
      • chat格式
        • 创建视频
        • 创建视频, 带图片
        • 连续修改生成视频
      • OpenAI官方视频格式
        • openai 查询任务
        • openai 下载视频
        • openai 创建视频,带图片
        • 使用故事板创建视频
        • openai 创建视频,带图片 私有模式
        • openai 创建视频(带Character)
        • openai 编辑视频
      • 创建角色
    • grok 视频生成
      • 视频统一格式
        • 创建视频
        • 查询任务
        • 创建视频
        • 查询任务
    • 通义万象 视频生成
      • 生成视频
      • 视频查询
  • GPTs 相关
    • GPT-4-All(分析图片)
    • GPT-4-All(生成图片)
    • GPTs 对话
  • 系统 API
    • 获取令牌列表
    • 新增令牌
    • 获取令牌支持模型
    • 获取账号信息
  • 文生音乐 Suno
    • 说明
    • 参数
    • 任务提交
      • 生成歌曲(灵感模式)
      • 生成歌曲(自定义模式)
      • 生成歌曲(续写模式)
      • 生成歌曲(歌手风格)
      • 生成歌曲(上传歌曲二次创作)
      • 生成歌曲(拼接歌曲)
      • 生成歌词
      • 歌曲拼接
    • 查询接口
      • 批量获取任务
      • 查询单个任务
      • 获取wav
  • Rerank 重排序模型
    • 重排序
  • Replicate 聚合平台
    • 接入教程
    • Flux 分辨率
    • 查询任务
    • 创建任务-通过模型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
    • 创建任务 black-forest-labs/flux-kontext-dev
    • 创建任务 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
  • Fal-ai 聚合平台
    • 接入教程
    • Falai-veo3 视频生成
      • /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
    • 获取请求结果
    • /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
  • PHP 配置方式
    • PHP 使用图片编辑 Demo
  • NodeJS 配置方式
    • NodeJS 基础对话
  • Python 配置方式
    • 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 识别图片
  • 各插件 / 软件使用教程
    • Gemini CLI 配置使用教程
    • CodeX CLI 配置使用教程
    • Claude Code 安装使用教程
    • Dify 添加模型
    • Cline 配置教程
    • Aider 配置教程
    • Cursor 配置教程
    • ChatBox(推荐使用)
    • 开源 GPT Academic 配置教程
    • NextChat 设置教程
    • Zotero GPT 配置方法
    • Claude Dev 配置教程
    • 沉浸式翻译 设置 GPT 翻译
    • ChatGPT Sidebar 插件
    • ChatGPT-on-WeChat 配置教程
    • LobeChat 配置教程
    • Cherry Studio 调用 Claude MCP
    • Coze 扣子工作流配置 API 教程
  • 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 也可以用吧?
      • 为什么 gpt-4 额度消耗这么快?
      • 为什么 GPT-4 不知道它自己是谁?
    • 隐私安全
      • 你们会保留对大模型的调用记录和调用内容吗?
      • 请问你们的 API,是真的在调用官方的模型输出,还是魔改的?就怕买的是 OpenAI 的接口,输出的是你们自己训练的开源模型结果。
    • 商务合作问题
      • 企业合作怎么开通,价格如何?
      • 企业合作的话是怎么签订合同?
      • 能开发票吗?开出来的票是什么类目?
      • 企业合作有没有更多折扣?
      • 为什么有的分组价格接近原价?
    • 其他
      • 密码忘记了怎么办?在哪里可以找回密码?
  • 大模型百科
    • 基础概念
      • 大语言模型(LLM)
      • Token 与分词
  • 帮助中心
    • AI 返回字段:思考相关
    • HTTP 状态码及其含义
  • 友情链接
    • 大模型API接口企业站
    • 大模型API接口国际站
  • 隐私及条款
    • 隐私政策
    • 用户协议
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
首页工作台模型价格联系我们常见问题官方文档官方博客大模型调试大模型百科大模型国际站
WeChat
QQ
Telegram
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
🇨🇳 Chinese
  • 🇨🇳 Chinese
  • 🇺🇸 English
  1. 各插件 / 软件使用教程

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
Python 使用 Claude 识别图片
Next
CodeX CLI 配置使用教程
Built with