同步图片生成
介绍德他同步图片生成的必填字段、图片数量、URL 返回格式和按张结算条件,帮助区分生成、编辑与异步任务。
作者:德他数据技术团队 · 更新于 2026-09-24
核心解答
仅已核准的按张固定费用模型可以调用 /v1/images/generations。提交 model、prompt 和 n,使用 URL 返回;编辑、参考图、Base64、异步任务及图片 Token 计费不在当前开放范围。
调用前确认
只有按张固定费用且已核准的方案可使用本教程。模型广场中的复杂规格和图像 Token 报价可能仅供展示。
不因供应商支持某种参数,就认定德他网关已支持。
最小请求体
POST /v1/images/generations ,使用 Bearer 令牌。
{
"model": "YOUR_APPROVED_IMAGE_MODEL_ID",
"prompt": "一座清晨的现代图书馆,柔和自然光",
"n": 1,
"response_format": "url"
}
参数
| 字段 | 约束 |
| --- | --- |
| model | 已核准图片模型 ID |
| prompt | 非空,最多 16000 字节 |
| n | 1–10;首次测试建议 1 |
| size | 可选;最多 32 字节,须与已核准模型兼容 |
| watermark | 可选布尔值,须与模型兼容 |
| response_format | 只支持 url |
结果与账务
成功结果在 data 数组内返回 HTTPS 图片地址。平台核验实际返回张数后结算。
异步任务、Base64 结果、图片编辑、参考图和工具参数不在当前开放范围。
结果不明或图片数量无法核验时,预留额度会进入待对账;不要重复提交。
常见问题
有图像产品报价就能调用吗?
不能。应同时确认产品的协议、规格和结算方式已通过调用核准,不能把复杂规格报价套进固定按张接口。
接下来阅读
关联文档:德他数据教程。本文按德他实际功能独立编写。