API 文档中心

v1 · OpenAI 兼容

欢迎使用大威天龙 API 中转站！我们提供稳定、高速、易用的大模型 API 接口服务，一份 base_url 即可对接全部可用模型。

基础信息

API 基础地址	`/v1`
请求方法	`POST`
数据格式	`application/json`
字符编码	`UTF-8`
认证方式	Bearer Token（API Key）

认证方式

在请求头中添加以下字段：

http

请求头

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Authorization在个人中心「API 密钥」中创建，所有请求都需在请求头携带。
Content-Type请求体统一使用 JSON 格式，编码 UTF-8。

接口列表

POST/v1/chat/completionsChat Completions

对话补全接口，兼容 OpenAI Chat Completions，支持流式与多模态。

参数	类型	必填	说明
`model`	string	是	模型 ID，见模型列表页
`messages`	array	是	对话消息列表，role ∈ system / user / assistant
`stream`	boolean	否	是否以 SSE 流式返回，默认 false
`temperature`	number	否	采样温度 0~2，默认 1
`max_tokens`	integer	否	生成最大 token 数

POST/v1/completionsCompletions

传统文本补全接口，适用于旧版 prompt 模式。

参数	类型	必填	说明
`model`	string	是	模型 ID
`prompt`	string \| array	是	补全提示词
`stream`	boolean	否	是否流式返回

POST/v1/embeddingsEmbeddings

文本向量接口，用于检索、聚类、语义搜索。

参数	类型	必填	说明
`model`	string	是	向量模型 ID
`input`	string \| array	是	待向量化文本

POST/v1/images/generationsImages Generation

文生图接口，返回可访问的图片 URL 或 base64。

参数	类型	必填	说明
`model`	string	是	图像模型 ID
`prompt`	string	是	图像描述
`size`	string	否	尺寸，如 1024x1024

GET/v1/modelsModels

列出当前账户可用的模型列表。

请求示例

示例：调用 gpt-5.6-luna 模型

bash

请求示例（cURL）

curl /v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      {"role": "system", "content": "你是大威天龙助手。"},
      {"role": "user", "content": "用一句话介绍你自己。"}
    ],
    "stream": false
  }'

响应示例

json

响应示例

{
  "id": "chatcmpl-20260921T000000Z",
  "object": "chat.completion",
  "model": "gpt-5.6-luna",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "我是大威天龙 API 助手，可通过统一接口调用多种主流大模型。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 26,
    "total_tokens": 44
  }
}

可用模型

更多模型与接口参数说明，请查看完整模型列表或访问接入教程。

错误码说明

状态码	含义	解决方案
`400`	请求参数错误	检查 JSON 结构、必填字段与参数类型
`401`	未认证 / API Key 无效	确认 Authorization 头与 sk- 密钥状态
`403`	无权限或已封禁	检查账户状态、IP 白名单与模型权限
`404`	模型或路径不存在	核对模型 ID 与接口路径拼写
`429`	触发限流	降低并发或申请提升速率等级
`500`	服务端错误	稍后重试，如持续出现请联系客服
`503`	通道暂不可用	站点会自动切换线路，建议启用故障转移

最佳实践

流式输出 SSE

对话场景建议 stream=true，按 SSE chunk 解析 data: {…} 行，遇到 [DONE] 结束。

Token 计算

计费以 usage.total_tokens 为准，system 消息与函数声明也计入 prompt。

限流与重试

建议指数退避：首次 1s，之后 ×2，封顶 30s；仅对 429 / 5xx 重试。

密钥安全

sk- 仅在服务端环境变量使用，切勿写入前端或公开仓库；按业务拆分多把密钥。