跳转到主要内容
BYOK 允许你使用自己的提供商 API 密钥，通过 Dedalus 发送请求。请求仍然会经过我们的统一应用程序编程接口 API（路由、工具调用、流式传输、格式规范化），但底层的大语言模型（LLM）调用会由提供商按你的账户计费。

​
何时使用 BYOK

  • 你已经和某个提供商协商好了定价或额度。
  • 你想使用我们的共享密钥尚不支持的模型层级或地区。
  • 你的合规政策要求 API 密钥必须由你自行掌控。

​
快速开始

在正常使用 Dedalus API 密钥的同时，再额外传入三个请求头（或 SDK 选项）：
HeaderSDK optionDescription
X-ProviderproviderProvider 名称（openai、anthropic、google 等）
X-Provider-Keyprovider_key该 provider 对应的 API 密钥
X-Provider-Modelprovider_model在该 provider 上的模型标识符（可选）
只有 X-Provider-Key 是必需的。如果省略 X-Provider，则会根据模型名称进行推断。如果省略 X-Provider-Model，则使用请求体中的模型。

​
示例

​
curl

curl https://api.dedaluslabs.ai/v1/chat/completions \
  -H "Authorization: Bearer $DEDALUS_API_KEY" \
  -H "X-Provider: openai" \
  -H "X-Provider-Key: $OPENAI_API_KEY" \
  -H "X-Provider-Model: gpt-4o" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

​
Python 软件开发工具包（SDK）

from dedalus_labs import AsyncDedalus

client = AsyncDedalus(
    provider="openai",
    provider_key="sk-your-openai-key",
    provider_model="gpt-4o",
)

response = await client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Hello"}],
)

​
TypeScript 软件开发工具包（SDK）

import Dedalus from "dedalus-labs";

const client = new Dedalus({
	provider: "openai",
	providerKey: "sk-your-openai-key",
	providerModel: "gpt-4o",
});

const response = await client.chat.completions.create({
	model: "openai/gpt-4o",
	messages: [{ role: "user", content: "Hello" }],
});

​
环境变量

你也可以通过环境变量来设置 BYOK 选项，而不是在代码中显式传入这些选项： 
export DEDALUS_PROVIDER="anthropic"
export DEDALUS_PROVIDER_KEY="sk-ant-your-key"
export DEDALUS_PROVIDER_MODEL="claude-sonnet-4-5-20250929"
软件开发工具包（SDK）会自动识别这些内容，无需修改任何代码。

​
按请求覆盖

SDK 选项会为每个请求设置默认值。你也可以通过直接设置请求头，为单个请求覆盖这些默认值： 
response = await client.chat.completions.create(
    model="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Hello"}],
    extra_headers={
        "X-Provider": "google",
        "X-Provider-Key": "your-google-key",
    },
)

​
支持的服务提供商

我们模型列表中的任意服务提供商都可以与 BYOK 搭配使用：

OpenAI

openai

Anthropic

anthropic

Google

google

xAI

xai

Mistral

mistral

DeepSeek

deepseek

Groq

groq

Cohere

cohere

Perplexity

perplexity

Cerebras

cerebras

Together AI

together_ai

Fireworks AI

fireworks_ai

Moonshot

moonshot

​
工作原理

你的请求仍然通过 Dedalus 处理。我们负责路由、格式归一化、流式传输和工具调用。唯一的区别在于，上游 LLM 调用所使用的 API 密钥不同。 
You → Dedalus API (your Dedalus key) → Provider (your provider key) → Response → You
BYOK 密钥通过 HTTPS 发送，且绝不会被存储。它们仅在请求执行期间使用，用完即被丢弃。如果您需要由 Dedalus 代为管理密钥，请通过 support@dedaluslabs.ai 与我们联系。

​
错误处理

场景系统行为
Provider 名称无效返回 HTTP 400，并包含受支持的 provider 列表
缺少或无效的 provider keyProvider 返回其自身的认证错误（通常为 401）
该 provider 上不存在该模型Provider 返回其自身的模型错误（通常为 404）
错误响应始终会包含上游 provider 的错误信息，便于你直接排查问题。
Last modified on February 28, 2026