快速开始

第二步：设置接口地址

将 API 的 Base URL 设置为：

https://hi-hub.cn/v1

第三步：发起调用

curl https://hi-hub.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "<模型名>",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://hi-hub.cn/v1",
)

resp = client.chat.completions.create(
    model="<模型名>",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

对话模型

全部对话模型共用上面的 OpenAI 兼容接口，只换 model 名称：

完整模型列表也可通过 GET /v1/models（带认证头）获取。 kimi-k3 为推理模型：思维链在 reasoning_content 字段、最终回答在 content 字段，思维链计入 token 计费，请合理设置 max_tokens。

视频生成

视频生成走独立异步接口 POST /v1/videos（multipart/form-data），提交后轮询 GET /v1/videos/{task_id} 取结果：

curl https://hi-hub.cn/v1/videos \
  -H "Authorization: Bearer sk-你的令牌" \
  -F "model=seedance-2.0" \
  -F "prompt=小船在湖面缓慢前行，薄雾漂移，写实风格" \
  -F "input_reference=@首帧图.jpg" \
  -F "input_video_reference=@参考视频.mp4" \
  -F "seconds=5" -F "size=1280x720"

input_reference（首帧/参考图）支持三种传法：文件直传、公网 URL、Base64 Data URI（data:image/jpeg;base64,...，平台自动托管，无需自备图床）； 参考视频/音频用 input_video_reference / input_audio_reference 上传。

• 横竖屏由 size 控制（如 1280x720 横屏、720x1280 竖屏），wan3.0 也可用 metadata.aspect_ratio 显式指定。
• 首/尾帧图不能与参考素材（参考图/参考视频/参考音频）同传（上游模型限制，失败自动退费）；人物保持一致 + 运镜参考视频的正确写法是 metadata={"image_role":"reference_image"}（wan3.0 用 image_type）。
• wan3.0 提示词中可用「图1」「视频1」「音频1」按传入顺序引用多个素材。
• 生成结果链接为限时签名 URL（约 24 小时），请及时下载保存。
• 失败任务费用自动退回账户，可稍后重新提交。

注意事项

• 模型名以模型广场与控制台公示为准，切换模型只需修改 model 参数。
• 令牌（API Key）可设置额度上限、过期时间与 IP 白名单，建议按应用分别创建。
• 接口兼容 OpenAI Chat Completions 协议，支持流式输出（stream: true）。
• 请求体请使用 UTF-8 编码；Windows 命令行直接粘贴中文可能被转成 GBK，导致回答与提示词不符，建议写入 UTF-8 文件再提交（curl 用 --data @body.json）。
• 请妥善保管令牌，泄露后请立即在控制台吊销并新建。

常见问题