Token Switch 文档中心

中文

English

中文

English

Appearance

创建图片 ​

http
POST /v1/images/generations

根据文本提示生成图像。

请求体参数 ​

  • prompt: string

    所需图像的文本描述。GPT 图像模型最大长度为 32000 字符，dall-e-2 为 1000 字符，dall-e-3 为 4000 字符。

  • background: optional "transparent" 或 "opaque" 或 "auto"

    设置生成图像的背景透明度。仅 GPT 图像模型支持此参数。可选值：transparent（透明）、opaque（不透明）或 auto（自动，默认值）。当使用 auto 时，模型将自动确定最佳背景。

    如果设为 transparent，输出格式需支持透明度，因此应为 png（默认值）或 webp。

    • "transparent"

    • "opaque"

    • "auto"

  • model: optional string 或 ImageModel

    用于图像生成的模型。可选值：dall-e-2、dall-e-3，或 GPT 图像模型（gpt-image-1、gpt-image-1-mini、gpt-image-1.5）。默认值为 dall-e-2，除非使用了 GPT 图像模型特有的参数。

    • string

    • ImageModel = "gp-im-2"

      • "gp-im-2"

  • moderation: optional "low" 或 "auto"

    控制 GPT 图像模型生成图像的内容审核级别。可选 low（较低限制）或 auto（自动，默认值）。

    • "low"

    • "auto"

  • n: optional number

    生成的图像数量。取值范围 1–10。dall-e-3 仅支持 n=1。

  • output_compression: optional number

    生成图像的压缩级别（0–100%）。仅 GPT 图像模型在 webp 或 jpeg 输出格式下支持，默认值为 100。

  • output_format: optional "png" 或 "jpeg" 或 "webp"

    生成图像的返回格式。仅 GPT 图像模型支持。可选值：png、jpeg 或 webp。

    • "png"

    • "jpeg"

    • "webp"

  • partial_images: optional number

    生成的中间过程图像数量。用于流式返回中间图像的场景。取值 0–3。设为 0 时，响应将在一次流事件中返回单张完整图像。注意：如果完整图像生成速度较快，最终图像可能会在达到指定中间图像数量之前发送。

  • quality: optional "standard" 或 "hd" 或 "low" 等

    生成图像的质量。

    • auto（默认值）将自动为给定模型选择最佳质量。

    • high、medium 和 low 适用于 GPT 图像模型。

    • hd 和 standard 适用于 dall-e-3。

    • standard 是 dall-e-2 的唯一选项。

    • "standard"

    • "hd"

    • "low"

    • "medium"

    • "high"

    • "auto"

  • response_format: optional "url" 或 "b64_json"

    使用 dall-e-2 和 dall-e-3 时生成图像的返回格式。可选 url 或 b64_json。URL 在图像生成后 60 分钟内有效。GPT 图像模型不支持此参数，其始终返回 base64 编码的图像。

    • "url"

    • "b64_json"

  • size: optional string 或 "auto" 或 "1024x1024" 或 "1536x1024" 等

    生成图像的尺寸。对于 gp-im-2，支持 WIDTHxHEIGHT 格式的任意分辨率，例如 1536x864。宽和高都必须能被 16 整除，且宽高比需在 1:3 到 3:1 之间。分辨率超过 2560x1440 为实验性支持，最大分辨率为 3840x2160。GPT 图像模型支持标准尺寸 1024x1024、1536x1024 和 1024x1536；auto 适用于允许自动尺寸的模型。对于 dall-e-2，可使用 256x256、512x512 或 1024x1024。对于 dall-e-3，可使用 1024x1024、1792x1024 或 1024x1792。

    • string

    • "auto" 或 "1024x1024" 或 "1536x1024" 等

      生成图像的尺寸。对于 gp-im-2，支持 WIDTHxHEIGHT 格式的任意分辨率，例如 1536x864。宽和高都必须能被 16 整除，且宽高比需在 1:3 到 3:1 之间。分辨率超过 2560x1440 为实验性支持，最大分辨率为 3840x2160。GPT 图像模型支持标准尺寸 1024x1024、1536x1024 和 1024x1536；auto 适用于允许自动尺寸的模型。对于 dall-e-2，可使用 256x256、512x512 或 1024x1024。对于 dall-e-3，可使用 1024x1024、1792x1024 或 1024x1792。

      • "auto"

      • "1024x1024"

      • "1536x1024"

      • "1024x1536"

      • "256x256"

      • "512x512"

      • "1792x1024"

      • "1024x1792"

  • stream: optional boolean

    以流式模式生成图像。默认为 false。仅 GPT 图像模型支持此参数。

  • style: optional "vivid" 或 "natural"

    生成图像的风格。仅 dall-e-3 支持。可选 vivid（生动）或 natural（自然）。vivid 使模型倾向于生成超现实和戏剧性的图像，natural 则生成更自然、不那么超现实的图像。

    • "vivid"

    • "natural"

  • user: optional string

    代表最终用户的唯一标识符，可帮助 OpenAI 监控和检测滥用行为。

