创建 DALL·E 3
POST/v1/images/generations 创建 DALL·E 3 图像
POST https://www.vortapapi.com/v1/images/generations
根据文本提示词生成一张或多张图像。该接口兼容 OpenAI Images API,可用于调用 DALL·E 3 等图像生成模型。
请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | 使用 Bearer Token 进行鉴权,格式为 Bearer sk-*** |
Content-Type | string | 是 | 固定为 application/json |
请求示例
curl https://www.vortapapi.com/v1/images/generations \
-H "Authorization: Bearer sk-***" \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "A young, adorable sea otter floating in the ocean",
"n": 1,
"size": "1024x1024"
}'
响应示例
{
"created": 1749819664,
"data": [
{
"content_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"prompt_filter_results": {
"hate": {
"filtered": false,
"severity": "safe"
},
"profanity": {
"detected": false,
"filtered": false
},
"self_harm": {
"filtered": false,
"severity": "safe"
},
"sexual": {
"filtered": false,
"severity": "safe"
},
"violence": {
"filtered": false,
"severity": "safe"
}
},
"revised_prompt": "A young, adorable sea otter floating in the ocean",
"url": "https://example.com/generated-image.png"
}
]
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
created | integer | 图像生成任务完成时的 Unix 时间戳 |
data | array | 生成结果列表 |
data[].url | string | 生成图像的临时访问 URL |
data[].revised_prompt | string | 模型实际使用的提示词,可能会基于安全策略或质量优化进行改写 |
data[].content_filter_results | object | 对生成内容的安全检测结果 |
data[].prompt_filter_results | object | 对输入提示词的安全检测结果 |
说明
- 生成图片的 URL 通常具有时效性,请在有效期内下载或转存。
- 如果提示词被安全策略拦截,接口可能返回错误,或在响应中标记对应的过滤结果。
revised_prompt可用于了解模型最终采用的图像描述。