Gemini 流式对话 - AiToEarn Open Platform

curl --request POST \ --url https://aitoearn.cn/api/ai/v1beta/models/{model}:streamGenerateContent \ --header 'Content-Type: application/json' \ --header 'x-goog-api-key: <api-key>' \ --data ' { "model": "<string>", "contents": [ { "parts": [ { "text": "<string>" } ] } ] } '

授权

x-goog-api-key

string

header

必填

Gemini SDK 兼容接口使用的 API Key header。

路径参数

model

string

必填

模型 ID。先调用「对话模型列表」接口（GET /api/ai/models/chat），传入其返回的 data[n].name。

请求体

application/json

model

string

必填

模型 ID，与路径参数 model 一致。取值来自「对话模型列表」接口返回的 data[n].name。

contents

object[]

必填

内容列表

Hide child attributes

contents.parts

object[]

必填

单条消息中的有序内容片段列表

Option 1
Option 2
Option 3

Hide child attributes

contents.parts.text

string

必填

文本片段

contents.role

enum<string>

消息角色，用于区分不同消息来源

可用选项:

user,

model

config

object

生成配置

Hide child attributes

config.temperature

number

控制输出随机性，值越高越发散，值越低越稳定

config.topP

number

核采样参数，限制抽样时考虑的 token 最大累积概率。

config.topK

number

Top-K 采样参数，限制抽样时考虑的最高概率 token 数量

config.candidateCount

number

需要返回的候选回答数量

config.maxOutputTokens

number

候选回答的最大输出 token 数

config.responseLogprobs

boolean

是否返回 token 对数概率信息

config.logprobs

number

每个解码步骤返回的高概率候选 token 数，仅在 responseLogprobs=true 时生效

config.presencePenalty

number

存在惩罚，用于降低或提高已出现 token 的再次出现倾向

config.frequencyPenalty

number

频次惩罚，根据 token 已出现次数抑制或鼓励重复

config.seed

number

解码随机种子，用于提高输出可复现性

config.responseMimeType

string

期望的响应类型

config.responseJsonSchema

any

JSON 输出结构约束，通常配合 responseMimeType=application/json 使用

响应

第三方协议原生响应或 SSE 数据。不使用 AiToEarn 通用响应包裹。

第三方协议原生响应，不使用 AiToEarn 通用响应包裹。