Google AI Studio API
本文按 Google 官方 Gemini API 文档整理,完整展示 Google AI Studio 下 Gemini 原生 API 的请求地址、请求参数、请求示例、请求返回结果、请求返回示例。
鉴权方式
- Header:
x-goog-api-key: $GEMINI_API_KEY
请求地址
Gemini 原生 API
- 方法:
POST - 地址:
https://api.ggpu.ai/v1beta/models/{model}:generateContent - 流式地址:
https://api.ggpu.ai/v1beta/models/{model}:streamGenerateContent
请求参数
Gemini 原生 API 请求参数
请求示例
Gemini 原生 API
curl
curl "https://api.ggpu.ai/v1beta/models/gemini-2.5-flash:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain what GGPU Platform does in one paragraph."
}
]
}
],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 256
}
}'Omni HOT
Omni 视频生成使用平台创建的访问令牌。以下示例将令牌放在 GGPU_API_KEY 环境变量中:
Gemini 视频生成(Interactions)
异步生成
设置 "background": true 后,接口会立即创建后台任务并返回平台任务信息。请保存返回的 id,再使用统一任务接口获取状态和结果。
curl --location --request POST "https://api.ggpu.ai/v1beta/interactions" \
--header "x-goog-api-key: $GGPU_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"model": "gemini-omni-1.1-flash",
"input": "小狗跳舞",
"response_format": {
"type": "video",
"aspect_ratio": "16:9"
},
"generation_config": {
"video_config": {
"task": "text_to_video"
}
},
"background": true,
"store": true
}'使用返回的任务 ID 查询异步任务状态:
curl --location --request GET "https://api.ggpu.ai/v1/tasks/<task_id>" \
--header "Authorization: Bearer $GGPU_API_KEY"同步生成
省略 background(或显式设置为 false)时,接口按同步 interaction 处理,请求会等待生成结果返回。
curl --location --request POST "https://api.ggpu.ai/v1beta/interactions" \
--header "x-goog-api-key: $GGPU_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"model": "gemini-omni-1.1-flash",
"input": "小狗跳舞",
"response_format": {
"type": "video",
"aspect_ratio": "16:9"
},
"generation_config": {
"video_config": {
"task": "text_to_video"
}
},
"store": true
}'Vertex AI 版本的 Interactions 视频生成示例(包括同步、异步和任务轮询)请参阅 Google Vertex AI API。
请求返回结果
Gemini 原生 API 返回结果
请求返回示例
Gemini 原生 API 返回示例
{
"candidates": [
{
"content": {
"parts": [
{
"text": "GGPU Platform helps teams design, run, and scale AI workflows through a unified orchestration layer."
}
],
"role": "model"
},
"finishReason": "STOP",
"avgLogprobs": -0.12
}
],
"usageMetadata": {
"promptTokenCount": 12,
"candidatesTokenCount": 20,
"totalTokenCount": 32
},
"modelVersion": "gemini-2.5-flash"
}说明
- Omni 视频生成使用
/v1beta/interactions;response_format.type为video时配合generation_config.video_config.task指定视频任务。 background: true表示异步任务,创建后使用/v1/tasks/<task_id>轮询;省略或设为false时按同步 interaction 处理。- 如需更完整的多模态 part 类型、工具调用结构、流式事件结构,请以官方 Gemini API 文档为准。