跳至正文

开发者 API

Gapti API

通过统一的 REST API,将图像与视频创作接入你的产品。

探索可用模型

V1 与工作台共用模型、素材、任务恢复和积分账本。请把密钥保留在服务端。

参考站公开示例,并非 Gapti 已实测的生成结果。

API 使用文档

构建视觉创作流程

社交内容

为下一条社交帖子探索人像背景、服装和构图。

商品目录

以商品参考图规划棚拍与生活场景,并检查形状、材质和标签。

创意照片编辑

通过文字编辑说明尝试新服装、替换物品或插画风格。

品牌活动

围绕统一的配色、主体和美术方向构思一组关联广告。

一次接入,灵活掌控创作

读取模型

V1 与工作台共用模型、素材、任务恢复和积分账本。请把密钥保留在服务端。

上传图片

参考图采用三步上传:声明 MIME 和字节数、PUT 文件、完成上传。服务端验证不超过 10 MB 的 JPEG、PNG、WebP。生成时使用返回的素材 ID,不接受外部参考 URL 或其他账号素材。

读取生成任务

读取模型,按需上传参考图,获取报价,明确确认该报价,再携带稳定的 Idempotency-Key 提交。每两秒查询一次返回的任务,通过受保护的输出接口下载。

权限范围

请求携带 Authorization: Bearer YOUR_API_KEY。网站 Cookie 不能作为 API 凭据;每次请求均检查有效付费会员和密钥权限。

到期时间

每个密钥每分钟最多 60 个已认证请求,429 响应带 Retry-After。有效期为 1–365 天,可随时撤销。

报价并生成(消耗积分)

只有生成提交消耗账号积分,报价和创建密钥不扣费。供应商失败沿用现有退款及对账流程;原请求结果未明时,不要更换幂等键重新提交。

开始使用 Gapti API

创建和使用 API 密钥需要有效付费会员;已有密钥始终可以撤销。