词元文档 官方网站
开发者文档 / API Reference

用 词元
统一接入 AI 模型

词元提供兼容 OpenAI 风格的统一 API 接口。官方网站为 api.pddshop.cc，你可以使用同一套调用方式接入不同模型，完成聊天、文本生成、应用开发与自动化任务。

立即接入 查看接口示例
官方地址api.pddshop.cc
兼容接口低成本迁移现有项目
统一密钥一个 Key 管理多模型调用
示例请求cURL
curl https://api.pddshop.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，词元"}
    ]
  }'

平台概览

词元是一个统一 AI 接口服务平台，用于降低多模型接入、密钥管理、调用统计和模型切换的复杂度。官方网站和控制台入口为 https://api.pddshop.cc，API Base URL 为 https://api.pddshop.cc/v1。

统一调用入口通过统一 Base URL 调用不同模型，减少重复开发。
兼容 OpenAI 风格大部分现有项目只需要替换 Base URL 与 API Key。
模型灵活切换根据速度、价格、质量选择合适模型。
用量透明可查在控制台查看调用日志、Token 消耗和余额变化。

快速开始

完成下面 4 步，即可在你的项目中接入词元。

步骤说明
1. 注册账号访问 https://api.pddshop.cc，创建你的账号。
2. 生成 API Key在控制台创建密钥，并妥善保存。
3. 替换接口地址将原项目中的 Base URL 替换为 https://api.pddshop.cc/v1。
4. 发起请求使用模型名称、消息数组和密钥发起 API 请求。
安全提醒：API Key 等同于账户调用凭证，不要写入前端代码、公开仓库或截图中。

接口地址

所有 API 请求都应以官方 Base URL 开头。

https://api.pddshop.cc/v1

常见路径

接口路径用途
聊天补全/v1/chat/completions对话、文本生成、智能问答、工具调用工作流。
模型列表/v1/models查看当前可用模型。

API Key 鉴权

所有受保护的请求都需要在 Header 中携带 API Key。

HeaderAuthorization
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

密钥建议

建议原因
不同项目使用不同 Key方便统计、隔离和停用。
不要放在浏览器前端避免被用户直接查看和盗用。
定期检查调用记录及时发现异常消耗。

聊天补全接口

聊天补全接口适合构建 AI 助手、问答系统、内容生成、代码辅助和自动化工作流。

POST /v1/chat/completions

请求示例

cURLchat/completions
curl https://api.pddshop.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个高效的助手。"},
      {"role": "user", "content": "用一句话介绍词元。"}
    ],
    "temperature": 0.7
  }'

JavaScript 示例

JavaScriptfetch
const response = await fetch("https://api.pddshop.cc/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-4o",
    messages: [
      { role: "user", content: "你好，词元" }
    ]
  })
});

const data = await response.json();
console.log(data);

Python 示例

Pythonrequests
import requests

url = "https://api.pddshop.cc/v1/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "model": "gpt-4o",
    "messages": [
        {"role": "user", "content": "你好，词元"}
    ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

请求参数

聊天补全接口使用 JSON 请求体。下面是最常用的参数。

字段类型是否必填说明
modelstring是模型名称，例如 gpt-4o。可通过模型列表接口查看可用值。
messagesarray是对话消息数组，支持 system、user、assistant 等角色。
temperaturenumber否控制输出随机性。值越低越稳定，值越高越发散。
top_pnumber否核采样参数，通常与 temperature 二选一调整即可。
max_tokensnumber否限制单次响应最多生成的 token 数。
streamboolean否设为 true 时启用流式输出。

响应格式

非流式请求会返回完整 JSON。业务代码通常读取 choices[0].message.content。

JSONresponse
{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "词元是一个统一 AI 接口服务平台。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 24,
    "completion_tokens": 18,
    "total_tokens": 42
  }
}

流式输出

需要边生成边展示时，将 stream 设置为 true。服务端会以 SSE 形式逐段返回内容。

cURLstream
curl https://api.pddshop.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "messages": [
      {"role": "user", "content": "写一段简短欢迎语"}
    ]
  }'
流式响应结束时通常会返回 data: [DONE]。客户端需要按行解析 SSE 数据。

SDK 迁移

如果你的项目已经使用 OpenAI SDK，通常只需要替换 baseURL / base_url 与 API Key。

Node.jsopenai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CIYUAN_API_KEY,
  baseURL: "https://api.pddshop.cc/v1"
});

const completion = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "你好" }
  ]
});
Pythonopenai
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["CIYUAN_API_KEY"],
    base_url="https://api.pddshop.cc/v1",
)

completion = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "你好"}
    ],
)

模型列表

你可以通过模型列表接口或控制台查看当前可用模型。不同模型在速度、价格、上下文长度和能力上可能不同。

cURLmodels
curl https://api.pddshop.cc/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
模型类型适合场景建议
通用对话模型问答、写作、总结、日常助手适合大多数场景。
高推理模型复杂分析、代码、数学、长链路任务适合高质量输出，但成本通常更高。
轻量快速模型分类、改写、简单客服、批量处理适合低成本高并发。

错误码说明

状态码可能原因处理方式
400请求参数错误检查 JSON 格式、模型名称和 messages 结构。
401鉴权失败检查 API Key 是否正确、是否带有 Bearer 前缀。
403权限不足检查密钥权限或账户状态。
404路径或模型不存在确认接口路径和模型名称是否正确。
429请求过快或额度不足降低并发、检查余额或限流设置。
500服务异常稍后重试，或切换其他模型。
502 / 503上游模型暂不可用使用重试、降级模型或排队策略。

最佳实践

服务端转发请求不要把 API Key 暴露在前端页面中。
设置合理超时避免单次请求长时间阻塞业务流程。
记录请求日志便于排查异常、追踪成本和优化提示词。
按场景选择模型简单任务使用轻量模型，复杂任务使用高质量模型。
加入重试退避对 429、502、503 使用指数退避，避免瞬时失败影响业务。
保存请求 ID排障时保留时间、模型、状态码和响应摘要。

About

词元文档面向需要快速接入 AI 能力的开发者和团队，核心目标是用统一入口降低多模型调用、鉴权、日志和成本管理的接入复杂度。

官方网站https://api.pddshop.cc
API Base URLhttps://api.pddshop.cc/v1
接口风格OpenAI-compatible JSON API
适用场景AI 助手、客服问答、文本生成、摘要、改写、代码辅助和自动化工作流。

常见问题

词元是否兼容 OpenAI SDK？

如果你的项目支持自定义 Base URL，通常只需要把接口地址改为 https://api.pddshop.cc/v1 并替换 API Key 即可接入。

API Key 可以放在前端吗？

不建议。前端代码会被用户看到，API Key 应放在服务端，由服务端向词元发起请求。

如何查看调用消耗？

访问 https://api.pddshop.cc 进入控制台，查看调用日志、Token 消耗、余额和模型使用情况。

模型调用失败怎么办？

先检查 API Key、余额、模型名称和请求格式，再根据错误码定位问题。