# SupeRouter ## API Docs - Client [查询当前余额](https://doc.superouter.ai/434944823e0.md): 返回当前调用所使用 API Key 的所属 client 及其共享可用积分余额。 - Client [查询调用流水(账单)](https://doc.superouter.ai/434944824e0.md): 返回当前 Client 的统一账单流水。包含扣费、加款、人工调整和失败退款，不只显示消费记录。 - Client [查询生成任务](https://doc.superouter.ai/434944825e0.md): 返回当前调用方(Client)最近提交的生成任务列表及其状态。 - Client [查询名下 API Key](https://doc.superouter.ai/434944826e0.md): 返回当前调用方(Client)所有 API Key。 - Client [创建 API Key](https://doc.superouter.ai/434944827e0.md): 自助创建一把新的 API Key。新 key 会共享当前 client 的积分余额。 - Client [禁用名下 API Key](https://doc.superouter.ai/434944828e0.md): 自助禁用当前 Client 名下的指定 API Key。 - Client [启用名下 API Key](https://doc.superouter.ai/434944829e0.md): 自助启用当前 Client 名下的指定 API Key。 - Client [健康检查](https://doc.superouter.ai/434944830e0.md): 返回服务健康状态，便于部署系统、负载均衡或监控系统做存活检查。 - Video [上传视频素材](https://doc.superouter.ai/434944832e0.md): 上传图片、视频或音频素材到平台，返回平台自己的 `fileId`。请求可以直接上传文件，也可以提供公开可访问的 `sourceUrl`（HTTP/HTTPS）让平台下载入库。后续提交视频生成任务时，需要引用这个 `fileId`。 - Video [查询素材详情](https://doc.superouter.ai/434944833e0.md): 按平台 `fileId` 查询素材元数据。素材按 client 隔离，不能查询其他 client 的素材。 - Video [读取素材内容](https://doc.superouter.ai/434944834e0.md): 按平台 `fileId` 读取素材原始内容，仅允许当前 client 访问自己的素材。 - Video [缓存完成视频](https://doc.superouter.ai/438800129e0.md): 当任务已完成且有真实视频地址时，按需下载视频到平台本地资源目录，并返回本地可访问地址。 - Video [读取缓存视频](https://doc.superouter.ai/438800130e0.md): 读取平台已缓存的视频结果，供前端直接播放或后续复用。 - Video [列出可用视频模型](https://doc.superouter.ai/438800131e0.md): 返回当前平台对客户可用的视频模型列表。模型来自已启用上游供应商的配置汇总，接口不会暴露具体提供商信息。 - Video [查询缓存视频首尾帧](https://doc.superouter.ai/449082124e0.md): 按缓存视频 assetId 查询已提取的首帧和尾帧素材信息，仅允许当前 client 访问自己的素材。 - Video [提交视频生成任务](https://doc.superouter.ai/434944835e0.md): 提交统一视频生成任务。请求里使用平台自己的模型名和素材 `fileId`，平台会在内部选择合适的上游供应商、处理素材顺序、上游鉴权和计费。 - Video [读取缓存视频首帧图](https://doc.superouter.ai/449082125e0.md): 按视频 assetId 推导首帧图文件路径并返回图片内容。路径规则：视频文件同目录下 {stem}_first_frame.jpg。 - Video [读取缓存视频尾帧图](https://doc.superouter.ai/449082126e0.md): 按视频 assetId 推导尾帧图文件路径并返回图片内容。路径规则：视频文件同目录下 {stem}_last_frame.jpg。 - Video [查询视频生成任务](https://doc.superouter.ai/434944836e0.md): 按平台 `taskId` 查询任务状态和生成结果。任务按 client 隔离，同一个失败任务只会触发一次退款。 - Video [取消视频生成任务](https://doc.superouter.ai/449082127e0.md): 取消排队中或生成中的任务。平台排队中的任务直接取消并退款；已提交上游的任务暂不支持取消。 - Video [列出可用图片模型](https://doc.superouter.ai/449082128e0.md): 返回当前平台对客户可用的图片生成模型列表。每个模型包含平台模型名、显示名、基础每张单价 (`imageGenerationRatePerImage`) 以及可选的分辨率档位价格表 (`imageGenerationRateByResolution`，按 `1k`/`2k`/`4k` 键)。若模型未配置分辨率表，会返回 `null`，计费按基础单价。 - Video [提交图片生成任务](https://doc.superouter.ai/449082129e0.md): 提交图片生成任务。请求使用平台模型名和参考图素材 `fileId`，平台在内部选择合适的上游、处理鉴权和计费。 - Video [查询图片生成任务](https://doc.superouter.ai/449082130e0.md): 按平台 `taskId` 查询图片生成任务状态和结果。 - Video [读取缓存图片](https://doc.superouter.ai/449082131e0.md): 返回平台缓存的图片二进制数据。任务在 `completed` 时平台会异步把图片下载到平台本地存储，该端点即对外暴露入口。 - Chat [列出可用模型](https://doc.superouter.ai/449082132e0.md): 返回当前平台启用的聊天和图片模型列表，响应结构兼容 OpenAI Models API。 - Chat [聊天补全](https://doc.superouter.ai/449082133e0.md): OpenAI-compatible chat completions endpoint with provider routing and token-based billing. - Projects [List Projects](https://doc.superouter.ai/449082134e0.md): - Projects [Create Project](https://doc.superouter.ai/449082135e0.md): - Projects [List Public Projects](https://doc.superouter.ai/449082136e0.md): - Projects [Get Project](https://doc.superouter.ai/449082137e0.md): - Projects [Update Project](https://doc.superouter.ai/449082138e0.md): - Projects [Delete Project](https://doc.superouter.ai/449082139e0.md): - Projects [Fork Project](https://doc.superouter.ai/449082140e0.md): - Projects [List Characters](https://doc.superouter.ai/449082141e0.md): - Projects [Create Character](https://doc.superouter.ai/449082142e0.md): - Projects [Update Character](https://doc.superouter.ai/449082143e0.md): - Projects [Delete Character](https://doc.superouter.ai/449082144e0.md): - Projects [List Appearances](https://doc.superouter.ai/449082145e0.md): - Projects [Create Appearance](https://doc.superouter.ai/449082146e0.md): - Projects [List Project Appearances](https://doc.superouter.ai/449082147e0.md): - Projects [Update Appearance](https://doc.superouter.ai/449082148e0.md): - Projects [Delete Appearance](https://doc.superouter.ai/449082149e0.md): - Projects [List Scenes](https://doc.superouter.ai/449082150e0.md): - Projects [Create Scene](https://doc.superouter.ai/449082151e0.md): - Projects [Update Scene](https://doc.superouter.ai/449082152e0.md): - Projects [Delete Scene](https://doc.superouter.ai/449082153e0.md): - Projects [List References](https://doc.superouter.ai/449082154e0.md): - Projects [Create Reference](https://doc.superouter.ai/449082155e0.md): - Projects [Update Reference](https://doc.superouter.ai/449082156e0.md): - Projects [Delete Reference](https://doc.superouter.ai/449082157e0.md): - Projects [List Episodes](https://doc.superouter.ai/449082158e0.md): - Projects [Create Episode](https://doc.superouter.ai/449082159e0.md): - Projects [Get Episode](https://doc.superouter.ai/449082160e0.md): - Projects [Update Episode](https://doc.superouter.ai/449082161e0.md): - Projects [Delete Episode](https://doc.superouter.ai/449082162e0.md): - Projects [List Episode Resources](https://doc.superouter.ai/449082163e0.md): - Projects [Add Episode Resource](https://doc.superouter.ai/449082164e0.md): - Projects [Remove Episode Resource](https://doc.superouter.ai/449082165e0.md): - Projects [List Episode Segments](https://doc.superouter.ai/449082166e0.md): - Projects [Create Episode Segment](https://doc.superouter.ai/449082167e0.md): - Projects [Update Episode Segment](https://doc.superouter.ai/449082168e0.md): - Projects [Delete Episode Segment](https://doc.superouter.ai/449082169e0.md): - Projects [Reorder Episode Segments](https://doc.superouter.ai/449082170e0.md): - Projects [Create Segment Version](https://doc.superouter.ai/449082171e0.md): - Projects [List Segment Versions](https://doc.superouter.ai/449082172e0.md): - Projects [Update Segment Version](https://doc.superouter.ai/449082173e0.md): - Projects [Delete Segment Version](https://doc.superouter.ai/449082174e0.md): - Projects [Download Episode Videos](https://doc.superouter.ai/449082175e0.md): ## Schemas - [Body_upload_video_asset_v1_video_assets_upload_post](https://doc.superouter.ai/257719946d0.md): - [AdminOverviewFailedTask](https://doc.superouter.ai/258589362d0.md): - [AddEpisodeResourceRequest](https://doc.superouter.ai/268231966d0.md): - [ClientCreate](https://doc.superouter.ai/257719947d0.md): - [AdminOverviewResponse](https://doc.superouter.ai/258589363d0.md): - [ClientResponse](https://doc.superouter.ai/257719948d0.md): - [AdminUsageLogResponse](https://doc.superouter.ai/261136537d0.md): - [HTTPValidationError](https://doc.superouter.ai/257719949d0.md): - [ClientBillingEntry](https://doc.superouter.ai/258589364d0.md): - [KeyCreate](https://doc.superouter.ai/257719950d0.md): - [KeyGrant](https://doc.superouter.ai/257719951d0.md): - [KeyListResponse](https://doc.superouter.ai/257719952d0.md): - [KeyResponse](https://doc.superouter.ai/257719953d0.md): - [ProxyRouteCreate](https://doc.superouter.ai/257719954d0.md): - [CreateAppearanceRequest](https://doc.superouter.ai/268231967d0.md): - [ProxyRouteResponse](https://doc.superouter.ai/257719955d0.md): - [CreateCharacterRequest](https://doc.superouter.ai/268231968d0.md): - [ProxyRouteTargetCreate](https://doc.superouter.ai/257719956d0.md): - [CreateEpisodeRequest](https://doc.superouter.ai/268231969d0.md): - [ProxyRouteTargetResponse](https://doc.superouter.ai/257719957d0.md): - [CreateEpisodeSegmentRequest](https://doc.superouter.ai/268231970d0.md): - [ProxyRouteTargetUpdate](https://doc.superouter.ai/257719958d0.md): - [PayPalCreateOrderRequest](https://doc.superouter.ai/261136538d0.md): - [CreateProjectRequest](https://doc.superouter.ai/268231971d0.md): - [ProxyRouteUpdate](https://doc.superouter.ai/257719959d0.md): - [CreateReferenceRequest](https://doc.superouter.ai/268231972d0.md): - [TopviewOmniReferenceSubmitRequest](https://doc.superouter.ai/257719960d0.md): - [CreateSceneRequest](https://doc.superouter.ai/268231973d0.md): - [TopviewReferenceAsset](https://doc.superouter.ai/257719961d0.md): - [CreateVersionRequest](https://doc.superouter.ai/268231974d0.md): - [UpstreamKeyCreate](https://doc.superouter.ai/257719962d0.md): - [ForgotPasswordRequest](https://doc.superouter.ai/268231975d0.md): - [UpstreamKeyListResponse](https://doc.superouter.ai/257719963d0.md): - [SessionProfile](https://doc.superouter.ai/258589365d0.md): - [GoogleCallbackRequest](https://doc.superouter.ai/268231976d0.md): - [UpstreamKeyResponse](https://doc.superouter.ai/257719964d0.md): - [GoogleMergeRequest](https://doc.superouter.ai/268231977d0.md): - [UpstreamProviderCreate](https://doc.superouter.ai/257719965d0.md): - [UpstreamProviderResponse](https://doc.superouter.ai/257719966d0.md): - [ImageGenerationSubmitRequest](https://doc.superouter.ai/268231978d0.md): - [UpstreamProviderUpdate](https://doc.superouter.ai/257719967d0.md): - [UpstreamKeyUpdate](https://doc.superouter.ai/258589366d0.md): - [ValidationError](https://doc.superouter.ai/257719968d0.md): - [VideoOmniReferenceSubmitRequest](https://doc.superouter.ai/257719969d0.md): - [VideoReferenceInput](https://doc.superouter.ai/257719970d0.md): - [UpstreamUsageLogResponse](https://doc.superouter.ai/258589367d0.md): - [UpstreamProviderModelConfig](https://doc.superouter.ai/261136539d0.md): - [LocalAuthRequest](https://doc.superouter.ai/268231979d0.md): - [LocalSignupResponse](https://doc.superouter.ai/268231980d0.md): - [ReorderEpisodeSegmentsRequest](https://doc.superouter.ai/268231981d0.md): - [ResetPasswordRequest](https://doc.superouter.ai/268231982d0.md): - [RoutingRuleCreate](https://doc.superouter.ai/268231983d0.md): - [RoutingRuleResponse](https://doc.superouter.ai/268231984d0.md): - [RoutingRuleUpdate](https://doc.superouter.ai/268231985d0.md): - [StripeCheckoutRequest](https://doc.superouter.ai/268231986d0.md): - [SubscriptionCheckoutRequest](https://doc.superouter.ai/268231987d0.md): - [UpdateAppearanceRequest](https://doc.superouter.ai/268231988d0.md): - [UpdateCharacterRequest](https://doc.superouter.ai/268231989d0.md): - [UpdateEpisodeRequest](https://doc.superouter.ai/268231990d0.md): - [UpdateEpisodeSegmentRequest](https://doc.superouter.ai/268231991d0.md): - [UpdateProjectRequest](https://doc.superouter.ai/268231992d0.md): - [UpdateReferenceRequest](https://doc.superouter.ai/268231993d0.md): - [UpdateSceneRequest](https://doc.superouter.ai/268231994d0.md): - [UpdateVersionRequest](https://doc.superouter.ai/268231995d0.md):