统一调用 API
面向业务接入的二次封装统一 AI API
统一调用 API 是本平台为了简化业务接入而提供的二次封装接口。底层仍兼容 OpenAI、Gemini、Sora、ElevenLabs 等接口格式,但业务接入时优先使用这里定义的统一模型值、字段别名、能力模式和自动路由。
Base URL
https://geekapi.net/v1鉴权
所有用户侧调用都使用 Bearer Token:
Authorization: Bearer sk-你的令牌
Content-Type: application/json令牌可以在控制台的 API 令牌页面创建。除文件上传或兼容特殊上游接口外,本文档中的请求都默认使用 application/json。
推荐接口
模型列表
查询当前账号可用模型,并按能力选择模型值。
文本生成
统一 Chat Completions、Responses、流式输出和 JSON 输出。
图片生成
统一文生图、图生图和参考图输入字段。
视频生成
统一文生视频、图生视频、参考图、参考视频、参考音频和首尾帧。
音频生成
通过 OpenAI speech 兼容格式调用语音模型。
任务与错误
异步任务状态、轮询方式和常见 400 错误。
文本生成
文本模型继续使用 OpenAI 兼容接口,完整字段规范见「文本生成」页面。
POST /v1/chat/completions{
"model": "gemini-3.5-flash",
"messages": [
{
"role": "user",
"content": "用一句话介绍本平台 API。"
}
]
}如果你的客户端使用 Responses API,可使用:
POST /v1/responses{
"model": "gemini-3.5-flash",
"input": "用一句话介绍本平台 API。"
}多媒体任务
图片和语音接口通常同步返回结果;视频接口通常返回任务对象,需要再查询任务状态。视频任务推荐使用:
POST /v1/videos
GET /v1/videos/{task_id}
GET /v1/videos/{task_id}/content兼容旧客户端时也可以继续使用:
POST /v1/video/generations
GET /v1/video/generations/{task_id}与 API 参考的关系
「API 参考」菜单保留由 OpenAPI 生成的底层接口说明,适合查字段 schema、HTTP 方法和兼容接口细节。「统一调用 API」是面向业务接入的推荐写法,重点说明统一模型值、字段别名、自动路由和模型能力。