API 参考

Shotject 开放平台提供 OpenAI/Anthropic 兼容的 /v1/ 接口,所有端点均通过 https://shotject.com 访问。

认证

所有 API 请求需要在请求头中携带 API Key:

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx

或使用 x-api-key 请求头:

x-api-key: sk-xxxxxxxxxxxxxxxxxxxxxxxx

API Key 在控制台 API Key 页面创建。

端点概览

方法路径说明
GET/v1/models列出可用模型
POST/v1/chat/completionsChat Completions(OpenAI 兼容)
POST/v1/messagesMessages(Anthropic 兼容)
POST/v1/responsesResponses(OpenAI Responses API 兼容)
POST/v1/images/generations图片生成
POST/v1/videos创建视频生成任务
GET/v1/videos/{id}查询视频任务状态
GET/v1/videos/{id}/content获取视频内容
GET/v1/videos/{id}/last-frame获取视频最后一帧

控制调用来源

通过 X-Shotject-Channel 请求头控制本次调用走官方渠道还是 BYOK:

请求头值行为
空(不传)自动优先:有匹配 BYOK 凭证则走 BYOK,否则走官方
official强制走官方渠道
byok强制尝试 BYOK,失败后按配置回落官方