Effects API
Entra una foto. Sale una imagen nueva o un clip en movimiento.
Cada efecto es una instrucción mantenida que invocas con un id corto. Sube una imagen, nombra el efecto, consulta la tarea: las muestras de abajo son lo que devolvió.
POST /v1/images/transformations
Efectos de imagen
Entra una foto y vuelve una imagen transformada: el mismo sujeto, con otra pose, otra ropa o sin ella. Cada tarjeta muestra el original en pequeño sobre el resultado. Haz clic para ver la petición exacta.
undress
26 efectosCostume
27 efectosPose
60 efectosPOST /v1/videos/transformations
Efectos de vídeo
Entra una foto y vuelve un clip de cinco segundos animado por el efecto que nombres. Pasa el cursor por una tarjeta para reproducirla. Haz clic para ver la petición exacta.
Dos endpoints, también con tu propio prompt
Un efecto es un parámetro más de una petición que ya controlas. Envía tu propio prompt al endpoint de imagen, o añade uno junto a un efecto de vídeo para guiarlo.
Imagen a imagen
Transforma una imagen subida con un prompt, un effectId o ambos.
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"
}'- Solo prompt, solo efecto, o efecto con prompt encima
- Salida en HD o Full HD, siete relaciones de aspecto
- Asíncrono: la respuesta es una tarea que consultas
Imagen a vídeo
Anima una imagen subida en un clip de cinco u ocho segundos impulsado por un efecto de vídeo.
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
}'- El effectId es obligatorio; el prompt es opcional y aditivo
- 832×480 o 1280×720, 5 u 8 segundos
- Se cobra por segundo de salida, solo si tiene éxito
Tres llamadas de una foto a un resultado
Todas las peticiones de esta página tienen la misma forma. Nada que instalar, ningún modelo que alojar.
- 1
Sube la imagen
Pide un hueco de subida, envía los bytes con PUT, confirma. Obtienes un assetId al que cualquier petición puede referirse.
POST /v1/assets - 2
Nombra el efecto
Un POST con el assetId y el effectId, más un prompt o presets si quieres sobrescribir sus valores por defecto.
POST /v1/images|videos/transformations - 3
Consulta la tarea
La respuesta es una tarea. Consúltala hasta que termine y lee la URL de salida. Una tarea fallida nunca se cobra.
GET /v1/tasks/{id}
Prueba cualquier efecto con tu propia imagen
Regístrate, recarga el saldo en dólares y cada efecto de esta página responderá a tu primera petición.