API 概览
一套 HTTP API,向大约二十多家上游图像、视频、音频与聊天厂商分发。你持有的是一个 key、一份余额、一种报文格式;路由、故障转移与计量由我们完成。
接口风格
接口刻意做成 OpenAI 形状:/v1/chat/completions 与 /v1/models 与官方 OpenAI SDK 可直接替换——把 client 指向我们的 base URL,已有代码继续可用。
生成式媒体端点沿用同样的约定(snake_case JSON、{"error": {...}} 信封、Unix 秒时间戳),但返回的是一个任务而不是成品:因为视频不可能在一个 HTTP 请求里返回。
Base URL
https://hypit.video/v1
Google 原生接口在上一层,位于 https://hypit.video/v1beta/models/...,详见 Gemini 原生接口。
同步与异步
| 类型 | 端点 | 返回 |
|---|---|---|
| 同步 | chat completions、语音合成、转写 | 结果在响应体里 |
| 异步 | 图像生成/编辑、视频、音乐 | 202 + 任务信封,之后轮询 |
FAQ
必须用 SDK 吗?
不必。异步端点用普通 HTTP 调用即可(SDK 的 images.generate 助手期望同步返回,不适用)。
一个 key 能访问所有模型吗?
取决于部署与 key 的配置,先查模型目录。
余额怎么算?
所有模态共用一份积分余额,详见积分与计费。