curl --request POST \
  --url https://api.foxapi.cc/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张日落时分海边灯塔的水彩画"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}
'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这是一张日落时分海边灯塔的水彩画。",
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAA..."
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 1120,
    "totalTokenCount": 1135
  }
}

Gemini 格式

Gemini 格式 - 图像生成

使用 Gemini 原生格式的 generateContent 接口生成图像
通过 generationConfig.responseModalities 设置为 ["TEXT", "IMAGE"] 或 ["IMAGE"] 启用图像输出
支持文生图：纯文本 prompt 生成图像
支持图生图：上传图片 + 文本 prompt 进行图像编辑
支持多轮对话方式迭代修改图像
通过 generationConfig.imageConfig 控制宽高比和图像分辨率
流式调用请使用 /v1beta/models/{model}:streamGenerateContent?alt=sse

POST

v1beta

models

{model}

:generateContent

curl --request POST \
  --url https://api.foxapi.cc/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张日落时分海边灯塔的水彩画"
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ]
  }
}
'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "这是一张日落时分海边灯塔的水彩画。",
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAA..."
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 1120,
    "totalTokenCount": 1135
  }
}

授权

Authorization

string

header

必填

所有接口均需要使用Bearer Token进行认证

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

路径参数

model

enum<string>

必填

模型名称。支持 gemini-3-pro-image-preview（专业素材制作，高级推理）和 gemini-3.1-flash-image-preview（高效率，针对速度优化）

可用选项:

gemini-3-pro-image-preview,

gemini-3.1-flash-image-preview

示例:

"gemini-3.1-flash-image-preview"

请求体

application/json

contents

object[]

必填

对话内容列表

Show child attributes

generationConfig

object

必填

生成配置（图像生成必须设置 responseModalities）

Show child attributes

systemInstruction

object

系统指令

Show child attributes

safetySettings

object[]

安全设置

Show child attributes

响应

图像生成响应

candidates

object[]

候选结果列表

Show child attributes

usageMetadata

object

用量统计

Show child attributes

Gemini 格式 - 嵌入 Gemini 格式 - 音乐生成