curlPOST /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": "<effect id>" }'响应
{
"id": "01JD8Z9K2M4N6P8Q0R2S4T6V8W",
"status": "QUEUED",
"createdAt": "2026-01-01T12:00:00.000Z"
}一个请求，返回一个可轮询的任务。
API
三套 API，一个密钥
现成特效按 id 调用，其余一切交给开放提示词。一个密钥，一个任务模型，一种结果格式。
特效 API
数百个现成特效。发送一张照片和一个 id，提示词由我们维护。
- 图片特效传入一张照片，输出一张改造后的图片——只需 effectId。
- 视频特效传入一张照片，输出一段 5 秒视频——只需 effectId。
图片 API
根据提示词生成，或改造你上传的照片。
- 文生图描述你想要的，即可拿到成图，支持 1K、2K 或 4K。
- 图生图你的照片加一段提示词——换背景、去物体、换风格。
视频 API
根据提示词生成，或让你上传的照片动起来。
- 文生视频一段提示词生成一段视频，时长 4 到 15 秒。
- 图生视频用视频特效让你的照片动起来。
接入
四步生成第一张图
无需 SDK，任何 HTTP 客户端都可以。
- 1
创建 API 密钥
每个账号一个密钥，在控制台创建。仅显示一次。
- 2
发送请求
一个 POST，立即返回一个任务，而不是成品文件。
- 3
轮询任务
查询任务直到完成。轮询永不收费。
- 4
下载结果
一个签名链接，有效期一小时。重新轮询即可获取新链接。
生成一张图片
curl -X POST https://app.piernode.com/api/v1/images/generations \
-H "Authorization: Bearer $PIERNODE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a red ceramic mug on a wooden table, studio lighting",
"resolution": "1k",
"aspectRatio": "16:9"
}'响应
{
"id": "01JD8Z9K2M4N6P8Q0R2S4T6V8W",
"status": "QUEUED",
"createdAt": "2026-01-01T12:00:00.000Z"
}内置能力
为集成而生
AI 流水线中原本需要你自己搭建的部分。
原生异步
生成需要几秒到几分钟。请求会立即返回一个稳定的任务 id，你的系统无需一直保持连接。
直传并校验
你的图片上传到我们管理的存储中，使用前会经过检查。PierNode 从不抓取你提供的 URL，从而让一整类攻击远离你的集成。
美元预付余额
先充值，再消费。每次生成都会预先预留费用，失败则全额退还。没有积分、没有代币，无需任何换算。
无需折腾模型
你发送提示词，拿到结果。由哪个模型运行由我们负责，背后的机制如何变化，你的集成都能照常运行。
价格
按次付费
以美元计价，仅在调用成功时扣费。
视频 API
文生视频
US$0.42/ 5 秒视频
480p512p US$0.56720p US$0.701080p US$1.00
图生视频
US$0.42/ 5 秒视频
HDFHD US$0.70
单月充值 $10,000 及以上，费用立减 20%。 其他用量和合作方式，欢迎随时沟通。
在 Telegram 上联系我们FAQ