Voguesly API 接入教程：從註冊到第一條文本請求

2026-10-17 定價更新：請以當前價目頁所選渠道、模型及最終帳單為準；模型例外價優先於分組折扣。舊的 GPT官+AZ 混合、Claude特供分組已停止在本站銷售。本文早於19:56的實測金額是調價前歷史記錄，不是當前固定單次收費。

服務地址：https://api.ylink.uk。本文先完成一條文本請求，再核對用量；其他功能按各自介面文檔使用。準備一個可收郵件的帳號和你自己的本站 API 密鑰。使用代碼示例需Python 3；想用圖形客戶端可直接看第9節Chatbox實測步驟。

1. 註冊或登入

打開 https://api.ylink.uk/sign-up，按頁面填寫用戶名、郵箱、密碼並完成驗證。驗證碼時效、重發間隔及密碼要求以頁面提示為準。已有帳號直接登入，不必重複註冊。

2. 選擇模型並看對應供應商價格

打開模型價目，進入要使用的模型詳情。示例模型名是 claude-sonnet-5-5，輸入時保留完整拼寫。

查看“按供應商定價”，分別確認輸入、輸出及適用的快取等價格。“起始價格”是頁面的起始報價，不能當作所有路由的統一價格。調用完成後，在使用日誌核對實際分組、用量與費用。本文不固定寫入價格數字，避免頁面調價後教程過期。

3. 確認餘額

登入後打開餘額充值。餘額充足可跳過付款；需要充值時，按當前支付頁選擇通道、金額並核對幣種、費用與訂單狀態後自行完成。

完成後刷新錢包，核對訂單成功和餘額變化。待支付訂單不等於已付款；不要只看彙總金額判斷到帳。歷史已有一筆 Waffo US$10成功到帳記錄，不把該樣本當作所有通道的起充門檻或固定到帳時長。退款等條件請在支付前閱讀站內條款。

4. 準備本站密鑰

打開API 密鑰。已有可用密鑰可直接使用；需要新密鑰時由你在頁面創建，並按實際用途設定模型、IP、有效期和配額。

密鑰只填入你信任的客戶端或服務端配置；不要放進公開代碼、截圖、共享文檔或前端網頁。不要把主站或其他站點的密鑰混用到本站。配額字段不能替代錢包餘額，也不代表免費或無限使用。

5. API 地址怎麼填

先確認工具要的是“根地址”“介面前綴”還是“完整請求 URL”。若工具自動補 /v1，填根地址；若要求填寫含 /v1 的前綴，填第二行。不要把完整 /chat/completions 地址誤填到僅要求前綴的欄位，也避免拼出 /v1/v1/…。

Chat Completions介面字段參考可查其他參數。參考頁中的通用示例域名請替換為本站地址，並使用自己的本站密鑰。本文已驗的服務路徑是直接 HTTP；沒有把某個客戶端的配置模板稱為已實測兼容全部模型。

6. 發送第一條請求

下載 first_request.py，或把下方代碼保存為該文件名，在終端運行：

python3 first_request.py

按提示粘貼你自己的 API key。輸入不會顯示；腳本不保存或列印密鑰，只發送一次短文本請求，不自動重試。正常時會輸出 HTTP 狀態、回答與用量。模型可能返回 OK 或其他短文本，以真實響應為準。

完整代碼如下（僅使用Python標準庫）：

#!/usr/bin/env python3
"""One explicit text request; key is read privately and never saved or printed."""
import getpass
import json
import urllib.error
import urllib.request

API_URL = "https://api.ylink.uk/v1/chat/completions"
MODEL = "claude-sonnet-5-5"


class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, *args, **kwargs):
        return None


def main():
    key = getpass.getpass("粘貼本站 API key（輸入不顯示）：").strip()
    if not key:
        raise SystemExit("沒有輸入密鑰，未發送請求。")
    body = {
        "model": MODEL,
        "messages": [{"role": "user", "content": "Reply with the single word: OK"}],
        "max_tokens": 32,
        "stream": False,
    }
    request = urllib.request.Request(
        API_URL,
        data=json.dumps(body).encode("utf-8"),
        headers={"Authorization": "Bearer " + key, "Content-Type": "application/json"},
        method="POST",
    )
    try:
        with urllib.request.build_opener(NoRedirect).open(request, timeout=60) as response:
            data = json.load(response)
            print("HTTP:", response.status)
            print("回答:", data["choices"][0]["message"]["content"])
            print("用量:", data.get("usage", {}))
            print("接下來到本站“使用日誌”核對這筆調用與費用。")
    except urllib.error.HTTPError as error:
        print("HTTP:", error.code, "；請先到使用日誌檢查，不自動重試。")
    except (urllib.error.URLError, TimeoutError):
        print("請求超時或連接失敗；先查使用日誌是否已有記錄，再決定是否重試。")
    finally:
        key = None


if __name__ == "__main__":
    main()

已有成功樣本：2026-10-16，通過同一HTTP端點與模型返回200，輸入30／輸出17 tokens，客戶實扣US$0.000116。該金額只屬於那一條歷史請求，不是本示例或未來請求的固定費用。

7. 核對使用日誌與帳單

打開使用日誌，按發送時間和模型找到剛才的請求，查看耗時、Tokens、費用及詳情。記錄中若有供應商／分組，結合該檔報價核對。

