模型目录

模型目录是唯一权威的地方:它说明你的 key 能触达哪些模型、每个模型多少钱。上游厂商会变化,所以请在运行时读取,而不是把模型名硬编码进代码。

列出模型

curl https://hypit.video/v1/models \
  -H "Authorization: Bearer $HYPIT_API_KEY"

返回结构里前四个字段(id、object、created、owned_by)与 OpenAI 完全一致,所以未改动的 OpenAI SDK 里 client.models.list() 可直接使用;后面的字段是我们扩展的,不需要的客户端忽略即可。

endpoints —— 最有用的字段

它说明该模型会被哪些路由接受,也回答了最常见的问题:为什么这个模型在 /v1/videos 上 404。取值是固定的:

取值对应路由
imagesPOST /v1/images/generations
image_editsPOST /v1/images/edits
videosPOST /v1/videos
chatPOST /v1/chat/completions
geminiPOST /v1beta/models/{model}:{action}
audio_speechPOST /v1/audio/speech
transcriptionsPOST /v1/audio/transcriptions
audio_musicPOST /v1/audio/music

modality 更粗粒度,只有 image、video、chat、audio 四种,对应任务信封里的 kind。

pricing —— 按什么计费

pricing.mode 说明计费单位:per_image、per_request、per_second、per_token、per_k_char 或 per_audio_second。带 _usd 的数字是含我方加价的零售价,仅供参考;真正重要的是 pricing.credits,因为积分才是账户里唯一的余额。

token 类费率在积分里按「千 token」报价(input_per_k、output_per_k、cached_per_k、reasoning_per_k),旁边的 USD 字段则按「百万 token」——这是厂商的公开口径,也是我们价目表的存储方式。倍率表(size_ratio、quality_ratio、resolution_ratio、flag_ratio)都是对基准费率的纯乘数:例如某模型 1080p 的一秒价格,等于它的每秒费率乘以 resolution_ratio 里的 1080p 值。

上线前先跑一次模型列表,把费率记进你的成本模型;重跑同一条视频前也可以先算一遍,避免预算意外。

中文内容导航

继续阅读

常见问题

可以硬编码模型名吗?

不建议。上游厂商会增减,模型可用性随时变化;运行时读取列表并按 endpoints 过滤更稳。

为什么某个模型在其他端点上 404?

因为它的 endpoints 里没有那条路由。先读 endpoints,再决定请求哪个接口。

怎么在生成前知道要花多少积分?

读该模型的 pricing.credits,再乘以对应倍率(分辨率、质量等),得到的就是预估消耗。