Iymau API 文档

认证与 API 密钥

您的 API 密钥对每个请求进行身份验证。通过 Google 或电子邮件注册，立即获得一个有效的密钥。请妥善保管此密钥，因为它充当该服务的密码。如果您丢失了它，可以生成一个新密钥以替换旧的有效密钥。系统按实际令牌用量收费，因此错误和拒绝不收费。您可以随时通过加密货币充值。

Copycurl https://api.iyamau.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

首次通过聊天完成端点发起的请求

向聊天补全端点发送 POST 请求以生成文本。使用仪表板提供的 base URL 以确保与标准客户端兼容。此专用服务的模型标识符始终为 "uncensored"。你可以调整 temperature 和 top_p 等参数来控制创造性。系统接受用于提示和消息的标准 JSON 负载。错误不会消耗您的预付费额度。此方法适用于您选择的任何 OpenAI 兼容 SDK。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.iyamau.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)

与 Node.js 客户端的集成

使用官方 Node.js SDK 或任何兼容库与 API 交互。使用 base URL 和 API 密钥配置客户端。uncensored 模型响应标准消息格式。您可以在单个请求中发送多轮对话以获取上下文。响应对象包含生成的文本和使用统计信息。支持流式传输以实现实时 token 交付。此方法确保您的应用具有低延迟。服务在我们的服务器上处理繁重的工作。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.iyamau.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);

流式响应和 SSE

通过设置 stream 参数为 true 启用流式传输。您会为每个生成的 token 接收服务器发送事件 (SSE)。这允许在文本生成时立即显示。最后一个数据块包含请求的总 token 使用情况。此功能非常适合聊天界面和实时应用。它降低了最终用户的感知延迟。您可以解析每个 SSE 事件中的 JSON 对象。uncensored 模型高效支持此标准协议。

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)

参数：temperature、top_p 和 JSON 模式

使用标准参数控制生成行为。设置 temperature 以调整随机性，较高的值会增加创造性。使用 top_p 过滤词汇分布。通过将 response_format 设置为 json_object 启用 JSON 模式以获取结构化数据。uncensored 模型可靠地遵循这些约束。您还可以指定 stop 序列以提前停止生成。Seed 值允许在测试期间获得可复现的结果。这些选项让您能够精确控制输出质量。

速率限制、配额和常见错误

API 限制每个密钥每分钟 300 次请求。你可以同时拥有最多 8 个并发请求。每个请求体不得超过 8 MB。如果收到 401 错误，请检查 API 密钥的有效性。402 错误表示预存信用额不足；通过加密货币充值以继续服务。429 错误表示你已达到速率限制。等待几秒后再重试。上下文窗口总共支持 100,000 个 token。这允许进行广泛的文档处理或长对话。