图片生成

文生图接口根据模型分为两种风格：OpenAI Images API 风格（豆包 Seedream）和 Gemini generateContent 风格。

OpenAI 风格（Seedream）

POST /api/v3/images/generations

认证： Authorization: Bearer <API_KEY> 或 x-api-key: <API_KEY>

关键参数

参数	类型	必填	说明
`model`	string	是	模型调用名，如 `doubao-seedream-5-0-260128`
`prompt`	string	是	图片描述
`n`	integer	否	图片数量，默认 1
`size`	string	否	尺寸，如 `1024x1024`，具体支持尺寸因模型而异
`stream`	boolean	否	是否开启 SSE 流式返回中间图

https://www.silvamux.com/api/v3 即接入域名下的 /api/v3，对应路由 /api/v3/images/generations。

示例

curl https://www.silvamux.com/api/v3/images/generations \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "一只戴墨镜的柴犬坐在咖啡馆里",
    "size": "1024x1024",
    "n": 1
  }'

响应：

{
  "created": 1234567890,
  "data": [{"url": "https://..."}],
  "usage": {"output_images": 1}
}

Gemini 风格

Gemini generateContent 风格，适合 Gemini 图像模型。

POST /api/v1/gemini/v1beta/models/{model}:generateContent

认证： Authorization: Bearer <API_KEY> 或 x-api-key: <API_KEY>

示例

curl https://www.silvamux.com/api/v1/gemini/v1beta/models/gemini-3.1-flash-image:generateContent \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "画一只坐在窗台上的猫"}]}
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}
    }
  }'

响应保持 Gemini 格式，计费字段在 usageMetadata 中。

上传限制

请求体大小不超过 64 MB。超出返回 413（REQUEST_TOO_LARGE）。

可用模型

样例模型：doubao-seedream-5-0-260128（Seedream）、gemini-3.1-flash-image（Gemini）。

完整模型清单见模型广场。

计费

文生图按生成张数计费，具体单价调 GET /billing/models 接口。