Skip to content

常见问题 ​

新项目应该选择哪种接口? ​

推荐原生 OpenAPI,可以获取完整模型能力与价格配置。已有 OpenAI / Sora 风格适配或使用 New API 等平台时,可以选择兼容接口。

有哪些模型?价格是多少?支持什么分辨率? ​

模型、线路、价格和能力会动态调整,请勿在客户端写死。以下路径均相对于对应协议的 Base URL。

  • 原生 OpenAPI:调用 GET /generation/config 获取模型、质量、画幅、时长、价格等配置。
  • OpenAI 兼容接口:调用 GET /v1/models 获取模型 ID;完整能力及价格参考原生配置接口或 星辰 AI 官网。

参考视频如何计费? ​

参考视频可能增加积分消耗,倍率由实时配置中的 inputVideoMultiplier 给出。公式与扣费时点见计费与退款。

如何引用参考素材? ​

在支持素材引用的模型中,提示词可按素材列表顺序使用 @图片1、@音频1、@视频1 等标记,索引从 1 开始。实际支持的素材种类和数量以模型能力为准。

可以直接发送本地文件或 Base64 吗? ​

生成接口的素材字段只接收公网可访问的 HTTP/HTTPS URL,不接收文件二进制或 Base64。

没有自己的素材托管服务时,可以使用素材上传接口:申请预签名 → 上传文件到对象存储 → 完成上传确认 → 将返回的 URL 用于生成任务。上传素材保留 3 天,并按上传规则收取积分。

如何免费测试接入流程? ​

使用原生测试线路或兼容接口测试模型。隐藏测试模型不出现在配置和模型列表中,不调用真实生成服务,也不扣减生成积分。

应该多久查询一次任务? ​

真实任务建议每 10~15 秒轮询一次,进入成功或失败终态后停止。原生 OpenAPI 同时跟踪多个任务时,优先使用批量查询。

为什么两种接口的状态和结果字段不同? ​

表格较宽时,可左右滑动查看完整内容。

协议成功状态详情接口的结果地址
原生 OpenAPIdata.status = 3data.outputs URL 列表
OpenAI 兼容接口status = "completed"metadata.result_url

请按照所选协议处理返回数据,不要混用请求和响应字段。

任务失败会退款吗? ​

生成任务失败时的退款规则见计费与退款。素材上传独立计费,不能直接套用生成任务退款规则。

请求失败、429 或创建超时怎么办? ​

见错误处理与轮询,按请求失败、任务失败和网络超时分别处理;不要对创建任务请求盲目自动重试。

星辰 AI · 图片与视频生成 API