OpenAI compatible 协议

使用 /v1 Base URL 接入 OpenAI compatible 客户端。

常用端点

本页列出 OpenAI compatible 的文本、Responses、图像、视频任务、音频、向量、审核和实时接口。视频参数与轮询流程请查看图片与视频生成；实际可用端点取决于模型和 Key 分组。

模型与发现

用途	方法	路径
模型列表	GET	/v1/models

文本与响应

用途	方法	路径
文本补全（旧版）	POST	/v1/completions
聊天对话	POST	/v1/chat/completions
Responses	POST	/v1/responses
Responses 压缩	POST	/v1/responses/compact
独立网页检索（扩展）	POST	/v1/alpha/search

图像

用途	方法	路径
图像生成	POST	/v1/images/generations
图像编辑	POST	/v1/images/edits

视频任务

用途	方法	路径
创建视频任务	POST	/v1/videos
查询视频任务	GET	/v1/videos/{task_id}
获取视频内容	GET	/v1/videos/{task_id}/content

音频

用途	方法	路径
音频转录	POST	/v1/audio/transcriptions
音频翻译	POST	/v1/audio/translations
文本转语音	POST	/v1/audio/speech

向量与检索

用途	方法	路径
文本嵌入	POST	/v1/embeddings
文档重排序	POST	/v1/rerank

安全与实时

用途	方法	路径
内容审核	POST	/v1/moderations
Realtime（WebSocket）	GET	/v1/realtime

最小请求

客户端 Base URL 通常填写 https://api.popgo.site/v1，认证使用 Authorization: Bearer YOUR_API_KEY。将 YOUR_MODEL 替换为模型页中的 ID，并确认模型支持目标端点。

POST /v1/alpha/search 是独立网页检索扩展，仅适用于模型目录中明确列出此端点的型号。JSON 中 model 为必填非空字符串；id（字符串）与 stream（布尔值）可选。兼容客户端应保留其原有检索字段，并按实际响应的 Content-Type 解析；不能把 Chat Completions 的请求与响应结构直接用于此端点。接口定义见 API Reference。

curl https://api.popgo.site/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "请回复连接成功"}
    ]
  }'

验证

先用最小请求确认模型和协议，再逐步启用流式、工具、图像或音频参数。出现 404 时检查 Base URL 是否重复追加 /v1；出现 400 时检查模型是否支持该端点。