几分钟接入 GuDog API

鉴权方式

OpenAI 兼容接口使用 Bearer Token。请在控制台创建令牌，并通过请求头发送：

Authorization: Bearer sk-your-api-key
Content-Type: application/json

下文中的 sk-your-api-key 均为占位符，请替换为你自己的令牌。不要把真实密钥提交到 Git 仓库或前端代码。

获取模型列表

先查询当前令牌可用的模型，再把返回结果中的 id 用于后续请求。

curl https://ai.yuanown.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

Chat Completions

适用于支持 OpenAI Chat Completions 协议的模型与客户端。

curl https://ai.yuanown.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "用一句话介绍武汉。"}
    ],
    "stream": false
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://ai.yuanown.com/v1",
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[
        {"role": "user", "content": "用一句话介绍武汉。"}
    ],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://ai.yuanown.com/v1",
});

const response = await client.chat.completions.create({
  model: "your-model-id",
  messages: [
    { role: "user", content: "用一句话介绍武汉。" },
  ],
});

console.log(response.choices[0].message.content);

流式响应

将 stream 设置为 true，服务端会以 SSE 逐段返回内容。

stream = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "写一首短诗。"}],
    stream=True,
)

for chunk in stream:
    text = chunk.choices[0].delta.content
    if text:
        print(text, end="", flush=True)

Responses API

部分模型支持 OpenAI Responses 协议。是否可用取决于具体模型与渠道；如果返回接口不支持，请改用 Chat Completions。

curl https://ai.yuanown.com/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "input": "解释什么是 API 网关。"
  }'

Anthropic Messages

Claude 模型在渠道支持时可使用 Anthropic 原生 Messages 接口。鉴权头与 OpenAI 协议不同：

curl https://ai.yuanown.com/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-claude-model-id",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好，请介绍一下自己。"}
    ]
  }'

常用客户端配置

备用域名

三个入口指向同一服务。正常情况下优先使用主域名；主域名网络异常时再切换备用入口。

错误排查

安全建议

• API Key 只保存在服务端环境变量或密钥管理服务中。
• 为不同应用创建独立令牌，并设置合理额度与权限。
• 日志中隐藏完整令牌，公开报错时仅保留首尾少量字符。
• 怀疑泄露时立即禁用旧令牌并创建新令牌。

关于 GuDog API

GuDog API 是武汉元自互联网科技有限公司推出的 AI API 服务聚合平台，面向国内开发者、技术团队与企业用户，提供统一、便捷的大模型接口接入能力。

平台定位

GuDog API 将多种 AI 模型能力汇聚到统一入口，为应用开发、自动化工作流和团队协作提供一致的调用方式。兼容 OpenAI 标准格式的 SDK 与工具通常只需替换 Base URL、API Key 和模型名称即可接入。

平台提供渠道、令牌、模型权限、用量与调用日志等管理能力，帮助用户减少重复适配不同接口协议的工作，将更多精力投入产品开发与业务创新。

适用场景

• 个人开发者：快速验证模型能力，为脚本、机器人和个人项目接入 AI。
• 创业与研发团队：减少多供应商接口适配成本，专注产品和业务逻辑。
• 企业内部工具：为团队提供统一入口，并集中管理令牌、模型权限和用量。
• AI 应用开发：支持聊天助手、内容生成、代码辅助及工作流自动化等场景。

服务与责任

平台重视服务安全与用户隐私，并持续完善访问控制、运行监测和风险管理措施。用户在调用服务时，也应遵守适用的法律法规、平台规则及相关模型服务条款，不得将接口用于违法违规用途。