Gateway 接口

生产环境 Base URL：https://api.hubridge.net

当前开放接口：对话补全（POST /v1/chat/completions）、图像生成（POST /v1/images/generations）、图像编辑（POST /v1/images/edits）、Gemini 多模态（POST /v1beta/models/{model}:generateContent）、Seedance 2.0 视频生成（POST /seedance/api/v3/contents/generations/tasks、GET /seedance/api/v3/contents/generations/tasks/{task_id}）。

POST OpenAI 对话补全

POST /v1/chat/completions

OpenAI 兼容 Chat Completions 端点。支持同步与 SSE 流式（stream=true）。按渠道类型自动转换上游协议。 可用平面：gateway；单体 app.main 含 all。

Body 请求参数

{
    "model": "gpt-4",
    "messages": [
        {
            "role": "user",
            "content": "Hello!"
        }
    ],
    "stream": false,
    "temperature": 0.7,
    "max_tokens": 1024
}

请求参数

返回示例

200 Response

{
  "id": "string",
  "object": "chat.completion",
  "created": 0,
  "model": "string",
  "choices": [
    {}
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 0
  }
}

返回结果

返回数据结构

状态码 200

OpenAI Chat Completions 标准响应

状态码 402

状态码 403

状态码 502

状态码 503

POST Gemini 生成内容

POST /v1beta/models/{model}:generateContent

Google Gemini generateContent 兼容端点。查询参数 stream=true 或请求体 stream 字段可开启流式。 可用平面：gateway；单体 app.main 含 all。

Body 请求参数

{
    "contents": [
        {
            "role": "user",
            "parts": [
                {
                    "text": "Hello!"
                }
            ]
        }
    ]
}

请求参数

返回示例

200 Response

{}

返回结果

返回数据结构

状态码 200

Gemini 响应或 SSE 流

状态码 402

状态码 403

POST OpenAI 图像生成

POST /v1/images/generations

OpenAI 兼容 images/generations（OpenAI/custom 渠道）。常用模型如 gpt-image-2。

Body 请求参数

{
    "model": "gpt-image-2",
    "prompt": "A cute cat sitting on a windowsill, watercolor style",
    "n": 1,
    "size": "1024x1024"
}

请求参数

返回示例

200 Response

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/image.png",
      "revised_prompt": "A cute cat sitting on a windowsill, watercolor style"
    }
  ]
}

402 Response

{
  "detail": null
}

返回结果

返回数据结构

状态码 200

状态码 402

状态码 403

状态码 404

状态码 502

状态码 503

POST OpenAI 图像编辑

POST /v1/images/edits

OpenAI 兼容 images/edits（multipart/form-data）。基于参考图与提示词生成编辑结果；可选 mask 指定编辑区域。

Body 请求参数

model: gpt-image-2
prompt: Add a red scarf to the cat
image: ""
n: 1
size: 1024x1024
mask: ""

请求参数

返回示例

200 Response

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/edited.png"
    }
  ]
}

402 Response

{
  "detail": null
}

返回结果

返回数据结构

状态码 402

状态码 403

状态码 404

状态码 502

状态码 503

POST Seedance 2.0 视频任务创建

POST /seedance/api/v3/contents/generations/tasks

字节 Seedance 2.0（豆包）原生视频 API 透传。需配置 type=seedance 渠道。

常用模型：doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128。

请求体顶层需包含 model；content 为内容数组（非嵌套在 metadata 内）。duration 为整数 4–15 秒。

成功状态为 succeeded（非 completed），视频 URL 通常在 content.video_url。

Body 请求参数

{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
        {
            "type": "text",
            "text": "一只猫在草地上奔跑"
        }
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
}

请求参数

返回示例

200 Response

{
  "id": "string",
  "status": "queued",
  "content": {
    "video_url": "string"
  },
  "error": {},
  "_gateway": {}
}

返回结果

返回数据结构

状态码 200

枚举值

状态码 402

状态码 403

状态码 404

状态码 502

状态码 503

GET 查询 Seedance 视频任务

GET /seedance/api/v3/contents/generations/tasks/{task_id}

轮询 Seedance 2.0 原生任务状态。可选 query model 指定渠道路由。

请求参数

返回示例

200 Response

{
  "id": "string",
  "status": "queued",
  "content": {
    "video_url": "string"
  },
  "error": {},
  "_gateway": {}
}

返回结果