Google Gemini API 开发教程

自从 Deepseek 发布以来,网上都在疯传其与 ChatGPT-o1 和 Claude 3.5 的对比,而以前热火朝天的 Google Gemini 却彻底淡出了人们的视线,不论国内国外。


关于 Deepseek 为什么如此轰动,可以查看这篇文章:为什么说 Deepseek 的实际意义远大于它的技术意义?


但既然如此,为什么还有讲 Gemini API 的开发能?原因如下:

  • 完全免费!成本只是服务器和开发费用。*
  • Google 毕竟是所有 AI 公司中最庞大的综合公司,可以保底。
  • Gemini 1.5 及2.0 模型在处理超长文本和音视频的能力依然世界第一。

成品演示:【Google Gemini 中国版
使用 Gemini API 搭建的国内镜像网站,免费


以下正式进入开发教程,以 Curl 为例(配置最简单)

Gemini API 开发教程

2. 准备工作

2.1 获取 API 密钥

在开始使用 Gemini API 之前,您需要:

  1. 访问 Google AI Studio 创建 API 密钥
  2. 将密钥保存在环境变量中:
export GOOGLE_API_KEY="Your_API_Key"

当然,在实际开发中方式有很多:Cloudflare 提供环境变量配置;服务器开发可以使用 config.php,再用 Nginx 或 Apache 设置为之内本地访问...

3. 基础功能

3.1 纯文本生成

使用 generateContent 方法可以让模型根据输入文本生成内容:

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=$GOOGLE_API_KEY \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{
          "text": "提示词"}]}]}'

3.2 多模态输入(文本 + 图片)

Gemini 1.5 以上就支持同时处理文本和图片输入:

curl -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent" \
  -H "Content-Type: application/json" \
  -d '{
    "contents":[{
      "parts":[
        {"text": "提示词"},
        {
          "inline_data": {
            "mime_type":"image/jpeg",
            "data": "BASE64_ENCODED_IMAGE"
          }
        }
      ]
    }]
  }'

3.3 多轮对话

支持构建多轮对话,保持上下文连贯:
(这是很多 AI 镜像都不具有的!包括 Gemini、ChatGPT)

curl -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role":"user", "parts":[{"text": "提示词1"}]},
      {"role":"model", "parts":[{"text": "回答1"}]},
      {"role":"user", "parts":[{"text": "提示词2"}]}
    ]
  }'

4. 高级功能

4.1 流式输出

使用 streamGenerateContent 实现实时输出:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:streamGenerateContent?alt=sse" \
    -H 'Content-Type: application/json' \
    --no-buffer \
    -d '{
      "contents":[{
        "parts":[{
          "text": "提示词"
        }]
      }]
    }'

这个其实不是特别建议用,除非你的前端水平很高,不然很容易 API 把内容返回来了,前端渲染不了。

4.2 配置生成参数

可以通过配置参数控制输出:

curl -X POST \
  -d '{
    "contents": [...],
    "safetySettings": [{
      "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
      "threshold": "BLOCK_ONLY_HIGH"
    }],
    "generationConfig": {
      "temperature": 1.0,
      "maxOutputTokens": 800,
      "topP": 0.8,
      "topK": 10
    }
  }'

4.3 嵌入功能

使用 embedContent 获取文本的向量表示:

curl -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/embedding-001:embedContent" \
  -d '{
    "model": "models/embedding-001",
    "content": {
      "parts":[{
        "text": "your text"
      }]
    }
  }'

5. 模型信息

5.1 查询单个模型信息

curl https://generativelanguage.googleapis.com/v1beta/models/gemini-pro?key=$GOOGLE_API_KEY

5.2 获取所有可用模型

curl https://generativelanguage.googleapis.com/v1beta/models?key=$GOOGLE_API_KEY
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,657评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,889评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,057评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,509评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,562评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,443评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,251评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,129评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,561评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,779评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,902评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,621评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,220评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,838评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,971评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,025评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,843评论 2 354

推荐阅读更多精彩内容