常见问题
接入前最常被问到的几个问题。没有找到答案，直接联系我们就行。
飞鱼Token 和模型厂商的官方接口有什么区别？
飞鱼Token 是兼容 OpenAI 与 Anthropic 格式的网关：一个 Key、一套鉴权、一份账单，就能调用 GLM、DeepSeek、Qwen、Kimi、MiniMax、Seedance、MiMo 等主流模型。接口格式完全兼容，把现有 SDK 的接入地址换过来即可使用。
可以免费试用吗？
可以。联系我们开通测试账号；也可以自己注册，注册后联系客服领取新用户赠金。
如何计费？和官方价格一样吗？
计费逻辑与厂商官方一样：按 Token 实际用量、在线支付、费用从账户余额扣减。价格不同 —— 充值 98 折，模型使用 5 折起，消费明细可在控制台查看。
支持哪些协议和 SDK？
同时提供 OpenAI 兼容接口与 Anthropic 兼容接口。你可以继续使用现有的 OpenAI SDK 或 Anthropic SDK：OpenAI 协议填 open.feiyutoken.com/v1，Anthropic 协议填 https://open.feiyutoken.com（不带 /v1）；把 API Key 换成平台生成的 Key，参数与返回结构不需要改动。两种协议的地址写法见「接口约定」。
支持哪些编程语言？
任何能发 HTTP 请求的语言都可以。用 OpenAI 或 Anthropic 的官方 SDK 最省事（Python、Node.js 等），其他语言用 HTTP 客户端直接请求即可。
API Key 泄露或被盗用怎么办？
立即在控制台删除或重置该 API Key，并检查近期调用记录与用量。如发现异常扣费，请尽快联系客服处理。不要把 API Key 写在前端代码、公开仓库或截图里。
请求内容会被用于训练吗？
不会。我们不会主动读取或存储你通过 API 发送的对话内容与提示词：这些内容只在转发过程中瞬时经过服务器内存，不落盘、不留存。平台记录的是计费与排障所需的调用元数据（时间、模型名、Token 用量、响应状态）。
调用失败、限流或超时怎么办？
先检查 API Key、余额、模型名、base_url 与请求协议是否正确，再按状态码判断：401 或 403 多为鉴权问题，429 多为限流或余额不足，5xx 多为服务端或网络问题。可稍后重试；若持续失败，联系客服并提供请求时间、模型名与错误信息。
返回 context_length_exceeded 怎么办？
输入太长了。精简 messages 的内容，或者换一个上下文更长的模型。
返回 model_not_found 怎么办？
model 参数写错了。调用 GET /v1/models 可以取到当前可用的模型列表；模型名沿用厂商官方命名，注意大小写。
流式输出中途断了怎么办？
通常是网络问题导致 SSE 连接断开。断掉的这一段无法续传，需要重新发起请求；建议客户端自己做拼接逻辑，并在断流后重试。
回复内容被截断了怎么办？
可能是 max_tokens 设得太小，或者模型输出到了自己的上限。看响应里的 finish_reason：如果值是 length，说明是被截断的，把 max_tokens 加大再试。
一次请求消耗多少 Token？
看响应里的 usage 字段：输入与输出 Token 的总和就是这次调用的消耗量。控制台的消费明细可以逐条核对。
流式请求怎么统计 Token？
请求里加上 stream_options: {"include_usage": true}，最后一个 chunk 会带上 usage；非流式请求默认就返回 usage。
支持文本以外的模态吗？
支持。文本、图像、语音、视频均可用同一套鉴权与账单调用。不同模态的计量单位不同：文本按 Token，图像按张数或分辨率，语音与视频按时长，具体以控制台模型列表为准。
支持图片输入（Vision）吗？
支持。图片按 OpenAI 的多模态格式传图片 URL 或 Base64 即可；某个模型是否支持图片输入，以控制台模型列表里的说明为准。
可以微调模型吗？
暂不支持微调。可以直接使用平台提供的模型，通过 prompt 工程和 few-shot 达到定制效果。
浏览器里直接调 API 可以吗？
不建议。API Key 不能放在前端代码里（任何人打开开发者工具都能看到），而且浏览器直连会遇到跨域限制。正确做法是由你自己的后端转发请求。
服务器需要能访问外网吗？
需要。网关跑在公有云上对外服务，调用方的网络要能访问 open.feiyutoken.com/v1。
怎么查看 API 调用日志？
在控制台可以按模型、按 Key、按时间查看调用记录、Token 用量与消费明细，报表支持导出。