Dolphin ai 故障排除：常見的 API 整合錯誤

假設 '無審查' 意味著 '完全沒有過濾'

無審查不等於模型沒有界限。它特指模型不會拒絕標準模型可能會阻擋的合法成人、爭議性或創意主題。我們的無審查LLM接受任何提示而不進行道德評判，但它仍會執行關於未成年人的硬性內容限制。

例如，如果您請求涉及未成年人的性內容，無論無審查設置如何，API 都會返回拒絕。這是應用於推理層面的硬性規則。所有其他合法的成人內容，包括露骨的小說或細微的辯論，都會無過濾地通過。

混淆上下文視窗與最大輸出令牌

上下文窗口為 100,000 個 token，但每次請求的最大輸出為 16,000 個 token。此區別對於長文件生成至關重要。如果您發送 90k token 的提示詞並要求 30k token，請求會失敗或意外截斷。

• 最大上下文：100,000 個 Token（輸入與輸出合計）。
• 最大輸出：每次請求 16,000 個 token。
• 若 max_tokens 未設定，預設輸出：2,048 個 token。

始終在 API 呼叫中明確設定 max_tokens。這可防止 token 使用失控並確保可預測的計費。超過這些限制的錯誤不會消耗信用額度，但會破壞您的解析邏輯。

忽略非同步環境中的串流回應

我們的 API 支援透過伺服器發送事件（SSE）進行串流傳輸。如果您對長時間生成使用同步客戶端，將會觸發超時限制。非同步環境預期接收的是部分區塊的串流，而非單一龐大的有效載荷。

每個區塊的最後一個有效載荷包含 token 用量數據。這讓您可以追蹤即時成本。如果不使用串流，在大量生成期間，您的 UI 可能會凍結幾秒鐘。使用

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)

封鎖以查看正確的客戶端處理方式。

請求主體中設定了錯誤的模型 ID

許多開發者預設使用 "gpt-3.5-turbo" 或 "gpt-4"。我們的 API 要求模型 ID 必須精確為 "uncensored"。發送任何其他 ID 將導致 404 或模型未找到錯誤。這不是像 GPT 或 Claude 那樣的供應商專屬模型。

這是一款在我們基礎設施上運行的開放權重模型。請確保您的 SDK 設定指向 HTTPS://api.dolphinmodelai.com/v1，並將 "uncensored" 用作模型名稱。這是我們提供的唯一模型。

忘記處理 tool_choice 和函式呼叫格式

支援函式呼叫，但格式必須符合 OpenAI 標準。如果您想要強制使用工具，必須明確指定 tool_choice。API 接受 tools、tool_choice 和標準的訊息格式。

不正確的 tool 定義格式會導致客戶端解析錯誤。請確保您的 JSON 模式有效。模型返回結構化 JSON，您的代碼必須進行解析。使用

Copyimport OpenAI from "openai";

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

區塊作為工具定義的範例。

誤解輸入與輸出定價的差異

輸入 token 每 1M 個收費 $0.15。輸出 token 每 1M 個收費 $0.50。輸出費用是輸入的四倍。此比例為大多數 LLM API 的標準配置，但會顯著影響您的預算。

預付額度根據實際 token 用量計費。錯誤與拒絕請求免費。如果您發送 10k token 的提示並獲得 10k token 的回應，您需為兩者付費。必須使用加密貨幣充值。您可以使用 TRC20 上的 USDT 或 Base 上的 USDC 充值。最低充值金額為 $20。贈送額度適用於 $50 (+5%)、$100 (+10%) 和 $200 (+15%)。

未檢查 JSON 模式的回應格式錯誤

JSON 模式要求您將 response_format 設為 {"type": "json_object"}。否則，模型可能會返回 Markdown 或文字，從而破壞您的解析器。這是整合失敗的常見原因。

確保您的 schema 嚴格。如果 schema 含糊不清，模型無法保證產生完美的 JSON。使用

Copyfrom openai import OpenAI

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

封鎖以查看如何強制輸出 JSON。這可降低後處理開銷。

假設所有 OpenAI SDK 參數運作方式完全相同

溫度、top_p、停止、seed、presence_penalty 和 frequency_penalty 等參數的運作方式類似於 OpenAI。然而，並非所有邊緣案例參數都受支援。我們支援大多數用例所需的核心參數集。

串流、函式呼叫與 JSON 模式完全支援。請查看

Copycurl https://api.dolphinmodelai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run unit tests for the payment module"}]
  }'

基本請求的區塊。避免假設不支援的參數會被優雅地忽略。它們可能會導致錯誤。

忽略 8MB 請求主體限制

最大請求主體大小為 8 MB。如果您發送大型檔案或大量上下文，可能會超過此限制。這是 API 閘道的硬性約束。超過此大小的請求將立即被拒絕。

確保您的資料載體已壓縮或截斷。使用

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)

範例以查看如何高效處理大型上下文。此限制適用於整個請求，包括標頭和主體。