跳到主要内容

图像生成 API

Images API 用于生成和编辑图像，支持多种图像模型。

图像生成​

接口地址​

POST https://api.weelinking.com/v1/images/generations

请求参数​

参数类型必填说明
modelstring是模型名称，如 dall-e-3、gpt-image-1
promptstring是图像描述提示词
ninteger否生成图像数量，默认 1
sizestring否图像尺寸，如 1024x1024
qualitystring否图像质量，standard 或 hd
response_formatstring否返回格式，url 或 b64_json

请求示例​

Python​

import openai

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.weelinking.com/v1"
)

response = client.images.generate(
    model="dall-e-3",
    prompt="一只可爱的橘猫在阳光下睡觉",
    size="1024x1024",
    quality="standard",
    n=1
)

print(response.data[0].url)

cURL​

curl https://api.weelinking.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "dall-e-3",
    "prompt": "一只可爱的橘猫在阳光下睡觉",
    "size": "1024x1024",
    "quality": "standard",
    "n": 1
  }'

响应示例​

{
  "created": 1234567890,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

图像编辑​

接口地址​

POST https://api.weelinking.com/v1/images/edits

请求参数​

参数类型必填说明
modelstring是模型名称
imagefile是原始图像文件
promptstring是编辑指令
maskfile否遮罩图像，指定编辑区域
ninteger否生成数量
sizestring否输出尺寸

请求示例​

response = client.images.edit(
    model="dall-e-2",
    image=open("original.png", "rb"),
    mask=open("mask.png", "rb"),
    prompt="在空白区域添加一朵向日葵",
    n=1,
    size="1024x1024"
)

print(response.data[0].url)

支持的模型​

DALL·E 系列​

模型说明支持尺寸
dall-e-3最新版本，质量最高1024x1024, 1792x1024, 1024x1792
dall-e-2支持编辑和变体256x256, 512x512, 1024x1024

GPT-Image-1​

模型说明支持尺寸
gpt-image-1OpenAI 最新图像模型1024x1024, 1536x1024, 1024x1536

Flux 系列​

模型说明特点
flux-pro专业版高质量，多种宽高比
flux-dev开发版快速生成

Nano Banana Pro​

模型说明特点
gemini-3-pro-image-preview4K 高清最佳文本渲染，支持局部编辑

最佳实践​

提示词技巧​

  1. 详细描述：包含主体、风格、光照、构图等信息
  2. 使用修饰词：如 "高清"、"专业摄影"、"艺术风格" 等
  3. 指定风格：如 "油画风格"、"3D 渲染"、"极简主义" 等

示例提示词​

一只金色的拉布拉多犬在海滩上奔跑，
阳光照射下毛发闪闪发光，
背景是蓝色的大海和天空，
专业摄影，高清，浅景深

错误处理​

错误码说明解决方案
400请求参数错误检查提示词和参数格式
401API Key 无效检查认证信息
429请求过于频繁降低请求频率
500生成失败修改提示词后重试