模型目录
模型目录是唯一权威的地方:它说明你的 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。取值是固定的:
| 取值 | 对应路由 |
|---|---|
| images | POST /v1/images/generations |
| image_edits | POST /v1/images/edits |
| videos | POST /v1/videos |
| chat | POST /v1/chat/completions |
| gemini | POST /v1beta/models/{model}:{action} |
| audio_speech | POST /v1/audio/speech |
| transcriptions | POST /v1/audio/transcriptions |
| audio_music | POST /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,再乘以对应倍率(分辨率、质量等),得到的就是预估消耗。