很小的費用在列表可能僅顯示到四位小數，不應把四位顯示當高精度金額；錢包也可能四舍顯示。充值記錄與模型請求需要分開看。月度帳單入口為對帳單，具體統計週期以頁面選擇為準。

8. 報錯時先做這幾項檢查

以上HTTP排查是通用檢查順序，最終以這筆請求的真實錯誤體和日誌為準，不代表已經在本站逐一復現過所有失敗狀態。

聯繫客服時提供：請求時間和時區、模型名、HTTP狀態／錯誤碼、客戶端名稱和版本、脫敏後的錯誤資訊及請求ID（若有）。不要發送完整密鑰、密碼或驗證碼。

9. 圖形客戶端示例：Chatbox（已實測）

實測環境：macOS版 Chatbox 1.9.8，2026-10-17。此示例驗證一條文本流式請求，不代表所有客戶端版本、模型或圖片功能均已通過。

打開左下角 Settings → MODEL → Model Provider → Add Custom Provider，按表填寫：

Host與Path拼合後是 https://api.ylink.uk/v1/chat/completions。Host裡不要重複填寫 /chat/completions，也不要疊加兩次 /v1。這裡選OpenAI兼容協議是按介面格式選擇，並非要求模型必須來自OpenAI。

首次小額測試時，將 Max Message Count in Context 暫設 1；它限制歷史消息數量，不是輸出token上限。進入 CHAT 頁籤，關閉 Auto-Generate Chat Titles，避免額外的自動標題請求，再點 Save。這兩項用於首次對帳，不是日常使用必須永久保留的設定。

點 New Chat 新建空聊天，確認輸入框上方模型為 deepseek-v4-flash-0731，發送一次：

Reply with the single word: OK

本次客戶端返回 OK，並顯示思考內容；客戶端token欄為 unknown，應到本站使用日誌查真實用量。2026-10-17 11:22:05的記錄為輸入129／輸出20，共149 tokens，實際分組Volcengine，客戶最終實扣 US$0.000076。這只是本次樣本，不是固定每次費用；其他內容、上下文、路由和快取會改變金額。打開費用詳情可查對應計費項；錢包顯示 $10 可能因四舍顯示未變化，不能據此判斷免費。

先前錯誤與解決： 自定義 OpenAI 兼容模式調用 Sonnet 5.5 時曾報 temperature is deprecated for this model，一次發送形成4條錯誤記錄，客戶和代理均顯示US$0。現在按下面原生 Claude 配置已跑通；不要據此承諾其他失敗均免費。

Sonnet 5.5：使用原生 Claude API（已跑通）

在 macOS Chatbox 1.9.8 打開 Settings → MODEL → Model Provider → CLAUDE API，這是內置提供商，與上面的自定義 OpenAI 兼容提供商分開配置：

先保存 Host 和密鑰；若模型列表仍舊，關閉並重新打開設定，再從載入的列表選準確型號。保存後點 New Chat，確認輸入框上方是 claude-sonnet-5-5。首次對帳關閉自動標題、歷史消息數暫設1，發送上面的短消息一次。

此版本原生 Claude 提供商自動拼接 /v1/messages，不需要填寫 API Path；它不發送導致本次報錯的 temperature／top_p 參數，無須反覆調整溫度滑塊。不要套用上面 OpenAI 兼容模式的 /v1 Host 填法。

2026-10-17 12:19:39 調價前實測： 返回 OK，本站客戶日誌輸入29／輸出4，共33 tokens，AmazonBedrock，最終實扣 US$0.000050，響應2.0秒。代理日誌同時間、同模型、33 tokens成功，費用欄四位小數顯示US$0.0001；這不是另一筆扣費。客戶端顯示“tokens used:29”，與站上完整輸入／輸出統計不同，查帳以站上費用詳情為準。

19:56:27 更新後實測：同一原生 Claude 配置調用 claude-sonnet-5-5 成功，返回 PRICING_LAUNCH_OK。本次為較長的合成測試輸入：站上輸入1,895／輸出16 tokens，AmazonBedrock，基礎費用 US$0.003950 × 渠道係數0.6，客戶最終實扣 US$0.002370。客戶端自行估算的token數不能代替站上帳單。

這些是特定輸入的計費樣本，不是固定單次費用，也不代表圖片、工具或所有模型均通過。一次手動發送仍可能產生上游路由失敗記錄；遇到錯誤先查使用日誌，不要連續重發。

使用範圍

本教程覆蓋文本接入；模型目錄、第三方客戶端、圖片／音影片等功能需分別評估。共享資源不承諾固定可用率。按當前頁面說明使用，不以本文歷史樣本代替實時價格或服務承諾。

10. Claude Desktop、Claude Code 與 Codex

請看 CC Switch 完整圖文教程，含 SVG 接入圖與實機截圖。Claude Desktop / Cowork 已實測；Claude Code 關閉實驗 beta 後短文本已成功，後續複測仍有上游通道/權限失敗；Codex CLI/App 已通過 GPT-5.6 Terra 短文本並核對本站扣費；Codex CLI 的 none 模式兩輪真實工具／文件／編碼已通過；App 工具與帶推理的密文續接仍未通過，詳見第5節。

前往 API 站註冊／使用 · 查看當前分檔價格

API 服務與住宅 IP 套餐分別計費。網絡排查見 連接自測；本頁不承諾共享通道 SLA、零保留或退款保證。具體使用與退款條件以 API 站現行條款為準。