快速开始

01准备你的接入信息

QuikFlux 提供与 OpenAI 常用接口兼容的接入方式。不同模型的能力、参数和响应格式可能存在差异；先用最小请求验证，再添加可选参数。

02文本、图片、视频：接口路径与定义

这些地址是 HTTP API 接口路径，不是不同的网络端口。所有请求都使用 https://quikflux.com 的 HTTPS 默认端口 443；/v1 表示 API 版本，后面的路径决定调用哪种能力。

/chat、/images、/video 可以用来简称文本、图片和视频能力，但不能直接作为完整请求地址。请使用下表中的完整 URL 和对应 HTTP 方法。

03如何选择接口和填写参数

1. 1

   按能力选择路径：文本走 chat/completions，生成图片走 images/generations，视频走 videos。模型名称填入请求体 model，不能把模型名称当作 URL。

2. 2

   每次请求都携带 Authorization: Bearer <API_KEY>。JSON 请求设置 Content-Type: application/json；图片文件上传由客户端自动设置 multipart boundary。

3. 3

   文本最小参数为 model、messages；图片为 model、prompt，建议 n:1；视频以 model、prompt 为基础，时长及参考图按对应模型专页确认。不要把通用适配器的默认时长当作 H3 或 SD 的支持范围。

4. 4

   gpt-image-2 / gpt-image-2-vip 对应图片生成；minimax-h3-768p-enhanced / seedance-2.5-video 对应视频。先确认令牌分组与模型权限；Seedance 时长不能直接照搬 H3。

5. 5

   返回结果要按能力读取：文本读取回复，图片读取 data，视频保存任务 ID 并继续查询，完成后下载。不要把图片响应当作视频任务，也不要只凭 HTTP 200 判断视频已经生成。

服务域名 + API 版本 + 能力路径 = 完整请求地址
https://quikflux.com + /v1 + /chat/completions
→ https://quikflux.com/v1/chat/completions

图片：POST /v1/images/generations → 图片数据
视频：POST /v1/videos → 任务 ID
      GET /v1/videos/{id} → completed
      GET /v1/videos/{id}/content → 视频内容

04完成首次调用

1. 1

   进入 QuikFlux 控制台，在 API 令牌管理中创建令牌，选择可用分组并确认额度。

2. 2

   将令牌保存为服务端环境变量 QUIKFLUX_API_KEY，不要放入公开网页或 Git 仓库。

3. 3

   调用 GET /v1/models 查看当前令牌可见的模型，替换示例中的 model。

4. 4

   运行下方示例，确认 HTTP 状态码和响应正文后，再接入你的业务。

curl --request POST 'https://quikflux.com/v1/chat/completions' \
  --header "Authorization: Bearer $QUIKFLUX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "用一句话介绍 QuikFlux。"
    }
  ],
  "stream": false
}'

05理解成功响应

读取 choices[0].message.content 获取文本。usage 是示意值，并非固定费用；流式响应请按 SSE 事件处理。

{
  "id": "chatcmpl_EXAMPLE",
  "object": "chat.completion",
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "QuikFlux 为应用提供统一的 AI 接入能力。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 18,
    "total_tokens": 38
  }
}

06选择下一步