Hubridge

快速开始

三步完成 API Key 获取与首次调用

本指南帮助你在拿到 API Key 后,通过 OpenAI 兼容接口调用模型。Console 用于管理账号与令牌,实际推理请求请发往 Gateway 地址

准备工作

三步上手

1. 创建 API Key

  1. 进入 令牌管理
  2. 点击 创建令牌,填写名称
  3. 创建成功后复制完整密钥(格式类似 sk-xxx),可在列表中随时查看

2. 确认 Gateway 地址

API 调用 Base URL 为:

https://api.hubridge.net

当前开放 对话补全图像生成Gemini 图像识别Seedance 2.0 视频生成 接口,路径分别为:

  • POST /v1/chat/completions
  • POST /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,包含 choicesusage 字段。

下一步

主题说明
鉴权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 即可调用。