Acestep 管線快速入門

先決條件：取得 API 金鑰

發出請求前，你需要有效的 API 金鑰。前往 acestep.cc 的 取得 API 金鑰 頁面。你可以使用 使用 Google 繼續 註冊，或建立電子郵件與密碼帳號。不需要手機號碼。註冊後，你的 API 金鑰會立即顯示。複製此金鑰；你將用它來驗證所有後續請求。如果你沒有額度，你需要儲值。我們僅接受加密貨幣付款（TRC20 上的 USDT 或 Base 上的 USDC），金額介於 $10 到 $500 之間。新帳號會獲得 $0.50 的免費試用額度，有效期為 7 天，無需信用卡即可開始。妥善保管你的金鑰，因為它用於驗證你的用量以計算速率限制和 token 消耗。

安裝

API 使用標準的 OpenAI 相容協定。你可以使用官方 OpenAI SDK（支援你偏好的語言）或任何 HTTP 用戶端來與之互動。對於 Python，請安裝 openai 套件。對於 Node.js，請安裝 openai。請確保你使用的是支援自訂基礎 URL 的 SDK 最新版本。我們服務的基礎 URL 為 https://api.acestep.cc/v1。這使得你只需更換基礎 URL 和 API 金鑰，即可重複使用預期 OpenAI 端點的現有管線程式碼。你在請求中必須指定的模型 ID 為 uncensored。該模型是一個開放權重 LLM，針對合法成人、虛構或具爭議性主題的最小拒絕進行了微調，使其成為內容過濾器可能會阻止有效創意輸出的創意管線的理想選擇。

基本請求：生成文字

發送 POST 請求至 /v1/chat/completions，並附上你的系統提示詞和使用者訊息。模型將返回生成的文本。確保你將 model 參數設為 uncensored。你可以透過 temperature 和 top_p 控制創造力。上下文視窗總共支援高達 100,000 個 token（提示詞 + 補全內容）。每次請求的最大輸出為 32,000 個 token，若未指定 max_tokens 則為 2,048 個 token。錯誤和拒絕不會消耗額度，但成功的 token 生成會消耗額度。使用此端點生成腳本、標題，或在將文本數據傳遞給其他模態（如語音或圖像生成 API）之前處理文本數據。

串流輸出回應

對於即時更新，請在請求中設定stream: true。API 會傳回 Server-Sent Events (SSE)。每個區塊包含部分文字。token 使用詳情會在串流的最後一個區塊中提供。這對於在生成時顯示文字的應用程式很有用，可改善使用者的感知延遲。確保您的客戶端正確處理 SSE。串流允許您在 token 到達時處理它們，這對於管線中的長篇內容生成很有益。請記住，串流不會改變定價或 token 限制；您仍會為生成的總 token 付費。

函式呼叫

API 支援函式呼叫，允許模型根據你定義的工具輸出結構化數據。在 tools 參數中定義你的函式。將 tool_choice 設為 auto 或特定的函式名稱。如果合適，模型將回應一個函式呼叫物件。這對於從文本中提取結構化數據或為下游 API 呼叫準備輸入非常有用。你也可以透過將 response_format 設為 {"type": "json_object"} 來強制輸出 JSON。這確保模型返回有效的 JSON，對於將結果可靠地整合至你的自動化管線至關重要。使用這些功能來增強文本處理步驟的可靠性。

定價與限制

價格為每 1M 輸入 token $0.25，每 1M 輸出 token $1.00。額度為預付額度且永不過期。錯誤免費。速率限制為每金鑰每分鐘 300 次請求，以及每金鑰同時 8 個並行請求。最大請求主體大小為 8 MB。如果你超過速率限制，會收到 429 錯誤。401 錯誤表示金鑰無效或已過期。402 錯誤表示額度不足。額度不予退款；爭議透過支援頁面處理。每個帳號只允許一個有效金鑰；產生新金鑰會取代舊金鑰。設計管線的重試邏輯時，請記住這些限制。

cURL

Copycurl https://api.acestep.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

串流輸出

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)