生成第一张图片 - YingTu API Docs

下面使用 gemini-3.1-flash-image 生成 1K 图片。它适合第一次接入：请求结构稳定，后续如需 2K 或 4K，不必更换模型。先在 YingTu 控制台创建开发密钥，并阅读密钥安全说明。代码应运行在本地开发环境或服务端，不要把生产密钥写进网页或移动端安装包。

发送一条完整请求

cURL

curl --request POST \
  --url 'https://api.yingtu.ai/v1beta/models/gemini-3.1-flash-image:generateContent' \
  --header 'Authorization: Bearer YOUR_YINGTU_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "适合城市公共阅读空间的清晰导览插画"}]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "4:3", "imageSize": "1K"},
      "candidateCount": 1
    }
  }'

这会产生真实费用。每次请求只生成一个结果；candidateCount 可以省略，或固定为 1。

解析响应时做三项检查

下面的 Python 示例会检查是否真的存在图片、读取实际 MIME，并选择正确扩展名：

import base64
import os
from pathlib import Path

import requests

response = requests.post(
    "https://api.yingtu.ai/v1beta/models/"
    "gemini-3.1-flash-image:generateContent",
    headers={"Authorization": f"Bearer {os.environ['YINGTU_API_KEY']}"},
    json={
        "contents": [{
            "role": "user",
            "parts": [{"text": "留有标题区域的社区图书馆活动插画"}],
        }],
        "generationConfig": {
            "responseModalities": ["TEXT", "IMAGE"],
            "imageConfig": {"aspectRatio": "4:3", "imageSize": "1K"},
            "candidateCount": 1,
        },
    },
    timeout=180,
)
response.raise_for_status()
payload = response.json()

image_part = next(
    (
        part
        for candidate in payload.get("candidates", [])
        for part in candidate.get("content", {}).get("parts", [])
        if part.get("inlineData", {}).get("data")
    ),
    None,
)

if image_part is None:
    reason = payload.get("promptFeedback", {}).get(
        "blockReason",
        "响应中没有图片内容",
    )
    raise RuntimeError(reason)

inline = image_part["inlineData"]
suffix = {
    "image/png": ".png",
    "image/jpeg": ".jpg",
    "image/webp": ".webp",
}.get(inline["mimeType"])

if suffix is None:
    raise RuntimeError(f"暂不处理该返回格式：{inline['mimeType']}")

Path(f"yingtu-first-image{suffix}").write_bytes(
    base64.b64decode(inline["data"])
)

不要固定读取 parts[0]。响应可以先返回文字再返回图片，也可以只有图片；文件格式以 inlineData.mimeType 为准。

没有图片时不要伪造成功

请求返回 HTTP 200，不代表一定存在可保存的图片。候选结果可能因为内容过滤而为空，也可能只有文字。此时应读取 promptFeedback.blockReason、记录 responseId，并把失败交给业务层处理。

检查模型是否选对

区分 1K 效率、多分辨率、专业任务和 2.5 迁移。

任务较长时改用异步

保存 task_id，并使用有截止时间的轮询。

按状态码排查

处理参数、密钥、余额、限流和服务端错误。

确认 SDK 支持范围

以维护中的 REST 接口为准，不根据模型名称推断 SDK 兼容。

​发送一条完整请求

​解析响应时做三项检查

​没有图片时不要伪造成功