API 目录

创建 DALL·E 3

POST
/v1/images/generations

创建 DALL·E 3 图像

POST https://www.vortapapi.com/v1/images/generations

根据文本提示词生成一张或多张图像。该接口兼容 OpenAI Images API,可用于调用 DALL·E 3 等图像生成模型。

请求头

名称类型必填说明
Authorizationstring使用 Bearer Token 进行鉴权,格式为 Bearer sk-***
Content-Typestring固定为 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"
    }
  ]
}

响应字段说明

字段类型说明
createdinteger图像生成任务完成时的 Unix 时间戳
dataarray生成结果列表
data[].urlstring生成图像的临时访问 URL
data[].revised_promptstring模型实际使用的提示词,可能会基于安全策略或质量优化进行改写
data[].content_filter_resultsobject对生成内容的安全检测结果
data[].prompt_filter_resultsobject对输入提示词的安全检测结果

说明

  • 生成图片的 URL 通常具有时效性,请在有效期内下载或转存。
  • 如果提示词被安全策略拦截,接口可能返回错误,或在响应中标记对应的过滤结果。
  • revised_prompt 可用于了解模型最终采用的图像描述。