文档 | ZroImg

本页目录

使用指南

第一次使用 ZroImg？从平台介绍和快速上手开始，再了解积分如何计费。

平台介绍ZroImg 是一站式 AI 视觉创作平台：文字生成图片和视频、参考图再创作、局部重绘、无限画布、AI 提示词润色和公开画廊，按积分计费，并提供开放 API。快速上手几分钟上手 ZroImg：注册账号、获取积分、生成第一张图片和第一个视频，使用无限画布与 AI 提示词润色，并管理你的作品。积分与计费ZroImg 使用积分计费：图片按张、视频按秒或按条、AI 润色按次扣费。了解预计消耗如何计算、何时扣费、失败任务如何自动退还，以及签到和积分套餐。

API 基础

开始调用前先了解认证、异步任务模型、幂等、限流和错误码。

API 概览ZroImg 开放 API 入门：Base URL、API 密钥认证、异步任务模型、幂等提交、速率限制与错误格式，附完整的 Python 和 JavaScript 轮询示例。错误码ZroImg 开放 API 的错误格式与全部错误码：认证失败、积分不足、速率与并发限制、幂等冲突、参数错误、资源不存在、上游错误，以及推荐的重试策略。

API 接口

每个接口的参数、响应和可直接运行的 cURL、Python、JavaScript 示例。

模型列表GET /open/v1/models 返回当前可用的图片和视频模型，以及每个模型支持的模式、比例、画质或分辨率、数量、时长、参考图数量、默认值和计费价格。图片生成POST /open/v1/images/generations 提交文生图、参考图生图和局部重绘任务，返回异步任务对象和本次消耗的积分；支持 Idempotency-Key 防止重复扣费。视频生成POST /open/v1/videos/generations 提交文生视频和图生视频任务，可指定时长、比例、分辨率和多张参考图，返回异步任务对象与本次消耗的积分。任务GET /open/v1/tasks/{id} 查询生成任务的状态、进度、结果下载地址和失败原因；GET /open/v1/tasks 按状态和类型分页列出任务。附轮询建议与结果链接有效期说明。提示词润色POST /open/v1/prompts/polish 把简短的描述扩写为细节完整的图片或视频提示词，与网页端「AI 润色」计费相同，同步返回结果、消耗积分和剩余余额。积分余额GET /open/v1/balance 查询 API 密钥所属账户的当前积分余额。API 与网页端共用同一个积分余额，可用于提交前检查或余额告警。