Gemini API接口调用配置指南 | Google Gemini Pro/Ultra API中转

作者：简易API - 免费试用 Gemini&OpenAI API

注：详解如何通过简易API平台以OpenAI兼容模式调用Gemini模型，简化API调用流程，无需适配原生格式，提升开发效率。

当你准备在项目中集成Gemini这样的大模型时，面临的首要挑战往往不是技术能力，而是API调用的复杂性和兼容性问题。特别是当项目已经在使用OpenAI的接口，想要无缝切换到Gemini时，重新适配API格式会带来不小的开发成本。本文将详细解析简易API平台如何通过OpenAI兼容模式让你用统一的方式调用Gemini模型，大幅简化开发流程。

简易API中转站功能支持对比表

在深入了解简易API的Gemini接入方案前，先来看一下简易API中转站与Gemini官方API的功能支持对比：

功能/特性	简易API中转站	Gemini官方API	说明
核心功能
聊天生成 API	✅ 支持	✅ 支持	简易API使用OpenAI兼容格式v1/chat/completions
嵌入生成	✅ 支持	✅ 支持	简易API使用OpenAI兼容格式v1/embeddings
图像理解	✅ 支持	✅ 支持	简易API通过多模态消息格式支持
流式响应	✅ 支持	✅ 支持	简易API通过stream=true参数支持
原生高级功能
generativeModel API	❌ 不支持	✅ 支持	Gemini官方的generativeModel端点
系统指令	✅ 支持	✅ 支持	通过system参数设置系统指令
Tuning API	❌ 不支持	✅ 支持	Gemini官方的tuning端点
函数调用	✅ 支持	✅ 支持	通过function_call参数支持
使用便利性
OpenAI兼容格式	✅ 支持	❌ 不支持	简易API让你用OpenAI格式调用Gemini
多模型统一接口	✅ 支持	❌ 不支持	一个接口调用多家厂商模型
国内支付方式	✅ 支持	❌ 不支持	支持支付宝、微信等
网络访问稳定性	✅ 优化	❓ 一般	简易API针对国内网络环境优化
价格优势	✅ 有优势	❓ 一般	简易API提供更经济的套餐和免费额度

简易API中转站总结

主要优势：使用统一的OpenAI格式调用多家大模型，支持国内支付方式，网络稳定，价格更具竞争力
主要局限：不支持Gemini的一些高级原生功能，如Tuning API等
适用场景：适合需要灵活切换不同模型，或已有OpenAI接口代码想无缝迁移到Gemini的场景
不适用场景：需要使用Gemini高级功能如模型微调等专属功能的场景

欢迎免费试用简易API，3 分钟跑通 API 调用 www.jeniya.top
支持Gemini Pro/Ultra全系列模型，使用统一OpenAI格式即可轻松调用

注册可送 1.1 美金额度起，约 300万 Tokens 额度体验。立即免费注册

Gemini API调用的困扰与解决方案

为什么Gemini官方API与OpenAI不同

如果你直接查看Gemini的官方开发文档，你会发现它的API调用方式与OpenAI有明显不同。以基本的对话生成为例，两者的差异如下：

Gemini官方API调用示例：

from google.generativeai import GenerativeModel

# 初始化模型
model = GenerativeModel('gemini-pro')

# 发送请求
response = model.generate_content('Hello, Gemini!')

# 获取回复
print(response.text)

OpenAI API调用示例：

from openai import OpenAI

# 初始化客户端
client = OpenAI(api_key="your_api_key")

# 发送请求
response = client.chat.completions.create(
    model="gpt-3.5-turbo",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

# 获取回复
print(response.choices[0].message.content)

这两种API格式的差异，意味着如果你想同时使用或切换这两种模型，需要在代码中维护两套不同的调用逻辑，增加了开发和维护成本。

简易API的解决方案：OpenAI兼容模式

简易API平台提供的Gemini API访问服务采用了OpenAI兼容模式，允许开发者使用统一的OpenAI格式来调用Gemini模型。这意味着：

无需学习新的API格式

如果你已经熟悉OpenAI的API，可以直接用同样的格式调用Gemini

代码无需大幅修改

只需更改模型名称，其他代码逻辑保持不变

轻松切换模型

在同一项目中可以灵活切换使用OpenAI、Gemini或其他支持的模型

简化多模型测试

方便对比不同模型在相同提示下的表现差异

Gemini API通过简易API平台调用的详细步骤

下面我们将详细介绍如何通过简易API平台使用OpenAI兼容格式调用Gemini模型：

获取简易API平台的访问凭证

首先，你需要在简易API平台注册账号并获取API密钥：

访问简易API注册页面创建账号
登录后，进入控制台，在"API密钥"部分创建并复制API密钥
保存API密钥以备后续使用（切勿泄露给他人）

使用Python调用Gemini模型

以下是使用Python通过简易API平台调用Gemini模型的完整示例：

import requests
import json

# 简易API平台接口地址与密钥
api_url = "https://jeniya.top/v1/chat/completions"
api_key = "你的简易API密钥"  # 替换为你的实际API密钥

# 请求头
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}

