API 参考
Shotject 开放平台提供 OpenAI/Anthropic 兼容的 /v1/ 接口,所有端点均通过 https://shotject.com 访问。
认证
所有 API 请求需要在请求头中携带 API Key:
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx或使用 x-api-key 请求头:
x-api-key: sk-xxxxxxxxxxxxxxxxxxxxxxxxAPI Key 在控制台 API Key 页面创建。
端点概览
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /v1/models | 列出可用模型 |
POST | /v1/chat/completions | Chat Completions(OpenAI 兼容) |
POST | /v1/messages | Messages(Anthropic 兼容) |
POST | /v1/responses | Responses(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,失败后按配置回落官方 |
