UnlimitDS
DEVELOPER GUIDE

API 接入教程

使用账户面板生成的密钥,通过一种统一额度连接常用 SDK。

快速开始

  1. 登录网页并打开“账户与用量”。
  2. 在 API Key 区域创建密钥,完整值仅显示一次。
  3. 将 Base URL 设置为 https://unlimitds.chat/v1

Claude Code / Codex

本站优先适配两类终端开发代理。先在账户面板创建 API Key,再按对应方式配置。

Claude Code

Anthropic 兼容入口使用站点根地址。将以下变量写入终端环境后启动 Claude Code。

export ANTHROPIC_BASE_URL="https://unlimitds.chat"
export ANTHROPIC_AUTH_TOKEN="uds_YOUR_KEY"
export ANTHROPIC_MODEL="deepseek-v4-pro"

claude

Codex CLI

按照 OpenAI 官方 Codex 自定义模型提供方格式,在用户级 ~/.codex/config.toml 中添加:

model = "deepseek-v4-pro"
model_provider = "unlimitds"

[model_providers.unlimitds]
name = "UnlimitDS"
base_url = "https://unlimitds.chat/v1"
env_key = "UNLIMITDS_API_KEY"
wire_api = "responses"
export UNLIMITDS_API_KEY="uds_YOUR_KEY"
codex

配置字段依据 OpenAI 官方 Codex 文档

OpenAI 格式

curl https://unlimitds.chat/v1/chat/completions \
  -H "Authorization: Bearer uds_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"你好"}],"stream":true}'
from openai import OpenAI

client = OpenAI(api_key="uds_YOUR_KEY", base_url="https://unlimitds.chat/v1")
result = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}]
)

Anthropic 格式

curl https://unlimitds.chat/v1/messages \
  -H "x-api-key: uds_YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"deepseek-v4-flash","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'

图片理解

选择名称包含 vision 的模型,并按 OpenAI 多模态消息格式传入公开图片 URL 或 Base64 Data URL。

{"role":"user","content":[
  {"type":"text","text":"描述这张图片"},
  {"type":"image_url","image_url":{"url":"data:image/jpeg;base64,..."}}
]}

模式选择

默认使用标准模式。请求头加入 X-Unlimit-Mode: jailbreak 可选择破甲模式;服务端负责模式配置,请求正文保持常规消息结构。

额度与错误

网页账户面板以百分比显示周/月使用进度。所有网页请求、OpenAI 格式请求和 Anthropic 格式请求共用套餐额度。

401密钥失效429周期额度用完502上游暂时异常