API 文档

平台介绍

把站内的生图与生视频能力直接接进你自己的产品。

开放平台把创作台里那套生成能力原样开放出来:同一批模型、同一套计费口径、同一条渲染链路。你在网页里能出的图、能出的片,用密钥调接口一样能出,产物同时落进你账号的素材库。

能做什么

文生图 / 图生图支持参考图、画面比例与 1K/2K/4K 清晰度档,单次最多 4 张。
文生视频 / 图生视频支持首尾帧、参考图与多档分辨率,时长按所选规格档夹取。
模型自选平台上架的模型都能用,调用前先查 /v1/models 拿到可用 id 与单价。
算力自查随时查询账户可用算力,避免任务提交到一半才发现余额不够。

接口设计

接口风格贴近 OpenAI:密钥形如 sk- 开头的长串,统一放在 Authorization: Bearer 里;路径以 /v1 开头;出错时返回结构固定的 error 对象。用过 OpenAI SDK 的话,改个 baseURL 与路径就能上手。

生图有同步与异步两种用法:默认同步,等图出完才响应,返回形状与 OpenAI 的 images/generations 一致,OpenAI SDK 与各类中转网关可以直接把本站当兼容渠道挂上去;在请求里加 async: true 则改为异步,提交即拿任务 id,再用 GET /v1/tasks/{id} 取结果。

生视频只有异步一种:出片以分钟计,同步等待会把连接压在网关超时边缘,超时重试还会重复计费。跑批、排队量大或对时延敏感的场景,生图也建议走异步。

所有接口的基地址:https://open.pikpikgo.com/v1

下一步