---
title: "Gemini 流式对话"
method: POST
path: "/api/ai/v1beta/models/{model}:streamGenerateContent"
tags: ["AI 服务/大语言模型"]
---

# Gemini 流式对话

`POST /api/ai/v1beta/models/{model}:streamGenerateContent`

接口说明：Gemini `:streamGenerateContent` API 的兼容端点（流式输出，SSE）。请求与响应格式遵循 Gemini 规范；鉴权使用 `x-goog-api-key` 头（Gemini SDK 默认携带），已有 Gemini SDK 只需替换 baseURL 与 API Key 即可接入，按 AiToEarn 积分计费。

调用本接口前，请先请求[「对话模型列表」](/api-reference/get-api-ai-models-chat)接口（`GET /api/ai/models/chat`），获取当前可用的模型列表。

## Path parameters

- `model` string, required

## Request body

- object
  - `model` string, required — 模型 ID，与路径参数 `model` 一致。取值来自[「对话模型列表」](/api-reference/get-api-ai-models-chat)接口返回的 `data[n].name`。
  - `contents` object[], required — 内容列表
    - `role` 'user' | 'model' — 消息角色，用于区分不同消息来源
    - `parts` union[], required — 单条消息中的有序内容片段列表
      - union
        - object
          - `text` string, required — 文本片段
        - object
          - `inlineData` object, required — 随请求直接传入的内嵌媒体字节数据
            - `mimeType` string, required — 内嵌媒体类型
            - `data` string, required — 媒体原始数据
        - object
          - `fileData` object, required — 通过 URI 引用的文件媒体数据
            - `mimeType` string — 文件来源数据的媒体类型
            - `fileUri` string, required — 文件或媒体资源 URI
  - `config` object — 生成配置
    - `temperature` number — 控制输出随机性，值越高越发散，值越低越稳定
    - `topP` number — 核采样参数，限制抽样时考虑的 token 最大累积概率。
    - `topK` number — Top-K 采样参数，限制抽样时考虑的最高概率 token 数量
    - `candidateCount` number — 需要返回的候选回答数量
    - `maxOutputTokens` number — 候选回答的最大输出 token 数
    - `responseLogprobs` boolean — 是否返回 token 对数概率信息
    - `logprobs` number — 每个解码步骤返回的高概率候选 token 数，仅在 `responseLogprobs=true` 时生效
    - `presencePenalty` number — 存在惩罚，用于降低或提高已出现 token 的再次出现倾向
    - `frequencyPenalty` number — 频次惩罚，根据 token 已出现次数抑制或鼓励重复
    - `seed` number — 解码随机种子，用于提高输出可复现性
    - `responseMimeType` string — 期望的响应类型
    - `responseJsonSchema` unknown

## Response `200`

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

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

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)