Crea personas e intercambia a la persona del video

Lee el catálogoCopy Anchor Link

curl https://api.cut.pro/api/v1/personas/catalog \
  -H "X-Api-Key: $CUTPRO_API_KEY"

Crea la personaCopy Anchor Link

Envía una opción por característica en chips. La foto empieza a generarse y la respuesta es 202.

curl -X POST https://api.cut.pro/api/v1/personas \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chips": {
      "vibe": "natural", "gender": "female", "age": "25_34", "origin": "latin",
      "skin": "medium", "eyes": "brown", "hair_style": "long_wavy", "hair_color": "brown",
      "facial_hair": "none", "face": "none", "body": "average", "outfit": "basic",
      "accessory": "none", "mark": "freckles"
    }
  }'

Con el rostro de quien la usa. Envía las fotos antes y pasa los ids en face_ids, dentro de 24 horas y hasta max_face_photos (6). JPEG, PNG, WebP o HEIC de hasta 10 MB. own_face_adult: true confirma que la foto es de quien la usa y que esa persona tiene 18 años o más.

curl -X POST https://api.cut.pro/api/v1/personas/faces \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -F "photo=@selfie.jpg" \
  -F "own_face_adult=true"

Con face_ids, solo las características de face_photo_groups siguen valiendo, y en ellas la opción photo mantiene el rasgo tal como está en las fotos.

Desde un personaje listo, gratis. GET /personas/presets lista personajes con la foto ya hecha (category: weird, cartoon, creator o influencers). Crear desde uno de ellos no genera nada y nace con image_status: ready:

curl -X POST https://api.cut.pro/api/v1/personas/presets/$PRESET_ID \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ana" }'

Con name, la persona sale ya guardada. Sin name, es un borrador para guardar después. Sigue siendo ese personaje: en un regenerate, los chips se ignoran y solo la note edita. PUT /personas/presets/{presetId}/favorite con { "favorite": true } marca favoritos.

Ajusta y guardaCopy Anchor Link

Consulta GET /personas/{id} cada 5 segundos hasta que image_status pase a ready, o a failed con el motivo en error_code.

Para cambiar la foto, genera de nuevo con otros chips o edita con una note de una línea, que mantiene a la misma persona:

curl -X POST https://api.cut.pro/api/v1/personas/$PERSONA_ID/regenerate \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "note": "make the jacket red" }'

Una edición con note cuesta pricing.photo_with_references_credits. Si ya se está generando otra foto, la respuesta es 409 CARD_LOCKED.

Cuando la foto esté bien, guarda. En una persona guardada, la misma llamada solo cambia el nombre.

curl -X POST https://api.cut.pro/api/v1/personas/$PERSONA_ID/save \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ana" }'

Envía el video de origenCopy Anchor Link

Un video que ya está en la biblioteca no necesita este paso: usa su id como media_id. Para un archivo nuevo, pide la URL, envía y confirma. Solo MP4 y MOV, dentro de video_limits.

curl -X POST https://api.cut.pro/api/v1/personas/sources/upload \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "file_name": "video.mp4", "file_size": 8421337, "content_type": "video/mp4" }'

curl -X PUT "$UPLOAD_URL" -H "Content-Type: video/mp4" --upload-file video.mp4

curl -X POST https://api.cut.pro/api/v1/personas/sources/upload/complete \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "media_id": "7412908365112823", "file_name": "video.mp4" }'

Pide el precioCopy Anchor Link

curl "https://api.cut.pro/api/v1/personas/swap/quote?media_id=7412908365112823&quality=standard&replace=head" \
  -H "X-Api-Key: $CUTPRO_API_KEY"

{ "media_id": "7412908365112823", "quality": "standard", "replace": "head", "style": null, "seconds": 8.4, "credits": 81 }

No se cobra nada. Muéstrale el precio a la persona y espera el sí.

El precio depende solo de la calidad, de la duración y del estilo. head y person cuestan lo mismo. Un video rechazado en standard puede caber en high.

Genera el videoCopy Anchor Link

Envía los credits del precio, con la misma quality, replace y style. La respuesta es 202 con status: processing.

curl -X POST https://api.cut.pro/api/v1/personas/$PERSONA_ID/videos \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "swap", "media_id": "7412908365112823", "quality": "standard", "replace": "head", "credits": 81 }'

Si el precio cambió, no se cobra nada y la respuesta es 409 PRICE_CHANGED con el valor correcto en extra.credits.

De forma predeterminada, quien se convierte en la persona es la persona principal del video. Para elegir a otra, envía target:

• una persona vista en el video: { "seconds": 2.5, "x": 0.62, "y": 0.48 }, con el momento y el centro de ella de 0 a 1. box es opcional y ayuda cuando hay gente cerca.
• quien está filmando: { "camera": true }.

Elegir a la persona nunca aumenta el precio confirmado. Si no hay nadie en ese punto, el video termina en failed con TARGET_NOT_A_PERSON y los créditos vuelven.

Consulta GET /personas/{id}/videos/{videoId} cada 10 segundos.

• ready: download_url tiene el MP4, válido por 6 horas. Para publicar o renderizar, POST /generations/{videoId}/edit devuelve el edit_id que va en POST /posts o POST /renders.
• failed: el motivo está en error_code y los créditos ya volvieron.