跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ominiapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
图像 (Images) - 生成图像 (原生 OpenAI 格式)

在给定提示词 (Prompt) 的情况下创建图像。完全兼容 OpenAI 的 /v1/images/generations 接口。
  • 接口地址: POST /v1/images/generations
  • 请求格式 (Content-Type): application/json

​
认证与请求头 (Headers)

  • Authorization (必选): 使用 Bearer Token 认证。格式: Bearer <token>
  • Content-Type: application/json

​
请求参数 (Request Body - JSON)

参数名类型必选说明
promptString是所需图像的文本描述。gpt-image-1 的最大长度为 32000 个字符，dall-e-2 为 1000 个字符，dall-e-3 为 4000 个字符。
modelString否用于图像生成的模型。通常为 dall-e-2、dall-e-3 或 gpt-image-1。默认为 dall-e-2（除非使用特定于 gpt-image-1 的参数）。
nInteger否要生成的图像数量。必须介于 1 到 10 之间。对于 dall-e-3 模型，仅支持 n=1。
sizeString否生成的图像尺寸。 - dall-e-2: 256x256、512x512 或 1024x1024 - dall-e-3: 1024x1024、1792x1024 或 1024x1792 - gpt-image-1: 1024x1024、1536x1024 (横向)、1024x1536 (纵向) 或 自动 (默认)
backgroundString否允许为生成的图像设置背景透明度（仅支持 gpt-image-1）。可选：透明、不透明 或 自动。若为透明，需确保输出格式为 png 或 webp。
moderationString否控制 gpt-image-1 生成图像的内容审核级别。可选：低 (限制较少) 或 自动 (默认)。
qualityString否生成的图像的质量 (如 standard, hd)。
streamBoolean否是否流式返回 (通常图像生成不使用流式)。
styleString否图像风格 (如 vivid 或 natural，适用于 dall-e-3)。
userString否代表您的最终用户的唯一标识符，有助于监控和检测滥用行为。

​
示例代码 (cURL)

curl -X POST "[https://www.ominiapi.com/v1/images/generations](https://www.ominiapi.com/v1/images/generations)" \
  -H "Authorization: Bearer <您的_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "一只在星空下奔跑的猫，赛博朋克风格",
    "n": 1,
    "size": "1024x1024"
  }'

​
响应体结构 (Response - 200 OK)

成功请求将返回 JSON 格式结果。 
{
  "created": 1700000000,
  "data": [
    {
      "b64_json": "string",
      "url": "https://..."
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    }
  }
}