Effects API
Une photo en entrée. Une nouvelle image ou un clip animé en sortie.
Chaque effet est une instruction maintenue que vous désignez par un id court. Envoyez une image, nommez l'effet, interrogez la tâche — les exemples ci-dessous sont ce qui en est ressorti.
POST /v1/images/transformations
Effets image
Une photo entre, une image transformée ressort : le même sujet, reposé, rhabillé ou déshabillé. Chaque carte montre l'original en médaillon sur le résultat. Cliquez pour la requête exacte.
undress
26 effetsCostume
27 effetsPose
60 effetsPOST /v1/videos/transformations
Effets vidéo
Une photo entre, un clip de cinq secondes ressort, animé par l'effet que vous nommez. Survolez une carte pour la lire. Cliquez pour la requête exacte.
Deux endpoints, avec votre propre prompt aussi
Un effet n'est qu'un paramètre d'une requête que vous contrôlez déjà. Envoyez votre propre prompt à l'endpoint image, ou ajoutez-en un à côté d'un effet vidéo pour l'orienter.
Image vers image
Transformez une image envoyée avec un prompt, un effectId, ou les deux.
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"
}'- Prompt seul, effet seul, ou effet avec un prompt par-dessus
- Sortie en HD ou Full HD, sept formats d'image
- Asynchrone : la réponse est une tâche que vous interrogez
Image vers vidéo
Animez une image envoyée en un clip de cinq ou huit secondes piloté par un effet vidéo.
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
}'- L'effectId est requis ; le prompt est optionnel et additif
- 832×480 ou 1280×720, 5 ou 8 secondes
- Facturé à la seconde produite, uniquement en cas de succès
Trois appels d'une photo à un résultat
Chaque requête de cette page a la même forme. Rien à installer, aucun modèle à héberger.
- 1
Envoyez l'image
Demandez un emplacement d'envoi, envoyez les octets en PUT, confirmez. Vous obtenez un assetId que toute requête peut référencer.
POST /v1/assets - 2
Nommez l'effet
Un POST avec l'assetId et l'effectId — plus un prompt ou des préréglages si vous voulez remplacer ses valeurs par défaut.
POST /v1/images|videos/transformations - 3
Interrogez la tâche
La réponse est une tâche. Interrogez-la jusqu'au succès et lisez l'URL de sortie. Une tâche échouée n'est jamais facturée.
GET /v1/tasks/{id}
Essayez n'importe quel effet sur votre propre image
Inscrivez-vous, créditez le portefeuille en dollars, et chaque effet de cette page répond à votre première requête.