FlowBarCN API 文档

FlowBarCN 提供 OpenAI 兼容的对话、向量与图像接口，并提供统一的视频任务接口。使用控制台创建的 API Key，即可接入 DeepSeek、通义千问、GLM、Kimi、MiniMax、Seedream、Wan、HappyHorse 与 Cdance 等模型。

基础配置

Base URL: https://flowbar.cn/v1
Authorization: Bearer $FLOWBAR_API_KEY

对话：/v1/chat/completions；向量：/v1/embeddings；图像：/v1/images/generations；视频提交：/v1/video/generations；视频查询：/v1/video/generations/{task_id}。

Python 示例

import os
from openai import OpenAI
client = OpenAI(
    base_url="https://flowbar.cn/v1",
    api_key=os.environ["FLOWBAR_API_KEY"]
)
resp = client.chat.completions.create(
    model="deepseek-v4-flash-0731-new",
    messages=[{"role":"user","content":"你好"}]
)
print(resp.choices[0].message.content)

JavaScript 示例

import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://flowbar.cn/v1",
  apiKey: process.env.FLOWBAR_API_KEY
});
const resp = await client.chat.completions.create({
  model: "deepseek-v4-flash-0731-new",
  messages: [{ role: "user", content: "你好" }]
});
console.log(resp.choices[0].message.content);

cURL 示例

curl https://flowbar.cn/v1/chat/completions \
  -H "Authorization: Bearer $FLOWBAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash-0731-new","messages":[{"role":"user","content":"你好"}]}'

常用模型速查

对话与推理：deepseek-v4-flash-0731-new、deepseek-v4-pro-0813、qwen3.8-max、glm-5.3、kimi-k3、minimax-m3；向量：text-embedding-v4；图像：Doubao-seedream-5.0-lite；视频：wan3.0-video、cdance2.0-mini-0807。完整名称和价格以模型广场、定价页为准。

下一步

创建 API Key 查看定价模型广场

模型家族接入指南

现有 OpenAI 兼容应用如何接入国产模型

沿用 OpenAI 兼容应用时，需要一起调整 Base URL、本站密钥和精确模型 ID。先验证最小文本请求，再逐项恢复流式、工具或多模态参数；兼容接口不代表每个模型支持相同参数。

在服务端设置 FLOWBAR_API_KEY 环境变量；不要放入浏览器代码、截图、公开仓库或日志。Python 示例需先安装 openai，JavaScript 示例仅在 Node.js 服务端运行。
Base URL 设为 https://flowbar.cn/v1。SDK 通常会追加接口路径，不要重复拼接 /v1。
用自己的密钥查询 GET /v1/models；从返回结果复制精确 ID，保留大小写、连字符和版本后缀。目录列出不等于你的账户已实测可用。
先使用本页非流式文本示例，再检查返回内容、usage 和错误信息。真实调用会计费；本页示例仅做离线语法检查，未执行付费调用。
逐个启用原应用的可选参数，保留超时、错误记录与重试上限；不要将密钥或完整请求内容写进排错日志。

Windows PowerShell / curl.exe 示例

在 Windows 中使用 curl.exe，避免 PowerShell 的 curl 别名差异。示例通过标准输入传 JSON；Hello 为 ASCII 文本，避免旧版 PowerShell 管道编码改变中文内容。

# 在运行环境中安全配置 FLOWBAR_API_KEY；不要写入源码。
if (-not $env:FLOWBAR_API_KEY) { throw "请先设置 FLOWBAR_API_KEY" }
$payload = @{
    model = "deepseek-v4-flash-0731-new"
    messages = @(@{ role = "user"; content = "Hello" })
    stream = $false
} | ConvertTo-Json -Depth 5 -Compress
$payload | curl.exe --silent --show-error https://flowbar.cn/v1/chat/completions `
    -H "Authorization: Bearer $env:FLOWBAR_API_KEY" `
    -H "Content-Type: application/json" --data-binary '@-'

如何理解返回用量？

下面是说明字段的虚构示例，不是真实调用记录。prompt_tokens 是输入用量，completion_tokens 是输出用量，total_tokens 是两者之和；不能把 total_tokens 全按输入价计算。缓存明细或视频任务字段需要按实际返回解释。

{"usage":{"prompt_tokens":10000,"completion_tokens":2000,"total_tokens":12000}}

查看输入、输出和视频费用复算示例

协议和参数边界

本站文档列出的接口为对话 /v1/chat/completions、向量 /v1/embeddings、图像 /v1/images/generations，以及视频提交 /v1/video/generations 和查询 /v1/video/generations/{task_id}。视频任务不是文本聊天响应；保存任务 ID 后查询状态，不要把重复提交当作查询。

本轮未逐模型实测流式、工具调用、上下文上限、图片尺寸或视频参数，不承诺全系列支持。接入前按精确版本确认参数，并用经过授权的小样本验证；不要仅凭品牌名推断能力。

常见报错怎么排查？

先看响应中的 error.message、error.type、error.code（若有）和请求编号。HTTP 状态可能来自网关或模型服务，单独一个状态码不能确定原因；以下是排查顺序，不是本站所有错误的固定映射。

401：检查认证: 检查运行环境是否读到本站密钥，Authorization 是否为 Bearer 格式；不要用网页登录 Cookie 代替 API Key。
403：检查访问限制: 根据错误内容检查账户、令牌模型权限和访问限制；无法判断时提供脱敏报错，不要通过更换来源绕过保护。
429：停止密集重试: 检查返回的限流提示和 Retry-After（如有），降低并发并设置有上限的退避；余额问题按实际错误内容单独处理。
模型不存在或不可用: 比较请求中的精确 ID 与本账户 /v1/models 结果，检查是否拼错或使用了不同版本；目录可见不代表请求一定成功。
余额或额度不足: 查看账户余额、令牌额度和适用分组；若仍不一致，通过支持入口核对，避免持续提交同一请求。

求助时仅提供发生时间、请求编号、公开模型 ID 和脱敏错误；删除 Authorization、完整密钥、Cookie、个人资料及业务原文。

模型广场常见问题支持入口

更新日期：2026-09-23。来源：本站 API 文档、公开目录及国内站配置核对；示例未做真实调用验证。