快速入门：面向图像管道的无审查文本 API

基础 URL 与认证

我们的 API 遵循标准的 OpenAI chat-completions 结构。首先，导航到获取 API 密钥页面，使用电子邮件和密码注册。API 密钥将立即显示。试用无需电话号码或信用卡，但持续使用需要预付额度。

将基础 URL 设置为https://api.imagegenapi.com/v1。在Authorization标头中包含你的 API 密钥作为 Bearer 令牌。此设置适用于任何 OpenAI 兼容客户端库。使用的模型标识符为uncensored，这是一个开放权重模型，针对合法成人用途进行了无拒绝回答优化。

发送提示词

发送标准的chat.completions请求以生成文本。API 接受messages数组中的消息列表。它返回包含补全内容的 JSON 对象。这非常适合不需要流式传输的一次性提示词生成或元数据编辑任务。

Copycurl 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 blunt product review of a cheap VPN."}]
  }'

请求体包含字段 model 设置为 uncensored 以及你的对话历史。响应包含助手的回复，你可以将其输入到图像生成管线中，或用作标题。

Python SDK 集成

对于 Python 开发者，请使用官方openai库。配置base_url和api_key以指向我们的服务。这允许你利用熟悉的 Python 习惯用法，同时访问我们的无审查模型。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

使用你的密钥和正确的基础 URL 初始化客户端。使用你的消息调用chat.completions.create()。这种方法最适合批处理处理，或当你需要在应用程序逻辑中直接解析 JSON 响应时。请记住，模型 ID 必须为uncensored。

Node.js SDK 用法

Node.js 开发者可以使用openainpm 包。将baseURL设置为我们的接口。这对于需要异步处理文本响应的服务器端渲染或 API 网关很有用。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.imagegenapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

使用你的 API 密钥和基础 URL 创建客户端实例。调用chat.completions.create()以获取文本输出。此方法适合生成脚本、标题或在文本用于图像管道之前从中提取信息。

流式响应

对于实时文本生成，通过设置stream: true启用流式传输。API 返回服务器发送事件 (SSE) 流，而非单个 JSON 对象。你必须处理到达的delta块以重建完整消息。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

遍历流以增量显示文本。这对于延迟敏感的应用程序至关重要，例如实时提示词编辑或交互式聊天界面。每个块包含响应的一部分，允许你渲染正在生成的文本。

速率限制与约束

每个 API 密钥限制为每分钟 300 个请求。请求正文不得超过 8 MB。如果超出限制，你将收到429错误。如果需要，请重新生成密钥，这将使旧密钥失效。

如果你的预付额度耗尽，API 将拒绝请求。没有免费无限层级；你必须充值额度。401错误表示 API 密钥无效或缺失。确保你的密钥正确设置在授权标头中。上下文窗口为 100,000 个 token，包括提示词和补全。