PierNode Documentation
Build applications with the PierNode API.
One REST API for AI image and video generation. You send a prompt — and, for the image-driven products, an image you uploaded — and get back a generated file.
Everything is asynchronous: you start a task and poll it until it is done.
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"}'Quickstart → From an API key to your first image in five steps.
What you can generate
| Product | Input | Endpoint | Priced |
|---|---|---|---|
| Generate image | prompt | POST /api/v1/images/generations | per image |
| Transform image | uploaded image + prompt | POST /api/v1/images/transformations | per image |
| Generate video | prompt | POST /api/v1/videos/generations | per second |
| Transform video | uploaded image + effect | POST /api/v1/videos/transformations | per clip |
Transforming an image takes a named effect instead of a prompt if you want one; transforming a video requires one.
Current rates: pricing, or
GET /api/v1/pricing with no key.
The shape of every integration
POST a generation → task id
↓
GET /tasks/{id} → QUEUED / PROCESSING
↓
SUCCEEDED → download the outputThe two image-driven products add one step in front: upload an
image and pass its assetId.
Reference
- Authentication — a key, sent as a bearer token.
- All endpoints — the whole API on one page.
- Errors — status codes and what to do about each.
- Idempotency & retries — making a submission safe to resend.
- OpenAPI — machine-readable schema.