图片生成

创建 AI 图片生成任务。

请求

POST /v1/images/generations

请求参数

参数	类型	必填	说明
model	string	✅	模型名称，如 GEM-3.0、Kling-2.1
prompt	string	✅	图片描述提示词
negative_prompt	string	❌	反向提示词（不希望出现的内容）
size	string	❌	图片尺寸，如 1024x1024、1792x1024、16:9
quality	string	❌	图片质量：standard（1K）、hd（4K）
enhance_prompt	string	❌	AI 自动优化提示词：Enabled / Disabled
output_config	object	❌	高级输出配置（覆盖 size/quality 转换）
file_infos	array	❌	参考图片列表（图生图）

size 转换规则

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

quality 转换规则

quality 值	实际分辨率
standard	1K
hd	4K
1080P / 2K / 4K	直接使用

请求示例

基础生图

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"
  }'

高清宽屏 + 提示词优化

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"
  }'

图生图（参考图片）

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": "将这张照片转换为水彩风格",
    "file_infos": [
      {"Type": "Url", "Url": "https://example.com/photo.jpg"}
    ]
  }'

响应

{
  "task_id": "1403290248-AigcImageTask-xxxx",
  "status": "pending",
  "model": "GEM-3.0"
}

字段	说明
task_id	任务 ID，用于查询结果
status	任务状态：pending
model	使用的模型

info

图片生成是异步操作。提交后返回 task_id，需要使用 任务查询接口 轮询获取生成结果。