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>"
}
}