快速开始
三步完成 API Key 获取与首次调用
本指南帮助你在拿到 API Key 后,通过 OpenAI 兼容接口调用模型。Console 用于管理账号与令牌,实际推理请求请发往 Gateway 地址。
准备工作
三步上手
1. 创建 API Key
- 进入 令牌管理
- 点击 创建令牌,填写名称
- 创建成功后复制完整密钥(格式类似
sk-xxx),可在列表中随时查看
2. 确认 Gateway 地址
API 调用 Base URL 为:
https://api.hubridge.net当前开放 对话补全、图像生成、Gemini 图像识别 与 Seedance 2.0 视频生成 接口,路径分别为:
POST /v1/chat/completionsPOST /v1/images/generations(图像生成)POST /v1/images/edits(图像编辑)POST /v1beta/models/{model}:generateContent(Gemini 多模态 / 图像识别)POST /seedance/api/v3/contents/generations/tasks(创建视频任务)GET /seedance/api/v3/contents/generations/tasks/{task_id}(查询任务状态)
3. 发起第一次请求
将 YOUR_API_KEY 替换为你的密钥,model 替换为平台支持的模型名:
curl -X POST "https://api.hubridge.net/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{ "role": "user", "content": "Hello!" }
]
}'成功时返回 OpenAI 格式的 JSON,包含 choices 与 usage 字段。
下一步
| 主题 | 说明 |
|---|---|
| 鉴权 | API Key 用法与安全建议 |
| 对话补全 | 请求参数、多语言 SDK 示例 |
| 流式输出 | stream: true 与 SSE |
| 图像生成 | 图像生成与编辑(generations / edits) |
| Gemini 图像识别 | 多模态 generateContent + inlineData |
| Seedance 视频生成 | 异步视频任务创建与轮询 |
| 错误处理 | 常见状态码与排查 |
兼容说明
Gateway 提供 OpenAI 兼容 端点。将 SDK 或示例中的 Base URL 设为 https://api.hubridge.net/v1,并填入 Hubridge API Key 即可调用。
