基础知识

1️⃣ 令牌（Token）

• 别称：密钥、key、token
• 用途：身份验证核心凭证，关联用户账户信息等
• 用户可自主管理令牌，支持以下操作：
  • ✅ 新增多个令牌
  • ✅ 设置单令牌额度上限
  • ✅ 指定调用渠道分组（如官方渠道、default）
  • ✅ 绑定调用模型权限

📖 示例格式（非真实 token）：

sk-UEE3xe6AgDeAvlCUQsP0hJSdyaOsNpByoMtb99CC8POogslU

💻 管理入口：令牌管理 — https://api.duyahub.com/console/token

❓ 用户高频疑问解密

Q：如何获取 OpenAI Key？如何获取 Claude Key？如何获取 Gemini Key？

• A：Key 就是令牌！这个 key 可以使用站内支持模型页面介绍的所有模型，GPT 系列、Claude 系列、Gemini 系列等。

Q：key 为什么不能用？为什么我调用 API 没反应？

• A：大部分情况是 Base URL 设置不正确。需要把 OpenAI 的 Base URL 改成 https://api.duyahub.com。

Q：单个 key 的并发或 RPM、TPM 有限制吗？

• A：渡鸦 AI 不会主动限制用户 RPM、TPM，但所有模型账号均为用户共享，使用高峰可能出现 429 或 500 报错。有高并发需求可联系客服咨询。

---

📖 API 地址（Base URL）

• 作用：中转网址，用于替换官方 API 地址
• 替换规则：官方地址 https://api.openai.com 需替换为渡鸦 API 地址 https://api.duyahub.com
• 所有地址数据互通

🔌 完整功能接口映射表

功能	路径	完整示例 URL
智能对话	/v1/chat/completions	https://api.duyahub.com/v1/chat/completions
文本嵌入	/v1/embeddings	https://api.duyahub.com/v1/embeddings
AI 绘图	/v1/images/generations	https://api.duyahub.com/v1/images/generations
语音转文本	/v1/audio/transcriptions	https://api.duyahub.com/v1/audio/transcriptions
文本转语音	/v1/audio/speech	https://api.duyahub.com/v1/audio/speech

💡 注意：在 Claude Code 里只需要配置域名，不需要带 /v1 及后面的部分。

Python 示例

需要先安装 OpenAI SDK：

pip install openai

import openai

# 配置 API 密钥和基础 URL
openai.api_key = "sk-******"  # 替换为你的实际令牌
openai.api_base = "https://api.duyahub.com"  # 设置中转地址

# 调用对话接口示例
response = openai.ChatCompletion.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

curl 示例

curl --request POST \
  --url https://api.duyahub.com/v1/chat/completions \
  --header 'Authorization: Bearer sk-替换为你的key' \
  -H "Content-Type: application/json" \
  --data '{
    "max_tokens": 8192,
    "model": "gpt-5-mini",
    "temperature": 0.8,
    "top_p": 1,
    "presence_penalty": 1,
    "messages": [
      {
        "role": "system",
        "content": "你是我的全能助手，你叫小美"
      },
      {
        "role": "user",
        "content": "你是谁？夸我几句我就给你续费~"
      }
    ]
  }'