POST /v1/images/transformations
图片特效
传入一张照片，返回一张改造后的图片：同一个人物，换姿势、换装或脱衣。每张卡片在结果图上叠加显示原图，点击即可查看完整请求。
undress
26 个特效Costume
27 个特效Pose
60 个特效POST /v1/videos/transformations
视频特效
传入一张照片，返回一段 5 秒视频，由你指定的特效驱动。悬停卡片即可播放，点击查看完整请求。
端点
两个端点，也支持自定义提示词
特效只是你请求中的一个参数。可以在图片端点上发送自己的提示词，也可以在视频特效旁附加提示词来引导效果。
图生图
用提示词、effectId 或二者结合，改造上传的图片。
POST /v1/images/transformations
curl -X POST https://app.piernode.com/api/v1/images/transformations \
-H "Authorization: Bearer $PIERNODE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"assetId": "<uploaded asset id>",
"prompt": "change the background to a sunlit beach",
"resolution": "hd",
"aspectRatio": "3:4"
}'- 仅提示词、仅特效，或特效叠加提示词
- 输出 HD 或 Full HD，支持七种宽高比
- 异步：响应是一个任务，轮询即可拿到图片
图生视频
由视频特效驱动，将上传的图片生成 5 秒或 8 秒的视频。
POST /v1/videos/transformations
curl -X POST https://app.piernode.com/api/v1/videos/transformations \
-H "Authorization: Bearer $PIERNODE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"assetId": "<uploaded asset id>",
"effectId": "<video effect id>",
"resolution": "hd",
"durationSeconds": 5
}'- effectId 必填；提示词可选，会叠加到特效上
- 832×480 或 1280×720，5 秒或 8 秒
- 按输出秒数计费，仅在成功时扣费
接入
从照片到结果，只需三次调用
本页的所有请求结构都相同。无需安装任何东西，也无需托管模型。
- 1
上传图片
申请上传地址，PUT 文件内容，再确认。你会得到一个 assetId，任何请求都可以引用它。
POST /v1/assets - 2
指定特效
一个 POST，带上 assetId 和 effectId——如需覆盖默认值，再加上提示词或预设参数。
POST /v1/images|videos/transformations - 3
轮询任务
响应是一个任务。轮询直到成功，然后读取输出 URL。失败的任务绝不收费。
GET /v1/tasks/{id}