GET STARTED / 接入指南
快速开始
从获取 API Key 到发出第一次请求。使用统一的 QuikFlux API，让文本、图片和视频能力进入你的应用。
一个接口，连接你的 AI 工作流。
OpenAI 兼容文本对话 · 图像生成 · 异步视频
01准备你的接入信息
QuikFlux 提供与 OpenAI 常用接口兼容的接入方式。不同模型的能力、参数和响应格式可能存在差异；先用最小请求验证，再添加可选参数。
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| 服务地址 | https://quikflux.com | 直接发 HTTP 请求时使用此域名 |
| SDK Base URL | https://quikflux.com/v1 | 适用于自动拼接资源路径的兼容 SDK |
| 鉴权方式 | Authorization: Bearer <API_KEY> | 使用控制台创建的 API 令牌 |
| 请求格式 | application/json | 图片编辑等上传请求使用 multipart/form-data |
02完成首次调用
- 1
进入 QuikFlux 控制台，在 API 令牌管理中创建令牌，选择可用分组并确认额度。
- 2
将令牌保存为服务端环境变量 QUIKFLUX_API_KEY，不要放入公开网页或 Git 仓库。
- 3
调用 GET /v1/models 查看当前令牌可见的模型，替换示例中的 model。
- 4
运行下方示例，确认 HTTP 状态码和响应正文后，再接入你的业务。
cURL
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
}'03理解成功响应
读取 choices[0].message.content 获取文本。usage 是示意值，并非固定费用；流式响应请按 SSE 事件处理。
JSON
{
"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
}
}04选择下一步
接入提示
本文档参考 ToAPIs 的文档组织方式，接口说明依据 QuikFlux 当前实现独立编写。QuikFlux 视频入口为 /v1/videos，不能直接套用参考站的 /v1/videos/generations。
| 需要的能力 | 请求接口 | 主要返回 |
|---|---|---|
| 文本对话 | POST /v1/chat/completions | choices 或 SSE 事件 |
| 图片生成 | POST /v1/images/generations | data[].url / data[].b64_json |
| 视频生成 | POST /v1/videos | 任务 id，随后轮询结果 |
示例中的模型需先获得对应分组权限。响应内容为结构示意，实际字段以渠道返回为准。