Tokaify APITokaify API
API 参考
AI 模型接口图像imagen接口imagen 图像生成

imagen-4.0-ultra-generate-001 图像生成接口

Imagen 4 Ultra 图像生成接口

用于最高质量图像生成、品牌主视觉、精细产品图和对画面质量要求高的场景。

POST
/v1beta/models/{model}:predict

Authorization

BearerAuth

AuthorizationBearer <token>

模型 relay 接口鉴权。请求头：Authorization: Bearer 。

In: header

Path Parameters

model*string

Gemini 模型名。

Default"imagen-4.0-ultra-generate-001"

Request Body

application/json

[key: string]?any

Response Body

application/json

curl -X POST "https://api.tokaify.com/v1beta/models/imagen-4.0-ultra-generate-001:predict" \  -H "Content-Type: application/json" \  -d '{}'
{}

请求参数

字段类型必选默认值描述
instancesarray是无预测输入数组，Imagen 通常只需要一个实例。
instances[].promptstring是无英文提示词，官方建议最大 480 tokens。
parameters.sampleCountinteger否4生成图片数量，范围 1 到 4。
parameters.aspectRatiostring否1:1支持 1:1、3:4、4:3、9:16、16:9。
parameters.imageSizestring否1K输出尺寸档位，支持 1K、2K。
parameters.personGenerationstring否allow_adult人物生成策略，支持 dont_allow、allow_adult、allow_all；部分地区不允许 allow_all。

示例代码

curl "https://api.tokaify.com/v1beta/models/imagen-4.0-ultra-generate-001:predict" \
  -H "Authorization: Bearer $TOKAIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [{ "prompt": "A cinematic hero image for an enterprise AI gateway, premium lighting, realistic 3D glass interface" }],
    "parameters": {
      "sampleCount": 1,
      "aspectRatio": "16:9",
      "imageSize": "2K",
      "personGeneration": "dont_allow"
    }
  }'
import requests

response = requests.post(
    "https://api.tokaify.com/v1beta/models/imagen-4.0-ultra-generate-001:predict",
    headers={"Authorization": "Bearer YOUR_TOKAIFY_API_KEY"},
    json={
        "instances": [{"prompt": "A cinematic hero image for an enterprise AI gateway, premium lighting, realistic 3D glass interface"}],
        "parameters": {"sampleCount": 1, "aspectRatio": "16:9", "imageSize": "2K", "personGeneration": "dont_allow"},
    },
)
print(response.json())
const response = await fetch("https://api.tokaify.com/v1beta/models/imagen-4.0-ultra-generate-001:predict", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKAIFY_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    instances: [{ prompt: "A cinematic hero image for an enterprise AI gateway, premium lighting, realistic 3D glass interface" }],
    parameters: { sampleCount: 1, aspectRatio: "16:9", imageSize: "2K", personGeneration: "dont_allow" },
  }),
});
console.log(await response.json());

响应示例

{
  "predictions": [
    {
      "bytesBase64Encoded": "iVBORw0KGgoAAAANSUhEUg...",
      "mimeType": "image/png"
    }
  ]
}

业务提示

计费倍率按后台模型倍率与渠道倍率配置执行。Ultra 优先质量，通常成本和延迟高于 Fast/Standard；建议将 sampleCount 控制为 1 到 2。

这篇文档对您有帮助吗？

最后更新于

imagen-4.0-generate-001 图像生成接口 POST

Imagen 4 Standard 图像生成接口

生成图片 POST

下一页