# 请求体 - 注意这里使用的是OpenAI格式，但模型名称为Gemini
data = {
    "model": "gemini-pro",  # Gemini模型名称
    "messages": [
        {"role": "system", "content": "你是一个专业的AI助手，善于解答各类问题。"},
        {"role": "user", "content": "请简要介绍人工智能的发展历史。"}
    ],
    "temperature": 0.7,
    "max_tokens": 1000
}

# 发送请求
response = requests.post(api_url, headers=headers, data=json.dumps(data))

# 解析并打印结果
if response.status_code == 200:
    result = response.json()
    print(result["choices"][0]["message"]["content"])
else:
    print(f"请求失败: {response.status_code}")
    print(response.text)

其他编程语言的调用示例

JavaScript/Node.js

const axios = require('axios');

async function callGemini() {
  const url = 'https://jeniya.top/v1/chat/completions';
  const headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer 你的简易API密钥'
  };

  const data = {
    model: 'gemini-pro',
    messages: [
      {role: 'system', content: '你是一个专业的AI助手，善于解答各类问题。'},
      {role: 'user', content: '请简要介绍人工智能的发展历史。'}
    ],
    temperature: 0.7,
    max_tokens: 1000
  };

  try {
    const response = await axios.post(url, data, {headers});
    console.log(response.data.choices[0].message.content);
  } catch (error) {
    console.error('请求失败:', error.response?.data || error.message);
  }
}

callGemini();

PHP

<?php
$url = 'https://jeniya.top/v1/chat/completions';
$apiKey = '你的简易API密钥';

$data = [
    'model' => 'gemini-pro',
    'messages' => [
        ['role' => 'system', 'content' => '你是一个专业的AI助手，善于解答各类问题。'],
        ['role' => 'user', 'content' => '请简要介绍人工智能的发展历史。']
    ],
    'temperature' => 0.7,
    'max_tokens' => 1000
];

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode == 200) {
    $result = json_decode($response, true);
    echo $result['choices'][0]['message']['content'];
} else {
    echo "请求失败: " . $httpCode . "\n";
    echo $response;
}
?>

简易API支持的Gemini API功能

使用简易API平台调用Gemini模型时，你可以使用以下功能和端点：

支持的API端点和功能

功能	端点	说明
聊天生成	v1/chat/completions	核心功能，用于生成对话回复
嵌入生成	v1/embeddings	使用Gemini嵌入模型生成向量表示
实时对话	流式API	支持通过stream=true实现打字机效果
语音生成	TTS接口	支持文本转语音功能
文本翻译	翻译接口	支持多语言翻译
图像处理	多模态接口	支持Gemini Vision功能，处理图像输入

不支持的API端点

以下Gemini原生API功能在简易API平台上尚未支持：

GenerativeModel API：Gemini官方的generativeModel端点
Tuning API：官方的模型微调功能
Safety Settings API：特定安全设置相关功能

这意味着一些Gemini的高级功能，如模型微调等，目前需要通过Gemini官方API直接访问。但对于大多数应用场景，简易API平台已经提供了足够的功能支持。

Gemini模型在简易API平台的可用版本

当前简易API平台支持多个Gemini模型版本，你可以根据需求选择适合的模型：

模型名称	特点	推荐使用场景
gemini-pro	强大通用模型，性能优秀，成本合理	通用对话、内容创作、代码生成
gemini-ultra	最高性能模型，推理能力强	复杂推理、专业领域问答、高质量内容生成
gemini-pro-vision	支持图像处理的模型	多模态应用、图像理解与分析
gemini-flash	轻量级高速模型	高并发场景、需要快速响应的应用

注意：模型可用性和版本可能会随时更新，请参考简易API平台的最新文档获取当前支持的模型列表。

总结

通过简易API平台以OpenAI兼容格式调用Gemini API，你可以大幅简化开发流程，避免为不同模型维护多套API调用逻辑。这种统一的接口方式不仅降低了学习和开发成本，还提供了更大的灵活性，让你能够轻松在不同模型间切换，以找到最适合你应用的AI解决方案。

虽然简易API平台目前不支持Gemini的一些高级功能如Tuning API，但对于大多数应用场景，已提供的核心功能已经足够满足需求。如果你的项目有特殊需求，可以考虑针对那些功能单独使用Gemini官方API。

马上注册简易API平台，体验一站式AI API服务的便捷与高效，让你的开发之路更加顺畅！