常见问题

已有 BeefAPI 账号还需要重新注册吗？

已有账号可登录企业入口。企业钱包和 Key 独立管理，首次看到企业余额为零不代表其他钱包余额丢失。到 企业控制台 查看。

为什么其他钱包有余额，企业调用仍提示不足？

企业调用使用企业人民币钱包，不从国内或海外钱包扣款。还要检查 Key 的独立额度和有效期，详见 计费。

能直接用原来的 Key 吗？

请在企业入口创建企业 Key，并请求 https://enterprise.beefapi.com。跨站密钥会被拒绝，换 Base URL 不会迁移 Key 或余额。

为什么客户端里找不到模型？

先用同一 Key 查询 /v1/models，将 data[].id 原样加入客户端。检查是否选择了正确协议，以及客户端是否缓存了旧目录。不要把视频型号加入文本模型调用流程。

Claude 和 OpenAI 的 Base URL 一样吗？

域名一样，SDK 的配置值不同：OpenAI 兼容 Base URL 带 /v1；Anthropic SDK 和 Claude Code 使用根地址。见 客户端接入。

企业版现在可以画图吗？

当前 22 型号目录没有图片生成型号。视频支持图片输入，不等于图片生成。新增开放情况以实时企业目录为准，见 图片能力。

视频请求返回 queued，我已经付费了吗？

任务已受理，可能已预留额度，但尚未得到最终结果和结算金额。保存 ID 并查询原任务；在用量里区分 pending 与 settled。

轮询了几分钟还没完成，要重新提交吗？

不要。客户端停止等待不表示任务失败，稍后继续查询同一 ID。重提会产生另一条任务并可能再次计费。

视频成功，为什么还不能下载？

文件可能仍在保存，下载接口会说明 video_delivery_pending。按 Retry-After 重试下载即可。若是保存失败或地址失效，保留任务 ID 联系支持；不要自动重新生成。

Seedance 的秒数能直接写数字吗？

seconds 写字符串 "5"；顶层 duration 可写整数 5 或 -1 自动。不同型号的时长、分辨率和编辑限制见 Seedance。

错误请求一定不扣费吗？

不能只凭错误或连接中断判断。执行已开始、视频已受理或用量仍待确认时，可能存在预留或实际消费。请查 用量记录；未知状态不是零金额。

能查询整个企业钱包的余额吗？

/v1/usage 是当前 Key 的用量汇总，不是钱包余额。企业余额和充值状态在 钱包 查看。

能保证所有模型都支持同样的工具和并发吗？

模型、协议和客户端功能各有差异。用实际业务场景验证必要能力；需要固定容量或其他服务约定时，先与企业支持确认，不从目录可见或一次请求成功推断保障。