deCloud

中文 · English

deCloud

一个 API Key 调用全球顶级 AI 模型
_{One API key to every frontier AI model}

接入多家模型,通常绕不开这几件事:每接一家就多一把 Key、换个模型就要重测、账单散在几个后台、出错了看不出是哪一层的问题。deCloud 把这些收在中间一层里:

• 一个 Key 覆盖七类模型 _{不用逐家开户、逐家管 Key}
• 接入只写一次 _{换模型不用改代码}
• 客户端不用换 _{Claude Code、Codex、Cursor、Cherry Studio 能改地址就能接}
• 上游逐个标注 _{每个模型的来源在模型页看得见}
• 失败不计费 _{上游出错导致的失败不扣余额,用量可导出}
• 报错有据可查 _{每个状态码一页文档,中英文都有}

能用哪些模型 _{打开模型页}

1. 连接即登录 _{不用注册、不用邮箱;MetaMask / OKX Wallet / TokenPocket / imToken 都能用,签名不转账、不花手续费}
2. 充值 _{充一次余额,按 token 用量扣:计费说明}
3. 创建 API Key _{在控制台创建一把属于自己的,以 dcld-sk- 开头}
4. 填进工具 _{只改两处:地址和 Key}

client = OpenAI(
    base_url="https://macdecloud.com/v1",   # 地址
    api_key="dcld-sk-...",                  # Key
)

_{先设好 Key:export DECLOUD_API_KEY='dcld-sk-...'}

export DECLOUD_API_KEY='dcld-sk-...'

curl https://macdecloud.com/v1/chat/completions \
  -H "Authorization: Bearer $DECLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek/deepseek-chat",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}' 

_{先装依赖(装一次就行):下面的代码用 OpenAI 官方 SDK 发请求,Python 用 pip 装。}

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://macdecloud.com/v1",
    api_key=os.environ["DECLOUD_API_KEY"],
)
r = client.chat.completions.create(
    model="deepseek/deepseek-chat",
    messages=[{"role": "user", "content": "Hello"}],
)
print(r.choices[0].message.content)

_{先装依赖(装一次就行):下面的代码用 OpenAI 官方 SDK 发请求,Node.js 用 npm 装。}

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://macdecloud.com/v1",
  apiKey: process.env.DECLOUD_API_KEY,
});
const r = await client.chat.completions.create({
  model: "deepseek/deepseek-chat",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);

请求体里加 "stream": true:

curl https://macdecloud.com/v1/chat/completions \
  -H "Authorization: Bearer $DECLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "deepseek/deepseek-chat",
  "stream": true,
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}' 

_{两个都要先在控制台建模型别名(API Keys → Model aliases),映射到支持工具调用的模型;别用 opus/sonnet/haiku 这类保留短名,或直接把模型字段写成真实模型 ID。}

export ANTHROPIC_BASE_URL='https://macdecloud.com'
export ANTHROPIC_AUTH_TOKEN='dcld-sk-...'
export ANTHROPIC_MODEL='decloud-coder'
claude

_{必须用 ANTHROPIC_AUTH_TOKEN(按 Bearer 发送):换成 ANTHROPIC_API_KEY(客户端会发 x-api-key)会 401。}

配置写进 ~/.codex/config.toml:

# ~/.codex/config.toml
model = "decloud-codex"
model_provider = "decloud"

[model_providers.decloud]
name = "deCloud"
base_url = "https://macdecloud.com/v1"
env_key = "DECLOUD_API_KEY"
wire_api = "responses"

然后:

export DECLOUD_API_KEY='dcld-sk-...'
codex

更多接法(Cursor · opencode · Cherry Studio · 工具调用 · 模型名怎么写)见 文档 · 客户端 与 quickstart。

3 分钟 —— 从连接钱包到第一次调用,完整走一遍。

deCloud 是一个 AI 模型接入层。一个 API Key 覆盖对话、图像、视频、语音、转写、嵌入、重排七类模型;对外统一 OpenAI 兼容协议,另提供 Anthropic Messages 与 OpenAI Responses 两个端点,原有代码只改「地址 + Key」两处。目录同时收录直连厂商与聚合目录来源,每个模型的上游在模型页逐个标注。按 token 计费,输入输出分列;上游出错导致的失败不扣余额;可申请免费额度。

• Telegram 客服 _{接入排障、用量答疑}
• GitHub Issue _{报错、建议、文档问题}