请求示例 ​

http
curl https://neolink.com/api/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gp-im-2",
    "prompt": "一只可爱的海獭宝宝",
    "n": 1,
    "size": "1024x1024"
  }'
http
curl https://neolink.com/api/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gp-im-2",
    "prompt": "一只可爱的海獭宝宝",
    "n": 1,
    "size": "1024x1024",
    "stream": true
  }' \
  --no-buffer

返回结果 ​

  • ImagesResponse 对象 { created, background, data 等 }

    图像生成端点的响应。

    • created: number

      图像创建时的 Unix 时间戳（秒）。

    • background: optional "transparent" 或 "opaque"

      图像生成所使用的背景参数。transparent 或 opaque。

      • "transparent"

      • "opaque"

    • data: optional array of Image

      生成的图像列表。

      • b64_json: optional string

        生成图像的 base64 编码 JSON。GPT 图像模型默认返回此字段；对于 dall-e-2 和 dall-e-3，仅在 response_format 设为 b64_json 时存在。

      • revised_prompt: optional string

        仅 dall-e-3 支持，用于生成图像的修订后提示词。

      • url: optional string

        使用 dall-e-2 或 dall-e-3 时，如果 response_format 设为 url（默认值），返回生成图像的 URL。GPT 图像模型不支持此字段。

    • output_format: optional "png" 或 "webp" 或 "jpeg"

      图像生成的输出格式。可选 png、webp 或 jpeg。

      • "png"

      • "webp"

      • "jpeg"

    • quality: optional "low" 或 "medium" 或 "high"

      生成图像的质量。可选 low、medium 或 high。

      • "low"

      • "medium"

      • "high"

    • size: optional "1024x1024" 或 "1024x1536" 或 "1536x1024"

      生成图像的尺寸。可选 1024x1024、1024x1536 或 1536x1024。

      • "1024x1024"

      • "1024x1536"

      • "1536x1024"

    • usage: optional object { input_tokens, input_tokens_details, output_tokens 等 }

      仅 gpt-image-1 支持，图像生成的令牌用量信息。

      • input_tokens: number

        输入提示中的令牌数（图像和文本）。

      • input_tokens_details: object { image_tokens, text_tokens }

        图像生成的输入令牌详情。

        • image_tokens: number

          输入提示中的图像令牌数。

        • text_tokens: number

          输入提示中的文本令牌数。

      • output_tokens: number

        模型生成的输出令牌数。

      • total_tokens: number

        图像生成所使用的总令牌数（图像和文本）。

      • output_tokens_details: optional object { image_tokens, text_tokens }

        图像生成的输出令牌详情。

        • image_tokens: number

          模型生成的图像输出令牌数。

        • text_tokens: number

          模型生成的文本输出令牌数。

响应 ​

json
{
  "created": 1713833628,
  "data": [
    {
      "b64_json": "..."
    }
  ],
  "usage": {
    "total_tokens": 100,
    "input_tokens": 50,
    "output_tokens": 50,
    "input_tokens_details": {
      "text_tokens": 10,
      "image_tokens": 40
    }
  }
}
json
event: image_generation.partial_image
data: {"type":"image_generation.partial_image","b64_json":"...","partial_image_index":0}

event: image_generation.completed
data: {"type":"image_generation.completed","b64_json":"...","usage":{"total_tokens":100,"input_tokens":50,"output_tokens":50,"input_tokens_details":{"text_tokens":10,"image_tokens":40}}}