快速入門:為你的視覺 API 管線使用文字 API
使用標準 OpenAI 相容介面,將我們的無審查文字引擎整合至你的視覺管線。本指南涵蓋驗證、聊天補全、串流輸出以及處理高上下文視覺資料的限制。
- 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 金鑰頁面點擊一次即可領取此額度。妥善保管你的金鑰;你可以隨時重新產生金鑰,這會立即使先前的金鑰失效。
首次請求
發送 POST 請求至 /v1/chat/completions。使用模型 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 端點。這允許你將無審查文字引擎直接整合至你的網頁或伺服器端 Node.js 應用程式。SDK 為已使用 OpenAI 服務的開發人員提供熟悉的介面。
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 產生時間(TTFT),對互動式應用程式至關重要。請注意,總 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 | 模型忙碌——幾秒後重試 |