/v1beta/models/{model_name}:{action}
示例:
/v1beta/models/gemini-2.5-pro:generateContent/v1beta/models/gemini-2.5-pro:streamGenerateContent?alt=sse
接口信息
POSThttps://ominiapi.com/v1beta/models/{model}:generateContent
认证方式
使用 Bearer Token 进行认证。| 参数 | 说明 |
|---|---|
| 格式 | Authorization: Bearer sk-xxxxxx |
| 位置 | Header |
路径参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称 |
请求体 (Request Body)
Content-Type:application/json
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| contents | array<object> | 否 | 对话内容列表 |
| generationConfig | object | 否 | 生成配置参数 |
| safetySettings | array<object> | 否 | 安全设置 |
| tools | array<object> | 否 | 工具配置 |
| systemInstruction | object | 否 | 系统指令 |
响应体 (Response Body)
状态码:200 (成功)
Content-Type: application/json
响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| candidates | array<object> | 候选结果列表 |
| usageMetadata | object | 使用量统计信息 |
candidates 对象结构
| 字段名 | 类型 | 说明 |
|---|---|---|
| content | object | 生成的内容(包含 role 和 parts) |
| finishReason | string | 结束原因 |
| safetyRatings | array<object> | 安全评分 |
usageMetadata 对象结构
| 字段名 | 类型 | 说明 |
|---|---|---|
| promptTokenCount | integer | 提示词 token 数量 |
| candidatesTokenCount | integer | 候选结果 token 数量 |
| totalTokenCount | integer | 总 token 数量 |