外观
常见问题
接入
FlashCoding.AI 和 ChatGPT、Claude 网页版是一回事吗？
不是。FlashCoding.AI 提供的是面向程序和客户端的 API 接入。网页版订阅、账号权益与 API Key 通常是不同的产品体系，不能互相当作凭证。
Base URL 应该填什么？
OpenAI 兼容 SDK 通常填写 https://flashcoding.ai/v1。某些客户端会自动追加 /v1，这时可能只需要域名。最可靠的方法是查看客户端对该字段的说明，并确认最终请求没有重复路径。
为什么浏览器打开 API 地址显示错误？
API 端点通常要求 POST、鉴权请求头和 JSON 请求体，直接在地址栏访问会发送 GET，不能作为接口是否可用的判断。请使用 curl、SDK 或 API 调试工具。
可以在网页前端直接放 API Key 吗？
不可以。浏览器中的源码、网络请求和构建产物都能被访问者查看。应由自己的服务端持有 Key，前端只调用你的后端。
在哪里查看当前模型？
在 FlashCoding.AI 控制台的模型或渠道相关页面查看。模型 ID、可用协议和限制会变化，文档不维护静态模型清单。
Anthropic 或 Gemini 模型能走 OpenAI 格式吗？
若控制台将目标模型标记为 OpenAI 兼容，可使用 /v1/chat/completions。需要原生内容结构或特有能力时，应选择对应原生协议。不要假定兼容层能表达所有原生参数。
API Key
Key 为什么只显示一次？
许多密钥系统只在创建时展示完整值，以降低泄露风险。若控制台无法再次显示完整 Key，应创建新 Key 并撤销不再使用的旧 Key。
一个 Key 可以用于多个项目吗？
技术上能否复用取决于控制台规则，但不建议这样做。按项目和环境拆分 Key，才能独立撤销、审计和核对用量。
Key 泄露后只删除代码可以吗？
不可以。Git 历史、构建缓存或他人的副本中仍可能保留它。应立即在控制台撤销 Key、创建替代 Key，并检查异常用量。
为什么新 Key 返回 401？
检查是否复制完整、是否有空格或换行、鉴权头是否匹配协议，以及应用是否仍从旧环境变量读取配置。必要时用最小 curl 请求排除客户端问题。
请求与响应
为什么是 404？
常见原因是 Base URL 重复 /v1、完整路径拼错，或模型 ID 不存在。先打印客户端最终请求 URL，再从控制台重新复制模型 ID。
为什么是 429？
可能是当前账户、分组或上游渠道的频率与并发限制，也可能是临时繁忙。遵循响应中的重试提示（若有），使用带随机抖动的退避，并限制总重试次数。
为什么输出被截断？
可能达到模型输出上限、应用设置的上限、上下文限制或客户端超时。检查响应中的结束原因和用量字段，再调整输入长度或输出限制。
流式与非流式会影响答案吗？
stream 主要改变传输方式：流式逐步返回事件，非流式等待完整响应。不同客户端的超时和解析行为可能造成体验差异；计费和模型行为以实际模型规则为准。
可以无限自动重试吗？
不可以。参数或权限错误不会因重试自行修复，持续重试还会放大流量。只对网络错误、429 和部分 5xx 做有限、退避式重试，并考虑请求是否可安全重复。
同样的提示词为什么结果不同？
生成模型可能包含随机采样，模型或渠道也可能更新。需要更可重复的输出时，可在模型支持的前提下降低随机性，并固定提示词、模型 ID 和参数；仍不应假定逐字一致。
计费与账户
当前价格是多少？
请查看控制台的实时价格和结算说明。价格可能因模型、分组、输入输出类型和活动发生变化，本文档不写死具体金额。
请求失败会不会计费？
要看失败发生在哪一阶段以及上游是否已开始处理。请以控制台消费记录为准；应用应保存时间、模型、状态码和请求标识，方便核对。
为什么本地统计与账单不同？
重试、共享 Key、统计延迟、时区、缓存或多模态用量都可能造成差异。按时间、模型和 Key 标识逐笔核对，详情见用量与账单。
是否支持退款、发票或收据？
以控制台订单说明、站内公告和当前联系渠道公布的政策为准。不要依据其他平台或历史信息推断 FlashCoding.AI 的规则。
稳定性与数据
如何判断是平台问题还是我的代码问题？
先查看站内公告，再用最小 curl 请求测试。同一个 Key 和模型在 curl 中成功，通常说明问题位于 SDK、客户端或附加参数；最小请求也失败时，根据状态码继续排查。
可以在生产环境只依赖默认超时吗？
不建议。应显式设置连接、读取和总超时，限制并发与重试，并记录错误率和延迟。模型生成耗时会受请求内容和上游状态影响。
FlashCoding.AI 如何处理我的数据？
请查阅 FlashCoding.AI 当前发布的隐私政策、服务条款和控制台说明。不要根据兼容的上游协议推断数据留存政策；也不要在不必要时发送敏感信息。