开发者 文档

① 鉴权

所有请求在 Header 携带 Authorization: Bearer sk-你的密钥。密钥在控制台创建（sk- 开头），请勿在前端硬编码。

② 文本对话

POST https://api.fcsas.cn/v1/chat/completions，model 填对应模型标识（见 模型大全）。

curl

curl https://api.fcsas.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"你好，介绍一下蜂巢词元"}]
  }'

Python

import os, requests

api_key = os.environ["FCSAS_KEY"]
resp = requests.post(
    "https://api.fcsas.cn/v1/chat/completions",
    headers={"Authorization": "Bearer " + api_key},
    json={"model": "deepseek-chat",
          "messages": [{"role": "user", "content": "你好"}]},
)
print(resp.json()["choices"][0]["message"]["content"])

Node.js

const res = await fetch("https://api.fcsas.cn/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.FCSAS_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "deepseek-chat",
    messages: [{ role: "user", content: "你好" }],
  }),
});
const data = await res.json();
console.log(data.choices[0].message.content);

③ 图像与视频

• 图像生成：POST https://api.fcsas.cn/v1/images/generations
• 视频生成：POST https://api.fcsas.cn/v1/video/generations

视频生成参数：分辨率必须按模型给

视频接口最容易踩的坑是分辨率：不同模型支持的分辨率集合并不一样，传了模型不支持的值会直接返回 400。下面是实测整理的支持范围。

几个容易翻车的细节：

• 分辨率取值要和模型支持集合精确匹配——上游对大小写不敏感，但取值必须在集合内。比如给 Kling 传 768P 就会被拒。
• 参考图默认用 OpenAI 格式传：{"type":"image_url","image_url":{"url":"你的图片URL"}}，放进 content[] 数组；部分图生视频模型要求参考图放顶层 images:["URL"] 数组，以具体模型为准。
• 要做图生视频，模型要选 *-i2v / *-r2v 这类变体；*-t2v 是纯文生，不收参考图。
• 参考图必须是公网可访问的 URL，base64 内联上游抓不到。先上传到对象存储或图床再传地址。

视频走 media 计费通道独立计量，不与文本词元混算（避免重复扣费），详见 计费说明。

④ 常见错误码