快速入门:为您的视觉 API 工作流使用文本 API
使用标准的 OpenAI 兼容接口,将我们的无审查文本引擎集成到你的视觉管道中。本指南涵盖身份验证、Chat Completions、流式输出以及处理高上下文视觉数据的约束。
- Base URL
https://api.visionllmapi.com/v1- 模型
uncensored
Base URL 与身份验证
首先将 base URL 设置为 https://api.visionllmapi.com/v1。此接口兼容标准 OpenAI SDK 和任何 OpenAI 兼容客户端。你需要一个 API 密钥来对请求进行身份验证。在“获取 API 密钥”页面通过仅输入电子邮件和密码注册即可生成一个。开始时无需信用卡,你将获得有效期为 7 天的 $0.50 试用额度。在 API 密钥页面一键领取此额度。请妥善保管密钥;你可以随时重新生成密钥,这将立即使旧密钥失效。
首次请求
向 /v1/chat/completions 发送 POST 请求。使用模型 ID uncensored。API 接受文本输入并返回文本输出,非常适合对视觉管道数据进行后处理。你可以包含系统提示词来定义行为,例如指示模型从 OCR 结果中提取结构化数据,或在没有内容过滤器干扰创意或成人用例的情况下描述图像内容。
curl https://api.visionllmapi.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."}]
}'
响应将在 choices[0].message.content 字段中包含生成的文本。如果模型因涉及未成年人的性内容硬性限制而拒绝回答,你将收到错误或空内容,具体取决于拒绝处理方式。
Python SDK
使用官方 OpenAI Python SDK 轻松集成。将 base_url 和 api_key 变量设置为指向我们的服务。此方法适用于任何 OpenAI 兼容客户端库。SDK 处理 JSON 序列化和反序列化,但你需要负责在应用程序逻辑中处理响应结构。
from openai import OpenAI
client = OpenAI(base_url="https://api.visionllmapi.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 SDK
对于 JavaScript 环境,请使用 OpenAI Node.js SDK。配置 baseURL 和 apiKey 以匹配我们的 API 接口。这允许你将无审查文本引擎直接集成到你的 Web 或服务器端 Node.js 应用程序中。对于已经使用 OpenAI 服务的开发人员,SDK 提供了熟悉的接口。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.visionllmapi.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);
请适当处理响应数据,因为根据使用的上下文窗口,模型可能会返回大量文本。除了标准 SDK 文档提供的信息外,没有关于重试行为或 JSON 解码的具体保证。
流式响应
通过在请求中设置 stream: true 来启用流式输出。API 返回服务器发送事件 (SSE) 以实现实时 token 交付。这对于希望增量显示结果的视觉管道非常有用。每个事件包含响应的部分块,允许你在生成文本时更新用户界面。
stream = 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)
解析 SSE 流以提取内容 token。这减少了首 token 时间,这对于交互式应用至关重要。请记住,总 token 计数仍会计入你的用量限制。
速率限制与约束
每个 API 密钥限制为每分钟 300 个请求。最大请求体大小为 8 MB。如果超出速率限制,你将收到 429 错误。如果账户没有额度,你将收到 402 错误。如果密钥无效,你将收到 401 错误。上下文窗口支持最多 100,000 个 token 的提示词和补全内容组合。此大上下文窗口确保你的视觉到文本逻辑不会受到 token 限制瓶颈。没有 SLA 保证,也不提供 SOC2 或 HIPAA 认证。该模型针对合法的成人用途进行了调整,但会屏蔽涉及未成年人的性内容。
问答
这是多模态 API 吗?
不是。这是一个纯文本 API。它不直接接受图像、音频或视频。你必须先将视觉数据转换为文本,然后将文本发送到此 API 进行后处理、提取或生成。
价格如何计算?
价格采用预付额度的按量付费模式。输入 token 价格为每 1M 个 token $0.15,输出 token 价格为每 1M 个 token $0.50。额度永不过期,且无月度订阅费。
上下文窗口大小是多少?
上下文窗口为 100,000 个 token,涵盖输入提示词和生成的补全内容。这允许在单个请求中处理大型文档或广泛的视觉管道数据。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改 base URL。这就是全部设置。
Base URLhttps://api.visionllmapi.com/v1
API 技术参数
购买额度前,请先确认接口是否满足你的需求——以下是全部真实参数。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| Base URL | https://api.visionllmapi.com/v1 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 模型 ID | uncensored |
| 认证 | Authorization: Bearer YOUR_KEY |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 请求大小 | 每次请求不超过 8 MB |
| 并发 | 每个密钥同时最多 8 个请求 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 充值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整数金额 |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10%,满 $200 送 15% |
| 价格 | 输入 $0.15 / 百万 tokens · 输出 $0.50 / 百万 tokens |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
| 登录 | Google 或邮箱 + 密码 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
错误代码
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| HTTP | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |