如何通过API调用Gemini模型？

发布时间：2025-05-02 15:27:02 | 责任编辑：吴卓 | 浏览量：36 次

以下是通过API调用Gemini模型的详细步骤：

1. 申请API密钥

• 获取API Key：访问https://aistudio.google.com/app/apikey?hl=zh-cn，登录后点击“Create API Key”按钮生成新的API Key，并复制保存。

• 安全保存：建议将API Key存储在环境变量中，避免直接写入代码。例如，在Python中可以使用os.environ['GEMINI_API_KEY']="Your_API_Key"。

2. 配置API Key

• 在工具中配置：

  • 使用Apifox等API测试工具时，进入项目设置的“环境变量”，添加变量（如GEMINI_API_KEY），并将其值设置为你的API Key。在请求头中引用该变量，例如Authorization: Bearer {{GEMINI_API_KEY}}。

  • 如果使用Postman，配置方法类似。

• 在代码中配置：

  • 以Python为例，从环境变量加载API Key：

    Python

     
     import os
     api_key = os.getenv(
     "GEMINI_API_KEY"
     )
     
     

  • 根据需求选择其他编程语言，如JavaScript、Java等。

3. 调试API

• 使用Apifox调试：在Apifox中配置好API Key后，选择任一Gemini API接口，进入“运行”页面，点击“发送”，查看返回结果。

• 通过代码调试：

  • 使用Python代码调用API：

    Python

     
     import requests
     api_url = "https://api.google.com/gemini/v2.0/generate"
     access_token = "YOUR_GEMINI_2_ACCESS_TOKEN"
     headers = {
     "Authorization"
     : 
     f"Bearer 
     
     {access_token}
     
     "
     
     ,
     "Content-Type"
     : "application/json"
     }
     payload = {
     "prompt"
     : "请生成一段关于人工智能未来发展的描述。"
     ,
     "max_tokens"
     : 200
     ,
     "temperature"
     : 0.7
     }
     response = requests.post(api_url, headers=headers, json=payload)
     if response.status_code == 200
     :
     result = response.json(
     )
     print
     (
     "Gemini 2.0 返回结果："
     , result)
     else
     :
     print
     (
     "请求失败，状态码："
     , response.status_code)
     print
     (
     "错误信息："
     , response.text)
     
     

  • 根据需求选择其他编程语言。

4. 使用特定功能

• 文本生成：

  • 使用curl命令生成文本：

    bash

     
     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":"Write a story about a magic backpack."}]}]}'
     
     

  • 示例输出：

    JSON

     
     {
     "candidates"
     : [
     {
     "content"
     : {
     "parts"
     : [
     {
     "text"
     : "In a small town nestled in the hills, a boy named Ethan discovered a magical backpack..."
     }
     ]
     }
     }
     ]
     }
     
     

• 多模态输入（文字+图片）：

  • 下载图片并构建请求JSON文件：

    bash

     
     curl -o image.jpg https://storage.googleapis.com/generativeai-downloads/images/scones.jpg
     echo '{"contents":[
     {"parts":[
     {"text":"What is this picture?"},
     {"inline_data": {"mime_type":"image/jpeg","data":"'
     
     $(base64 -w0 image.jpg)
     
     '"}
     }]}]}' > request.json
     

  • 调用API：

    bash

     
     curl https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=
     $GOOGLE_API_KEY \
     -H 'Content-Type: application/json' \
     -d @request.json
     

  • 示例输出：

    JSON

     
     {
     "text"
     : "The picture shows a table with coffee, scones, and flowers."
     }
     
     

注意事项

• API Key安全：不要将API Key上传到公共代码库（如GitHub），若API Key泄露，请立即在账户设置中撤销并重新生成。

• 接口地址：根据使用的具体模型版本，API接口地址可能有所不同，需根据官方文档或中转服务说明进行调整。