📖 API 使用指南

🔑 基础信息

• Base URL：https://api.xytools.qzz.io/
• 认证方式：在请求头中携带 Authorization: Bearer YOUR_API_KEY
• 请求格式：JSON（Content-Type: application/json）
• 响应格式：JSON

🧠 模型列表

您可以通过 模型广场 查看所有可用模型及其 ID。

📤 发起对话（Chat Completions）

端点：POST /v1/chat/completions

请求示例（cURL）

curl https://api.xytools.qzz.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4-turbo",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "介绍一下咸鱼API"}
    ],
    "temperature": 0.7
  }'

请求参数说明

• model（必填）：模型 ID，如 gpt-4-turbo、claude-3-opus 等。
• messages（必填）：对话消息列表，包含 role（system/user/assistant）和 content。
• temperature（可选）：0~2 之间的浮点数，控制随机性。
• max_tokens（可选）：生成的最大 token 数。
• 其他参数参考 OpenAI 官方文档。

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677654321,
  "model": "gpt-4-turbo",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "咸鱼API是一个聚合多款AI模型的中转服务..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 30,
    "total_tokens": 50
  }
}

🛠️ 其他端点

• GET /v1/models – 获取可用模型列表（兼容 OpenAI）
• 更多功能持续开发中...

📦 SDK 示例（Python）

import openai

openai.api_base = "https://api.xytools.qzz.io/v1"
openai.api_key = "YOUR_API_KEY"

response = openai.ChatCompletion.create(
    model="gpt-4-turbo",
    messages=[
        {"role": "user", "content": "你好！"}
    ]
)
print(response.choices[0].message.content)

📞 支持

如有问题，请联系我们的技术支持，或查看 常见问题。