Crie personas e troque a pessoa do vídeo

Leia o catálogoCopy Anchor Link

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

Crie a personaCopy Anchor Link

Mande uma opção por característica em chips. A foto começa a ser gerada e a resposta é 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"
    }
  }'

Com o rosto de quem usa. Envie as fotos antes e passe os ids em face_ids, em até 24 horas e até max_face_photos (6). JPEG, PNG, WebP ou HEIC de até 10 MB. own_face_adult: true confirma que a foto é de quem usa e que essa pessoa tem 18 anos ou mais.

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"

Com face_ids, só as características de face_photo_groups continuam valendo, e nelas a opção photo mantém o traço como está nas fotos.

De um personagem pronto, de graça. GET /personas/presets lista personagens com a foto já feita (category: weird, cartoon, creator ou influencers). Criar de um deles não gera nada e já nasce com 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" }'

Com name, a persona já sai salva. Sem name, é um rascunho para salvar depois. Ela continua sendo aquele personagem: num regenerate, os chips são ignorados e só a note edita. PUT /personas/presets/{presetId}/favorite com { "favorite": true } marca favoritos.

Ajuste e salveCopy Anchor Link

Consulte GET /personas/{id} a cada 5 segundos até image_status virar ready, ou failed com o motivo em error_code.

Para mudar a foto, gere de novo com outros chips ou edite com uma note de uma linha, que mantém a mesma pessoa:

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" }'

Uma edição com note custa pricing.photo_with_references_credits. Se outra foto já está sendo gerada, a resposta é 409 CARD_LOCKED.

Quando a foto estiver boa, salve. Numa persona salva, a mesma chamada só renomeia.

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" }'

Envie o vídeo de origemCopy Anchor Link

Um vídeo que já está na biblioteca dispensa este passo: use o id dele como media_id. Para um arquivo novo, peça a URL, envie e confirme. Só MP4 e 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" }'

Peça o preçoCopy 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 }

Nada é cobrado. Mostre o preço à pessoa e espere o sim.

O preço depende só da qualidade, da duração e do estilo. head e person custam o mesmo. Um vídeo recusado em standard pode caber em high.

Gere o vídeoCopy Anchor Link

Mande os credits do preço, com a mesma quality, replace e style. A resposta é 202 com 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 }'

Se o preço mudou, nada é cobrado e a resposta é 409 PRICE_CHANGED com o valor certo em extra.credits.

Por padrão, quem vira a persona é a pessoa principal do vídeo. Para escolher outra, mande target:

• uma pessoa vista no vídeo: { "seconds": 2.5, "x": 0.62, "y": 0.48 }, com o momento e o centro dela de 0 a 1. box é opcional e ajuda quando há gente perto.
• quem está filmando: { "camera": true }.

Escolher a pessoa nunca aumenta o preço confirmado. Se não há ninguém no ponto, o vídeo termina em failed com TARGET_NOT_A_PERSON e os créditos voltam.

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

• ready: download_url tem o MP4, válido por 6 horas. Para postar ou renderizar, POST /generations/{videoId}/edit devolve o edit_id que vai em POST /posts ou POST /renders.
• failed: o motivo está em error_code e os créditos já voltaram.