怎么开始接入 Tapapi？
怎么开始接入 Tapapi？
接入需要更换 SDK 吗？
接入需要更换 SDK 吗？
大多数文本和图片调用不需要。Tapapi 兼容 OpenAI 风格接口，优先复用你已经在用的 OpenAI SDK、HTTP 客户端或工具配置。如果是 Dify、Open WebUI、n8n、Make、ComfyUI、Laravel 等场景，可以看 工具集成。
文本、图片、视频都支持吗？
文本、图片、视频都支持吗？
当前文档重点覆盖文本 API 和图片 API。视频 API 按受控开放维护，公开视频接口仍以控制台、模型中心和视频文档的实际开放状态为准。也就是说，受控开放能力不要直接放进默认生产流程，先做灰度和小样本验证。
同一个 Key 能混用不同模型吗？
同一个 Key 能混用不同模型吗？
可以。同一个 API Key、同一个
base_url，通过 model 字段切换不同文本或图片模型。余额和账单统一归到同一个账号下。生产环境建议给不同项目或业务线创建不同 Key，便于限额、禁用和对账。为什么状态页显示视频能力正常，但我还不能直接生产调用？
为什么状态页显示视频能力正常，但我还不能直接生产调用？
状态页展示的是能力级摘要，表示平台侧存在对应能力配置或灰度能力；它不是单个模型、单个账号、单次请求的生产可用保证。视频是否可用于生产，要同时看视频 API 文档、控制台模型可见性、账号权限和实际请求结果。
计费规则和价格以哪里为准？
计费规则和价格以哪里为准？
Tapapi 按模型和实际用量计费。文本通常看 token，图片通常看有效返回图片或模型结果，任务模型可能按任务结果结算。最终可调用模型、账号分组价格、充值汇率、折扣和优惠，以控制台、价格页展示和实际账单为准。→ 查看价格
调用失败会扣费吗？
调用失败会扣费吗？
失败不扣看最终结算结果。系统可能先预扣额度，模型请求失败、网络中断、没有生成有效结果时再返还。如果模型已经成功返回有效结果，通常正常计费。内容审核拒绝、NSFW 占位图或模型返回的正常拒绝内容，是否计费以具体模型和最终账单为准。→ 失败不扣规则
图片生成成功但下载或转存失败，还会扣费吗？
图片生成成功但下载或转存失败，还会扣费吗？
通常会。模型已经生成并返回有效图片时，平台会按生成结果结算。后续下载、转存、上传到你自己的存储失败，属于你的保存链路问题，不等同于模型生成失败。建议业务侧记录
X-Oneapi-Request-Id / request_id、返回图片数、保存成功数和失败原因，方便区分模型失败和转存失败。余额不足时会发生什么？
余额不足时会发生什么？
余额不足或 API Key 额度不足时，请求通常不会进入正式生成，也不应扣费。常见错误是
403 和 insufficient_user_quota。处理方式是充值、调整 Key 限额、检查账号分组和模型权限。支付成功但余额没到账怎么办？
支付成功但余额没到账怎么办？
先到
/wallet 查看充值订单状态。如果支付页面显示成功，但控制台订单仍不是 success，请使用钱包里的“充值未到账？订单申诉”。提交时带上订单号、支付时间、支付方式、支付金额、支付成功截图和当前余额截图。→ 联系支持怎么查某次请求扣了多少钱？
怎么查某次请求扣了多少钱？
到控制台用量日志查看请求时间、模型名、API Key、
request_id、token 或图片结果，以及最终 quota。API 响应头里的 X-Oneapi-Request-Id 也要保存。业务侧建议保存 task_id | request_id | model | status | error_code | quota | created_at，后续排障会快很多。→ 余额与用量联系支持时要带哪些信息？
联系支持时要带哪些信息？
API 问题请带请求时间、模型、接口路径、
X-Oneapi-Request-Id / request_id、HTTP 状态码、error.code、脱敏请求摘要和业务 task_id。充值问题请带订单号、支付时间、支付金额、支付方式、支付成功截图和控制台余额截图。不要发送完整 API Key、完整私钥、完整银行卡号或未脱敏隐私数据。能看到上游供应商、渠道名或密钥信息吗？
能看到上游供应商、渠道名或密钥信息吗？
不能。用户侧日志会隐藏上游渠道、密钥和内部路由信息。排障通常只需要
request_id、模型名、时间、错误码和控制台用量记录。