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 站现行条款为准。