> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 接入、模型、计费、充值、状态页和支持

<AccordionGroup>
  <Accordion title="怎么开始接入 Tapapi？">
    最短路径是注册账号、创建 API Key，然后把你现有 OpenAI SDK 或 HTTP 请求的 `base_url` 改成 `https://tapapi.ai/v1`。

    详细步骤见 [快速开始](/quickstart) 和 [认证方式](/authentication)。
  </Accordion>

  <Accordion title="接入需要更换 SDK 吗？">
    大多数文本和图片调用不需要。Tapapi 兼容 OpenAI 风格接口，优先复用你已经在用的 OpenAI SDK、HTTP 客户端或工具配置。

    如果是 Dify、Open WebUI、n8n、Make、ComfyUI、Laravel 等场景，可以看 [工具集成](/integrations/openai-sdk)。
  </Accordion>

  <Accordion title="文本、图片、视频都支持吗？">
    当前文档重点覆盖文本 API 和图片 API。视频 API 按受控开放维护，公开视频接口仍以控制台、模型中心和视频文档的实际开放状态为准。

    也就是说，受控开放能力不要直接放进默认生产流程，先做灰度和小样本验证。
  </Accordion>

  <Accordion title="同一个 Key 能混用不同模型吗？">
    可以。同一个 API Key、同一个 `base_url`，通过 `model` 字段切换不同文本或图片模型。余额和账单统一归到同一个账号下。

    生产环境建议给不同项目或业务线创建不同 Key，便于限额、禁用和对账。
  </Accordion>

  <Accordion title="为什么状态页显示视频能力正常，但我还不能直接生产调用？">
    状态页展示的是能力级摘要，表示平台侧存在对应能力配置或灰度能力；它不是单个模型、单个账号、单次请求的生产可用保证。

    视频是否可用于生产，要同时看视频 API 文档、控制台模型可见性、账号权限和实际请求结果。
  </Accordion>

  <Accordion title="计费规则和价格以哪里为准？">
    Tapapi 按模型和实际用量计费。文本通常看 token，图片通常看有效返回图片或模型结果，任务模型可能按任务结果结算。

    最终可调用模型、账号分组价格、充值汇率、折扣和优惠，以控制台、价格页展示和实际账单为准。

    → [查看价格](/pricing)
  </Accordion>

  <Accordion title="调用失败会扣费吗？">
    失败不扣看最终结算结果。系统可能先预扣额度，模型请求失败、网络中断、没有生成有效结果时再返还。

    如果模型已经成功返回有效结果，通常正常计费。内容审核拒绝、NSFW 占位图或模型返回的正常拒绝内容，是否计费以具体模型和最终账单为准。

    → [失败不扣规则](/production/failure-refund)
  </Accordion>

  <Accordion title="图片生成成功但下载或转存失败，还会扣费吗？">
    通常会。模型已经生成并返回有效图片时，平台会按生成结果结算。后续下载、转存、上传到你自己的存储失败，属于你的保存链路问题，不等同于模型生成失败。

    建议业务侧记录 `X-Oneapi-Request-Id` / `request_id`、返回图片数、保存成功数和失败原因，方便区分模型失败和转存失败。
  </Accordion>

  <Accordion title="余额不足时会发生什么？">
    余额不足或 API Key 额度不足时，请求通常不会进入正式生成，也不应扣费。常见错误是 `403` 和 `insufficient_user_quota`。

    处理方式是充值、调整 Key 限额、检查账号分组和模型权限。
  </Accordion>

  <Accordion title="支付成功但余额没到账怎么办？">
    先到 `/wallet` 查看充值订单状态。如果支付页面显示成功，但控制台订单仍不是 `success`，请使用钱包里的“充值未到账？订单申诉”。

    提交时带上订单号、支付时间、支付方式、支付金额、支付成功截图和当前余额截图。

    → [联系支持](/support/contact)
  </Accordion>

  <Accordion title="怎么查某次请求扣了多少钱？">
    到控制台用量日志查看请求时间、模型名、API Key、`request_id`、token 或图片结果，以及最终 `quota`。API 响应头里的 `X-Oneapi-Request-Id` 也要保存。

    业务侧建议保存 `task_id | request_id | model | status | error_code | quota | created_at`，后续排障会快很多。

    → [余额与用量](/account/balance-usage)
  </Accordion>

  <Accordion title="联系支持时要带哪些信息？">
    API 问题请带请求时间、模型、接口路径、`X-Oneapi-Request-Id` / `request_id`、HTTP 状态码、`error.code`、脱敏请求摘要和业务 `task_id`。

    充值问题请带订单号、支付时间、支付金额、支付方式、支付成功截图和控制台余额截图。

    不要发送完整 API Key、完整私钥、完整银行卡号或未脱敏隐私数据。
  </Accordion>

  <Accordion title="能看到上游供应商、渠道名或密钥信息吗？">
    不能。用户侧日志会隐藏上游渠道、密钥和内部路由信息。排障通常只需要 `request_id`、模型名、时间、错误码和控制台用量记录。
  </Accordion>
</AccordionGroup>