创建图像生成

使用本接口根据文本生成图像。接口格式与 OpenAI generations  协议兼容。

授权

Authorization

• 类型：HTTP Bearer Auth，值类型 string
• 必填
• 说明：用于验证账户信息。前往 API 控制台 ，点击创建令牌获取。

Authorization: Bearer <YOUR_API_KEY>

请求头

Content-Type

• 类型：enum<string>
• 必填，固定值 application/json
• 说明：请求体的媒体类型，必须为 application/json。

请求体

概览

model

• 类型：string
• 必填
• 说明：使用的图像模型。
• 可选值：Ming-Image-0.1-Design

prompt

• 类型：string
• 必填
• 说明：用于描述目标图像的提示词。

output_format

• 类型：string
• 选填，默认 png
• 说明：生成图像的输出格式。
• 可选值：png、jpeg

response_format

• 类型：string
• 选填，默认 b64_json
• 说明：返回图片的形式。
• 可选值：
  • url — 返回图片 URL，有效期 24 小时。
  • b64_json — 返回图片 Base64 编码数据。

size

• 类型：string
• 选填，默认 auto
• 说明：输出图像大小。设为 auto 时由模型自动选择；也可以使用 {w}x{h} 格式指定，例如 "1024x1024"。

watermark

• 类型：boolean
• 选填，默认 false
• 说明：控制 AI 生成图片时是否添加水印。
• 可选值：
  • true — 启用 AI 生成的显式水印及隐式数字水印，符合政策要求。
  • false — 关闭所有水印。

不支持的属性

以下 OpenAI images/generations 的属性，当前接口不支持：

• background
• moderation
• n
• output_compression
• partial_images
• quality
• style
• stream

响应体

created

• 类型：integer
• 说明：响应生成时间，Unix 时间戳，单位为秒。

id

• 类型：string
• 说明：本次请求的唯一标识。

model

• 类型：string
• 说明：本次请求使用的模型 ID。

data

• 类型：object[]
• 说明：生成图片列表。

data[].b64_json

• 类型：string
• 说明：当 response_format 为 b64_json 时，返回图片的 Base64 编码数据。

data[].url

• 类型：string
• 说明：当 response_format 为 url 时，返回图片 URL，有效期 24 小时。

output_format

• 类型：string
• 说明：本次响应的图像格式，如 png 或 jpeg。

size

• 类型：string | null
• 说明：输出图像大小。显式指定时返回具体值，如 1024x512；未显式指定时可以为 null。

usage

• 类型：object
• 说明：本次请求的 Token 与图片张数统计。图片按张数计费时，以 input_image_count 和 output_image_count 为准。

usage.input_tokens

• 类型：integer
• 说明：消耗的输入 Token 数。

usage.input_tokens_details

• 类型：object
• 说明：输入 Token 明细。
• 字段：
  • image_tokens — 图像输入消耗的 Token 数。
  • text_tokens — 文本输入消耗的 Token 数。

usage.output_tokens

• 类型：integer
• 说明：生成的输出 Token 数。

usage.output_tokens_details

• 类型：object
• 说明：输出 Token 明细。
• 字段：
  • image_tokens — 图像生成消耗的 Token 数。
  • text_tokens — 文本生成消耗的 Token 数。

usage.total_tokens

• 类型：integer
• 说明：消耗的总 Token 数。

usage.input_image_count

• 类型：integer
• 说明：本次请求的输入图片张数。图像生成接口固定为 0。

usage.output_image_count

• 类型：integer
• 说明：本次请求生成的输出图片张数，按张计费时使用该值。

示例

请求示例

curl --location --request POST \
  'https://api.ant-ling.com/v1/images/generations' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "model": "Ming-Image-0.1-Design",
  "prompt": "生成一个苹果"
}'

from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.ant-ling.com/v1",
    api_key="<YOUR_API_KEY>"
)
 
response = client.images.generate(
    model="Ming-Image-0.1-Design",
    prompt="生成一个苹果"
)
 
print(response.data[0].b64_json)

import OpenAI from 'openai';
 
const client = new OpenAI({
  baseURL: 'https://api.ant-ling.com/v1',
  apiKey: '<YOUR_API_KEY>',
});
 
const response = await client.images.generate({
  model: 'Ming-Image-0.1-Design',
  prompt: '生成一个苹果',
});
 
console.log(response.data[0].b64_json);

响应示例

{
  "created": 1713833628,
  "id": "0b446a1717930916439978967edcf9",
  "model": "Ming-Image-0.1-Design",
  "data": [
    {
      "b64_json": "..."
    }
  ],
  "output_format": "png",
  "size": null,
  "usage": {
    "input_tokens": 0,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 0
    },
    "output_tokens": 4096,
    "output_tokens_details": {
      "image_tokens": 4096,
      "text_tokens": 0
    },
    "total_tokens": 4096,
    "input_image_count": 0,
    "output_image_count": 1
  }
}