飞序 API 接入指南

准备 Base URL、API Key 和模型名,即可在 OpenAI SDK、Cline、Cursor、Cherry Studio 或业务系统中调用。常见错误、限流和费用核对可按下方清单排查。

OpenAI SDK

已有 OpenAI SDK 的项目,可以通过统一 Base URL 和 API Key 接入飞序 API。

业务系统接入

用于工具站、自动化脚本、知识库和内部系统,统一模型入口和调用记录。

Cline / Cursor / Codex

面向开发工具用户,整理推荐模型、配置方式和常见报错。

Cherry Studio

适合桌面客户端用户,用飞序 API 统一管理国内模型。

工具站成本控制

围绕子 Key、分组、限额、日志和防刷,帮助工具站管理下游消耗。

故障排查

记录 401、429、模型不存在、JSON 不稳定、服务超时等常见问题。

基础接入示例

以下是 OpenAI 兼容接口的示意。实际 Base URL、API Key 和模型名以控制台展示为准。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FXSEQ_API_KEY,
  baseURL: "https://api.fxseq.com/v1"
});

const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "用三句话总结这段文字" }]
});

console.log(completion.choices[0].message.content);

接入前建议确认

  • 当前任务适合哪类模型:编程、批量、长文档、中文办公或多模态;
  • 调用方是否需要子 Key、分组、额度限制和日志留存;
  • 是否需要稳定 JSON 输出、工具调用或长上下文;
  • 模型价格、计费单位和官方来源是否已经核对。

常见排查方向

问题优先检查
401 / 无权限API Key、模型权限、分组权限、Key 是否过期。
429 / 限流服务限流、当前分组额度、请求并发和重试策略。
模型不存在模型名是否与控制台一致,是否对当前 Key 开放。
费用异常输入输出 Token、缓存计费、图片或音频等特殊计费项。

获取接入配置

目前已支持支付宝充值。需要其他支付方式、批量开通或团队额度,可通过邮箱沟通;接入前请确认模型权限、Base URL、API Key 和价格口径。

联系邮箱:fxseqs@163.com
建议附带:使用场景、预计调用模型、充值方式、是否用于工具站或团队、是否需要子 Key / 分组 / 限额 / 日志排查。

接入流程

  1. 说明用途和预计调用场景。
  2. 确认可用模型、价格来源、权限边界和充值方式。
  3. 获取 Base URL、API Key 和推荐模型名。
  4. 按文档完成测试调用,并核对控制台日志和消耗记录。