跳到主要内容

Gemini 生图 API

鼎惠API 可聚合支持 Gemini 图像生成的模型。具体模型 ID、尺寸、价格和可用能力以 模型广场 为准。

使用场景​

  • 文生图
  • 图生图
  • 图片局部编辑
  • 多轮创意草稿
  • 电商、运营、文章配图生成

请求地址​

根据模型和协议能力不同，图片接口可能使用 OpenAI 兼容图片接口或 Gemini 原生接口。接入前请先确认目标模型的调用协议。

常见 OpenAI 兼容形式：

POST /v1/images/generations
Authorization: Bearer sk-your-dinghui-key
Content-Type: application/json

文生图示例​

curl https://www.tophdd.cn/v1/images/generations \
  -H "Authorization: Bearer sk-your-dinghui-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-gemini-image-model",
    "prompt": "一张干净的企业级 AI API 控制台宣传图，蓝绿色科技风",
    "size": "1024x1024",
    "n": 1
  }'

参数说明​

参数说明
model图像模型 ID
prompt图片描述，建议写清主体、风格、构图、色彩和用途
size图片尺寸，具体支持范围以模型为准
n生成数量，批量生成建议使用异步批量接口
response_format返回 URL 或 Base64，取决于模型和接口支持

Prompt 建议​

图像 Prompt 建议包含：

  • 主体：画面中最重要的对象。
  • 场景：室内、户外、控制台、产品海报等。
  • 风格：真实摄影、插画、扁平图、科技风等。
  • 色彩：主色、辅助色、明暗关系。
  • 构图：居中、俯视、留白、宽屏等。
  • 禁止项：不需要出现的文字、水印、Logo 等。

常见问题​

生成结果不符合预期​

先明确主体和构图，再补充风格。不要一次堆太多互相冲突的要求。

图片返回很慢​

图像生成比文本生成耗时更长。生产业务建议异步处理，并给用户显示任务状态。

返回 Base64 太大​

如果接口支持 URL 返回，优先使用 URL；如果只能使用 Base64，后端应及时保存到对象存储，不要长期保存在日志里。