curl --request POST \
  --url https://kaienapi.com/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "parts": [
        {
          "text": "介绍这个接口"
        }
      ]
    }
  ]
}
'

{}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Gemini generateContent 基础接口

Gemini 原生 generateContent 入口。文本、多模态、图片生成、结构化输出、工具、搜索、URL Context、Code Execution，以及 PDF、音频、视频理解，都按 Gemini 的 payload 提交。

请求格式

模型名放在路径 {model} 中。请求体使用 Gemini 原生结构，核心字段是 contents，每条内容由 parts 组成。

适用位置

从 Gemini 原生 SDK 或 AI Studio 迁移。
保留 Gemini 原生请求结构。
使用贴近 Gemini 语义的多模态和工具字段。

验证顺序

用基础文本请求确认模型和鉴权。
加入 generationConfig、tools、responseSchema、搜索或媒体 parts。
图片、音频、视频理解仍走这条，只是 payload 不同。

读取结果

响应通常包含 candidates。文本在 candidates 的 content parts 中；图片结果可能在 inlineData 或文件引用中，接入时按返回结构解析。

POST

v1beta

models

{model}

:generateContent

curl --request POST \
  --url https://kaienapi.com/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "parts": [
        {
          "text": "介绍这个接口"
        }
      ]
    }
  ]
}
'

{}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

在请求头中传入：Authorization: Bearer sk-...

Path Parameters

model

string

required

Body

application/json

contents

object[]

generationConfig

object

tools

object[]

systemInstruction

object

Response

Gemini 响应

The response is of type object.

Claude Messages 基础接口 Gemini streamGenerateContent 基础接口

开始使用

图片和视频

AI 工具接入

API Reference