跳转到主要内容

​
接口信息

POST https://ominiapi.com/v1beta/models/{model}:generateContent/

​
认证方式

使用 Bearer Token 进行认证。
参数说明
格式Authorization: Bearer sk-xxxxxx
位置Header

​
路径参数

参数名类型必填说明
modelstring是模型名称

​
请求体 (Request Body)

Content-Type: application/json
参数名类型必填说明
contentsarray<object>是对话内容列表
generationConfigobject是生成配置参数

​
generationConfig 参数详情

参数名类型说明
responseModalitiesarray<string>响应模态，指定生成内容的类型
imageConfigobject图片生成配置

​
imageConfig 对象结构

参数名类型说明
aspectRatiostring图片宽高比（如 “1:1”, “16:9”, “9:16”）
imageSizestring图片尺寸规格

​
响应体 (Response Body)

状态码: 200 (成功) Content-Type: application/json

​
响应字段说明

字段名类型说明
candidatesarray<object>候选结果列表
usageMetadataobject使用量统计信息

​
candidates 对象结构

字段名类型说明
contentobject生成的内容（包含 role 和 parts）
finishReasonstring结束原因
safetyRatingsarray<object>安全评分

​
usageMetadata 对象结构

字段名类型说明
promptTokenCountinteger提示词 token 数量
candidatesTokenCountinteger候选结果 token 数量
totalTokenCountinteger总 token 数量

​
请求示例

​
cURL

import requests
url = "https://docs.newapi.pro/v1beta/models/string:generateContent/"
body = """{
  "contents": [
    {}
  ],
  "generationConfig": {
    "responseModalities": [
      "string"
    ],
    "imageConfig": {
      "aspectRatio": "string",
      "imageSize": "string"
    }
  }
}"""
response = requests.request("POST", url, data = body, headers = {
  "Content-Type": "application/json", 
  "Authorization": "Bearer "
})
print(response.text)

​
200

{
  "candidates": [
    {
      "content": {
        "role": "string",
        "parts": [
          {}
        ]
      },
      "finishReason": "string",
      "safetyRatings": [
        {}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}