账户 API 参考
Orbit API 中 账户 的全部 10 个端点:方法与路径、所需令牌权限、参数,以及对应的命令行命令与 MCP 工具。
共 17 个端点,其中 5 个只读。每一个都同时是 orbit 命令行中的命令、SDK 中的方法和 MCP 服务器上的工具。
| 端点 | 权限 | 参数 | CLI · MCP 工具 |
|---|---|---|---|
GET /vod/assetsList videos | 只读 | ?limit integer?offset integer?state uploading | processing | ready | failed | orbit vod assets listvod_assets_list |
POST /vod/assetsCreate a video, then upload the original into it | 读写 | 请求体: title string, description string, tags object, visibility public | unlisted | private | orbit vod assets createvod_assets_create |
GET /vod/assets/{id}One video, with transcode progress while it is processing | 只读 | id string | orbit vod assets get <id>vod_assets_get |
PATCH /vod/assets/{id}Change a video's title, description, tags or visibility | 读写 | id string请求体: title string, description string, tags object, visibility public | unlisted | private | orbit vod assets update <id>vod_assets_update |
DELETE /vod/assets/{id}Delete a video and everything stored for it | 读写 | id string | orbit vod assets delete <id>vod_assets_delete |
POST /vod/assets/{id}/reprocessEncode the original again with the ladder your packs allow today | 读写 | id string | orbit vod assets reprocess <id>vod_assets_reprocess |
GET /vod/assets/{id}/renditionsThe qualities this video was encoded into | 只读 | id string | orbit vod assets renditions <id>vod_assets_renditions |
POST /vod/assets/{id}/playbackA playback address — signed and expiring for a private video | 读写 | id string请求体: expires_in integer | orbit vod assets playback <id>vod_assets_playback |
| 端点 | 权限 | 参数 | CLI · MCP 工具 |
|---|---|---|---|
POST /vod/assets/{id}/uploadStart a resumable upload of the original | 读写 | id string请求体: size* integer, content_type string, filename string | orbit vod upload begin <id>vod_upload_begin |
PUT /vod/assets/{id}/upload/{upload_id}/parts/{n}Send one part. The body is the bytes, not JSON. | 读写 | id stringupload_id stringn integer请求体:原始字节 | orbit vod upload part <id> <upload_id> <n>vod_upload_part |
POST /vod/assets/{id}/upload/{upload_id}/completeSeal the upload and queue the transcode | 读写 | id stringupload_id string | orbit vod upload complete <id> <upload_id>vod_upload_complete |
| 端点 | 权限 | 参数 | CLI · MCP 工具 |
|---|---|---|---|
GET /vod/keysPlayback signing keys | 只读 | — | orbit vod keys listvod_keys_list |
POST /vod/keysMint a playback signing key (the secret is shown once) | 读写 | 请求体: note string | orbit vod keys createvod_keys_create |
DELETE /vod/keys/{key_id}Revoke a playback key | 读写 | key_id string | orbit vod keys delete <key_id>vod_keys_delete |
| 端点 | 权限 | 参数 | CLI · MCP 工具 |
|---|---|---|---|
GET /vod/webhooksVOD event endpoints | 只读 | — | orbit vod webhooks listvod_webhooks_list |
POST /vod/webhooksRegister a VOD event endpoint (stored now; delivery is not switched on yet) | 读写 | 请求体: url* string, events string[], note string | orbit vod webhooks createvod_webhooks_create |
DELETE /vod/webhooks/{hook_id}Remove a VOD event endpoint | 读写 | hook_id integer | orbit vod webhooks delete <hook_id>vod_webhooks_delete |