图片生成

创建 AI 图片生成任务。默认同步模式，等待生成完成后直接返回图片 URL。

端点

端点	模式
POST /v1/images/generations	同步（默认）/ 异步（加 X-Async: true 头）
POST /v1/async/images/generations	始终异步

请求参数

参数	类型	必填	说明
model	string	✅	模型名称，见下方各平台支持列表
prompt	string	✅	图片描述提示词
negative_prompt	string	❌	反向提示词（不希望出现的内容）
size	string	❌	图片尺寸，如 1024x1024、16:9
quality	string	❌	图片质量：standard（1K）、hd（4K）
n	number	❌	生成数量（百度生图支持）
enhance_prompt	string	❌	AI 自动优化提示词：Enabled / Disabled
output_config	object	❌	高级输出配置（腾讯云格式）
file_infos	array	❌	参考图片列表（腾讯云图生图）

size 转换规则

size 值	实际比例
1024x1024 / 512x512	1:1
1792x1024 / 1920x1080	16:9
1024x1792 / 1080x1920	9:16
16:9 / 9:16 / 1:1	直接使用

请求示例

腾讯云生图（GEM-3.0）

curl -X POST https://pico.5884.cn/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GEM-3.0",
    "prompt": "一只可爱的卡通猫咪",
    "size": "1024x1024"
  }'

百度生图（NBP）

curl -X POST https://pico.5884.cn/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "NBP",
    "prompt": "赛博朋克风格的城市夜景",
    "size": "1:1",
    "quality": "2K"
  }'

高清宽屏 + 提示词优化

curl -X POST https://pico.5884.cn/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "GEM-3.0",
    "prompt": "赛博朋克城市夜景",
    "size": "1792x1024",
    "quality": "hd",
    "enhance_prompt": "Enabled"
  }'

响应格式

同步模式（默认）

系统自动等待生成完成（最长 10 分钟），直接返回图片 URL：

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://xxx.myqcloud.com/aigcImageGenFile.png"
    }
  ]
}

异步模式

添加 X-Async: true 请求头，或使用 /v1/async/images/generations 端点：

{
  "task_id": "tsk-gcszputkketjv4ap",
  "status": "pending",
  "model": "NBP",
  "message": "任务已提交，使用 GET /v1/generations/:task_id 轮询结果"
}

使用 任务查询接口 轮询获取结果。

支持的模型

模型	平台	说明
GEM-2.5 / GEM-3.0	腾讯云	Gemini 生图
Hunyuan-3.0	腾讯云	混元生图
Kling-2.1	腾讯云	可灵生图
NB / NBP / NB2	百度云	Nano Banana 系列
I4YG1 / I4FG1 / I4G1	百度云	iRAG 生图

提示

使用 GET /v1/models 可查询当前可用的模型列表。