HELP CENTER

常见问题与自助服务

在这里找到接入、计费、模型使用与故障排查的答案。如果没有找到,页面末尾有技术支持二维码可随时联系我们。

QUICK START

5 步完成首次调用

从注册到拿到生成结果,平均只需 10 分钟。

1
注册账户
联系商务获取邀请注册
2
获取 API Key
控制台创建令牌
3
选择模型
广场浏览模型能力
4
发起请求
cURL / SDK 调用
5
查看结果
异步轮询拿结果

接入指南

+ API 基础地址是什么?兼容哪些协议?
基础地址 https://api.qinqyn.com/v1,兼容 OpenAI 与 Gemini 协议。SDK 直接将 base_url 指向此地址即可,无需改其他代码。
+ 如何获取 API Key?
联系商务开通账户后,登录控制台 → 令牌管理 → 创建令牌。建议为不同环境(生产/测试)分别创建 Key,并定期轮换。
+ 第一次调用报 401 怎么办?
检查 Header 中 Authorization 格式为 Bearer sk-xxx,确认 Key 未过期且具备对应模型权限。控制台可查看令牌可用范围。

计费说明

+ Token 计费和按次计费有什么区别?
图像模型(Doubao、Gemini)按 Token 计费,与输入输出分辨率相关;视频模型(Seedance、Kling)按次计费,与时长和分辨率相关。控制台显示各模型实时参考价。
+ 如何查看余额和消费记录?
控制台首页显示当前余额,消费记录在「日志」页按时间筛选,支持导出 CSV。systemd 每天 06:15 同步官方价格到首页。

模型能力

+ Seedance v2 和 v2 Pro 有什么区别?
v2 生成 5 秒 720p 视频,适合快速验证;v2 Pro 支持 10 秒 1080p,支持首尾帧引导,画质与运镜更精细,适合成品交付。
+ Gemini Image 支持图生图吗?
支持。提交时带 image 字段即可做图生图,多语言提示词兼容。建议图片不超过 2048×2048,过大可能触发 Token 限制。

故障排查

+ 报 429 Too Many Requests 怎么办?
网关按令牌维度限流。检查是否有循环未加退避的请求,降低并发或指数退避重试。如需提升上限,联系商务调整配额。
+ 视频任务一直 PENDING 不返回结果?
视频生成是异步任务,正常 30-90 秒完成。若超过 5 分钟仍 PENDING,检查任务 ID 是否正确,确认上游未维护。可调 GET /v1/videos/{id} 主动查询。

账户管理

+ 如何给团队成员分配不同权限?
控制台 → 渠道子账号 → 创建子账号,可单独设置可用模型、配额与计费归属。主账号保留 Key 轮换与配额调整权限。
+ API Key 泄露了怎么办?
立即在控制台禁用该 Key 并创建新 Key。如已产生异常消费,联系商务冻结账户并核查。建议生产环境用环境变量注入,不要硬编码到代码。

视频生成

+ 首尾帧引导是什么?如何使用?
首帧和尾帧是用于约束视频起止画面的图片。提交任务时带 first_frame 与 last_frame 字段(URL 或 base64),模型会在两帧之间生成过渡视频,适合做产品旋转、镜头衔接等场景。
+ 720p 和 1080p 怎么选?
720p 适合内部 Demo、快速验证、社交短内容;1080p 适合对外发布、广告投放、大屏展示。1080p 单次费用约为 720p 的 1.8 倍,但画质与运镜明显更好。
TECH SUPPORT

没找到答案?扫码联系我们

技术团队工作日 09:00-21:00 在线响应,紧急问题请优先通过下方渠道联系。

微信技术支持二维码
微信技术支持
扫码添加客服微信
钉钉交流群二维码
钉钉交流群
扫码加入技术交流群

准备好开始了吗?

一个 API Key,接入全部模型。Seedance 视频、Doubao 图像、Kling、Gemini,统一网关统一计费。