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

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

Imagen 4 Fast 图像生成接口

用于快速生成高质量英文提示词图像,适合低延迟草图、概念验证和批量创意。

POST
/v1beta/models/{model}:predict

Authorization

BearerAuth

AuthorizationBearer <token>

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

In: header

Path Parameters

model*string

Gemini 模型名。

Default"imagen-4.0-fast-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-fast-generate-001:predict" \  -H "Content-Type: application/json" \  -d '{}'
{}

请求参数

字段类型必选默认值描述
instancesarray预测输入数组,Imagen 通常只需要一个实例。
instances[].promptstring英文提示词,官方建议最大 480 tokens。
parameters.sampleCountinteger4生成图片数量,范围 14
parameters.aspectRatiostring1:1支持 1:13:44:39:1616:9
parameters.imageSizestring1K输出尺寸档位。Fast 版本可用性以渠道为准。
parameters.personGenerationstringallow_adult人物生成策略,支持 dont_allowallow_adultallow_all;部分地区不允许 allow_all

示例代码

curl "https://api.tokaify.com/v1beta/models/imagen-4.0-fast-generate-001:predict" \
  -H "Authorization: Bearer $TOKAIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instances": [{ "prompt": "设计一幅16:9比例的抽象数字艺术作品,展现宇宙景观。画面中有旋转的星系、粉色和紫色的炫彩星云。前景中,一位孤独的身影站在外星悬崖上,俯瞰这片壮丽的宇宙空间,背景是辉煌而超现实的天空。" }],
    "parameters": {
      "sampleCount": 2,
      "aspectRatio": "16:9",
      "personGeneration": "dont_allow"
    }
  }'
import requests

response = requests.post(
    "https://api.tokaify.com/v1beta/models/imagen-4.0-fast-generate-001:predict",
    headers={"Authorization": "Bearer YOUR_TOKAIFY_API_KEY"},
    json={
        "instances": [{"prompt": "设计一幅16:9比例的抽象数字艺术作品,展现宇宙景观。画面中有旋转的星系、粉色和紫色的炫彩星云。前景中,一位孤独的身影站在外星悬崖上,俯瞰这片壮丽的宇宙空间,背景是辉煌而超现实的天空。"}],
        "parameters": {"sampleCount": 2, "aspectRatio": "16:9", "personGeneration": "dont_allow"},
    },
)
print(response.json())
const response = await fetch("https://api.tokaify.com/v1beta/models/imagen-4.0-fast-generate-001:predict", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TOKAIFY_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    instances: [{ prompt: "设计一幅16:9比例的抽象数字艺术作品,展现宇宙景观。画面中有旋转的星系、粉色和紫色的炫彩星云。前景中,一位孤独的身影站在外星悬崖上,俯瞰这片壮丽的宇宙空间,背景是辉煌而超现实的天空。" }],
    parameters: { sampleCount: 2, aspectRatio: "16:9", personGeneration: "dont_allow" },
  }),
});
console.log(await response.json());

响应示例

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

业务提示

计费倍率按后台模型倍率与渠道倍率配置执行。Fast 版本优先速度,复杂文字和高保真海报建议使用 Standard 或 Ultra。

这篇文档对您有帮助吗?

最后更新于