DeepAI 文生图 API — 完整参数详解与调用示例

API 端点

POST https://api.deepai.org/api/text2img

需要在 Header 里带 api-key: YOUR_API_KEY。

必选参数

text

类型：string

这是唯一的必选参数——你想要生成什么样的图像的文字描述。

data = {
    'text': 'A starry night over a serene lake'
}

也支持传入 URL 指向一个包含提示词的纯文本文件，或者直接上传本地 .txt 文件。

可选参数

width 和 height

类型：string（注意是字符串不是整数）默认值：512 推荐范围：128–1536

输出图像的宽和高（像素）。两个值独立传。

示例：

data = {
    'text': '...',
    'width': '1024',
    'height': '1024'
}

image_generator_version

类型：string 可选值：standard 或 hd 默认值：standard

选择图像生成模型版本。Standard 快，HD 清晰。

data = {
    'text': '...',
    'image_generator_version': 'hd'
}

negative_prompt

类型：string

反向提示词——告诉 AI 哪些元素不要出现在图像里。效果和网页端的反向提示词相同。

DeepAI 官方推荐的通用反向提示词：

bad anatomy, bad proportions, blurry, cloned face, cropped, deformed, disfigured, duplicate, error, extra arms, extra fingers, extra legs, extra limbs, fused fingers, gross proportions, jpeg artifacts, long neck, low quality, lowres, malformed limbs, missing arms, missing legs, morbid, mutated hands, mutation, mutilated, out of frame, poorly drawn face, poorly drawn hands, signature, text, too many fingers, ugly, username, watermark, worst quality

grid_size

类型：string 可选值："1"（默认）或 "2"

设为 "2" 时，一次生成 4 张（2×2 网格），但只消耗 1 次 API 调用额度。适合批量对比效果。

data = {
    'text': '...',
    'grid_size': '2'  # 生成 4 张对比
}

seed

类型：string

种子值（整数），用来控制随机生成起点。同一个 seed + 同一个提示词 = 高度相似的结果。适合精确复现。

data = {
    'text': '...',
    'seed': '42'
}

diffusion_steps

类型：string 默认值：50

扩散步数。值越高细节越多但生成越慢。范围约 20–80。

data = {
    'text': '...',
    'diffusion_steps': '60'  # 更多细节
}

最佳分辨率选择（来自 DeepAI 官方文档）

Standard 模型推荐

HD 模型推荐

关于极端尺寸

• 小于约 256：可能产生奇怪伪影
• 大于约 1216–1536：Standard 模型可能质量急剧下降；HD 模型上限更高
• 非标准比例（比如 1:10 或 10:1）容易出问题

完整 Python 示例

import requests

r = requests.post(
    "https://api.deepai.org/api/text2img",
    data={
        'text': 'A cinematic shot of a majestic wizard cat holding a glowing crystal, cyberpunk style, neon lights',
        'image_generator_version': 'hd',
        'width': '1024',
        'height': '1024',
        'negative_prompt': 'bad anatomy, extra fingers, blurry, low quality, watermark',
        'grid_size': '1',
    },
    headers={'api-key': 'YOUR_API_KEY'}
)
result = r.json()
print(f"Generated image URL: {result['output_url']}")

错误处理

API 返回 HTTP 200 时通常没问题，但以下情况可能报错：

好的实践：给 API 调用加上自动重试机制（指数退避），以及结果缓存（相同参数不要重复调用）。

配额消耗

每次成功的 text2img 调用扣 1 次 API 配额：

• 免费注册用户：$5 / 100 次 → $0.05 / 次
• Pro 订阅者：$5 / 500 次 → $0.01 / 次

和网页端生成的区别

API 目前只支持 Standard 和 HD 两种质量模式。Genius Mode 和 Super Genius 2K 暂时只能在网页端手动使用。

常见问题

生成的图像会发布到 DeepAI 公开画廊吗？ 不会。API 调用的图像完全由你自己控制——DeepAI 服务器只在生成过程中处理，不会自动发布到画廊。这是 API 的一个重要优势。

API 生成的图像有版权问题吗？ 和网页端生成的一样——DeepAI 声称用户保留使用权。API 生成的图像因为不走公开画廊流程，比网页端的版权归属更清晰。