简短回答
image gen api openai 这个短语可能指代两种不同的事物,区分它们很有帮助。第一种是 OpenAI 自己的图像生成服务,属于 OpenAI,需要使用 OpenAI 账户访问。第二种是任何复制 OpenAI 请求格式的服务,以便现有的 SDK 和工具能够继续工作。本网站属于第二种类型,且仅支持文本。
你在这里获得的是一个托管的、无审查的文本 LLM API。你将 OpenAI 客户端指向下方的 base URL,将模型设置为 uncensored,即可接收聊天补全。不会返回像素。没有图像、音频或视频生成,没有嵌入,也没有微调,这些也不在本文档描述的计划内。
兼容与不兼容的内容
"兼容"一词在营销中常被夸大,因此这里列出精确的接口规范。base URL 为 https://api.imagegenapi.com/v1,认证方式为 Authorization: Bearer <key>,存在两种可用方法。
| 接口 | 此处可用 | 备注 |
|---|---|---|
POST /v1/chat/completions | 是 | 流式输出、函数调用、JSON 模式 |
GET /v1/models | 是 | 列出 uncensored |
| 图像生成接口 | 否 | 仅文本服务 |
| 嵌入、音频、微调 | 否 | 不提供 |
如果你的代码调用此 base URL 上的图像路径,将会收到错误而非图片。上述两种方法之外的任何 OpenAI 功能也是如此。你熟悉的采样控制参数有效:temperature、top_p、stop、seed 以及惩罚参数都会透传,回复可以使用提示词和补全共享的完整 100,000 token 上下文窗口。
明确身份也很重要。uncensored 背后的模型是一个独立的开放权重模型,由独立提供商运行。这不是 OpenAI 的 API,不代理 OpenAI 模型,也与 OpenAI 无关。本网站的 GPT image API 和 uncensored 文本 页面从图像模型名称的角度涵盖了这一区别。
为何会提出此问题
人们出于可以理解的原因访问此类页面。图像工具由文本提示词驱动,文本提示词由语言模型编写,许多语言模型网关共享一种请求格式。自然的猜测是某个 API 能同时完成这两项工作。
实际上,这两项工作是独立的系统,拥有独立的密钥、定价和规则。图像服务接收提示词并返回图像。文本服务接收消息并返回更多文本。它们之间的连接是你,或者你编写的脚本,将文本从一个系统传递到另一个系统。一旦你这样理解,有用的问题就从"这个 API 能生成图像吗"变为"这个 API 能否为我已使用的图像模型编写更好的提示词"。
这是一个真实的使用场景,也是无审查文本模型发挥作用的地方。通用助手通常会重写、软化或拒绝涉及成人小说主题、故事设定中的暴力或黑暗美学的提示词请求。经过调整以在不拒绝的情况下回答合法成人请求的模型,通常能按要求完成写作任务。硬性限制仍然存在:任何情况下都不涉及未成年人的性内容。
使用文本 API 编写图像提示词
这里有一个小型的、可工作的示例。它要求模型提供详细的提示词,然后你将其粘贴到你使用的任何图像生成器中。代码使用官方 OpenAI Python SDK 针对此 base URL。
from openai import OpenAI
client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")
reply = client.chat.completions.create(
model="uncensored",
temperature=0.8,
messages=[
{"role": "system", "content": "You write prompts for text-to-image models. Reply with one paragraph: subject, composition, lighting, palette, lens or style. No preamble."},
{"role": "user", "content": "A ruined lighthouse at dusk for a dark fantasy book cover."},
],
)
print(reply.choices[0].message.content)
来自命令行的相同调用:
curl https://api.imagegenapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Write a one-paragraph image prompt: a ruined lighthouse at dusk, dark fantasy cover art."}]}'
使输出可用
图像生成器接受的内容各不相同,因此通过系统消息塑造结果。要求固定结构、字数限制以及需要避免的事项列表。如果你需要在管道中使用提示词,请设置 response_format 为类型 json_object,并要求包含 prompt 和 negative 等键。然后解析它并将字段传递给你的图像客户端。设置 seed 和较低的 temperature 可以在迭代措辞时提供更可重复的输出。
包含真实数据的批处理工作流
假设你为 1,000 个场景生成提示词。每个请求发送约 300 token(指令加上简短的场景说明),并接收约 200 token 的提示词。定价为每 1M 输入 token $0.15,每 1M 输出 token $0.50。
- 一次请求,输入:300 / 1,000,000 x $0.15 = $0.000045。
- 一次请求,输出:200 / 1,000,000 x $0.50 = $0.0001。
- 一次请求总计:$0.000145。
- 1,000 次请求:1,000 x $0.000145 = $0.145。
因此,一千个提示词的成本约为 14.5 美分,而文本步骤的成本通常远低于图像生成本身的费用,你应该向该提供商查询其价格。完整密钥允许 8 个并发请求和每分钟 300 个请求,因此 1,000 个请求可以在少量工作池的情况下在几分钟内完成。处理 HTTP 429 时请等待;Retry-After: 5 标头会告诉你临时过载时需要等待的时间。
你可以尝试所有这些操作而无需付费。注册后,API 密钥页面 提供一键领取 $0.50 试用额度,有效期为 7 天。长期来看,充值从 $20 到 $500 不等,支持加密货币支付(TRC20 上的 USDT 或 Base 上的 USDC);详见 定价 中的奖励层级。
需要避免的错误
当有人尝试使用 OpenAI 格式的接口进行图像工作时,会反复出现一些错误。
- 调用图像路径并期望获得图片。 此处仅存在文档记录的两个方法。检查错误响应体,而不是重试,因为重试不会改变结果。
- 要求文本模型"绘制"某物。 它可能会用 ASCII 艺术、描述或道歉来回答。如果你想要图片,请将其生成的提示词发送到实际的图像生成器。
- 跳过模型列表。 快速执行
GET /v1/models调用可确认密钥有效,且唯一模型为uncensored。这不需要花费任何费用。 - 忽略 429 响应。 试用密钥允许 2 个并发请求,因此包含十个工作线程的循环会快速失败。限制工作线程数量或添加短暂等待。
- 发送过大的请求体。 每个请求的限制为 8 MB。提示词编写调用非常小,所以这通常不重要,但粘贴的文档可能会触及此限制。
这些问题都不难修复,最快的解决方法是在将任何内容接入更大的工具之前,运行一个十行代码的测试脚本。
何时其他服务更合适
在做出选择时要务实。如果你需要图片本身,你需要图像提供商,OpenAI 是其中之一;查看其当前文档和定价以了解其提供的细节。如果你的目标只是获得主流风格的清晰提示词,标准助手可能就足够了,你根本不需要此服务。
当文本步骤是瓶颈时,此 API 是更好的选择:你使用的助手拒绝或弱化你的提示词请求,你需要以可预测的每 token 价格生成大量提示词,或者你希望为小说、角色扮演和陪伴类工具使用兼容 OpenAI 的接口,用于合法的成人用途,而无需重写客户端代码。有关完整参数详情,文档 提供了请求格式和错误代码。
另一个实用提示:发送到此 API 的提示词不会用于训练。尽管如此,将任何托管服务视为位于你的机器之外,避免发送你不会粘贴到网页表单中的密钥。
