快速开始

本文档提供 XKU 平台 API 的快速接入指南，帮助您快速了解支持的接口类型并开始使用。

接口类型总览

接口类型	路径	说明
对话补全	/v1/chat/completions	OpenAI 兼容
对话补全	/v1/responses	OpenAI 兼容
Gemini 对话	/v1beta/models/{model}:generateContent	Gemini 原生
Claude 对话	/v1/messages	Anthropic 兼容

环境准备

BaseURL 地址

XKU API 的基础地址为：

https://api-ai.xku.com/v1

只需将 base_url 替换为平台地址，即可无缝使用。

1. 获取 API Key

登录 XKU 控制台，进入 API Key 管理页面创建新的 API Key。

2. 安装开发工具

推荐使用 curl 或 HTTP 客户端（如 Postman、Apifox）进行接口测试。

3. 配置认证

所有接口需要在请求头中携带 API Key：

-H "Authorization: Bearer YOUR_API_KEY"

接口示例

对话补全（OpenAI 兼容）

/v1/chat/completions：

curl -X POST https://api-ai.xku.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v3.2-exp",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

/v1/responses：

curl -X POST https://api-ai.xku.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "input": [
      {
        "role": "user",
        "content": "介绍一下 Python"
      }
    ]
  }'

Claude 对话（Anthropic 兼容）

curl -X POST https://api-ai.xku.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model": "claude-opus-4-5-20251101",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

Gemini 对话（Gemini 原生）

curl -X POST https://api-ai.xku.com/v1beta/models/gemini-3.1-pro-preview:generateContent \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          { "text": "你好" }
        ]
      }
    ]
  }'

下一步

• 查看大语言模块文档了解更多接口详情
• 查看集成工具配置了解如何在 IDE 中使用
• 查看图片生成教程了解图片生成 API