图像生成模型

PilotAIHub 图像生成 API 兼容 OpenAI Images 协议，支持文生图，按生成数量计费。

接口地址

端点：POST https://api.pilotaihub.com/images/generations

图像生成为同步接口，请求后直接返回图片 URL，无需轮询。按生成图片数量计费。

1. 图片生成

向图像生成端点发送 POST 请求，指定模型与提示词，网关会路由到对应服务商并返回生成的图片。

1.1 Header 参数

参数名	类型	必需	说明
Authorization	string	是	格式为 `Bearer {API_KEY}`，API_KEY 为 PilotAIHub 虚拟 Key。
Content-Type	string	是	固定为 application/json。

1.2 Body 参数

参数名	类型	必需	说明
model	string	是	图像生成模型代码，可通过 GET /v1/models 查询可用模型列表。
prompt	string	是	图像生成提示词，描述希望生成的图片内容。建议使用英文以获得更好效果。
n	integer	否	生成图片数量，默认 1。按数量计费，每张图片单独扣费。
size	string	否	图片尺寸，默认 "1024x1024"。可选值取决于模型支持，如 "512x512"、"1024x1024"。
quality	string	否	图片质量，可选 "standard"（标准）或 "hd"（高清），具体支持取决于模型。
response_format	string	否	返回格式，"url"（默认，返回图片 URL）或 "b64_json"（返回 base64 编码）。
style	string	否	图片风格，如 "vivid"（生动）或 "natural"（自然），具体支持取决于模型。

1.3 返回格式

响应示例

{
  "created": 1700000000,
  "data": [
    {
      "url": "https://cdn.example.com/generated-image-001.png"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 1
  }
}

计费说明

图像生成按生成数量计费（n 参数），单价取决于模型配置。usage.total_tokens 字段复用为生成图片数量。

1.4 请求示例

curl

curl https://api.pilotaihub.com/images/generations \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-image-model",
    "prompt": "A serene mountain landscape at sunset, oil painting style",
    "n": 1,
    "size": "1024x1024"
  }'

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.pilotaihub.com",
    api_key="sk-p-xxxxxxxxxxxxxxxx",
)

resp = client.images.generate(
    model="your-image-model",
    prompt="A serene mountain landscape at sunset, oil painting style",
    n=1,
    size="1024x1024",
)

print(resp.data[0].url)

2. 批量生成

通过 n 参数一次生成多张图片，网关会返回对应数量的图片 URL。注意每张图片都会独立计费。

python (批量生成)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.pilotaihub.com",
    api_key="sk-p-xxxxxxxxxxxxxxxx",
)

resp = client.images.generate(
    model="your-image-model",
    prompt="A cute cat wearing a space suit",
    n=4,
    size="1024x1024",
)

for i, item in enumerate(resp.data):
    print(f"Image {i+1}: {item.url}")

注意事项

图片 URL 有有效期限制，请及时下载保存。
提示词内容需符合平台内容安全策略，违规内容将被拒绝。
不同模型支持的尺寸与参数可能不同，请以模型详情页为准。