Skip to Content
接口调用Google AI Studio API

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 请求参数

参数类型必填说明
contentsarray是对话输入内容数组。
contents[].rolestring否角色,例如 user 或 model。
contents[].partsarray是具体内容块,可包含文本、内联图片、文件、音频等。
systemInstructionobject否系统提示。
toolsarray否工具定义。
toolConfigobject否工具调用配置。
safetySettingsarray否安全过滤设置。
generationConfigobject否生成参数,如 temperature、topP、topK、maxOutputTokens、responseMimeType。
cachedContentstring否缓存上下文引用。

请求示例

Gemini 原生 API

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 返回结果

参数类型说明
candidatesarray候选生成结果数组。
candidates[].contentobject生成内容。
candidates[].content.partsarray输出内容块。
candidates[].finishReasonstring候选停止原因。
candidates[].safetyRatingsarray安全评级。
promptFeedbackobjectPrompt 层级反馈。
usageMetadataobjecttoken 用量。
modelVersionstring实际模型版本。

请求返回示例

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 文档为准。