图片生成
如何通过 Yeehoo 对外 API 提交图片任务、查询状态并获取结果。
图片生成是当前最推荐优先接入的能力之一。
适用场景
适合这些场景：
- 文生图
- 运营素材生成
- 海报、封面、插画生成
- 工作流或 Agent 调用图片模型
典型流程
- 调用
/v1/generations，并通过model指定图片模型 - 服务端返回任务对象和
task_id - 通过
/v1/tasks/{task_id}轮询，或等待 webhook - 在任务进入
succeeded后读取最终结果
请求示例
curl https://aibubu.cn/v1/generations \
-H "Authorization: Bearer sk_yeehoo_your_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: image-demo-001" \
-d '{
"model": "gpt-image-2",
"prompt": "A cinematic fox made of folded paper in a rainy neon street",
"aspect_ratio": "1:1",
"resolution": "1K"
}'成功接入的判断标准
第一阶段不用追求所有字段都接完，先确认这三件事：
- 能成功提交任务
- 能拿到
task_id - 能通过轮询拿到终态结果
什么时候用轮询，什么时候用 webhook
- 开发联调阶段：优先轮询
- 线上生产阶段：轮询保底，webhook 做通知
常见注意点
- 创建任务时建议始终带
Idempotency-Key - 不要假设创建接口会立即返回最终图片结果
- 任务结果以终态响应为准，而不是创建响应