Documentação da API

Integre funcionalidades de undress, troca de rosto e animação na sua aplicação.

Chaves de API

Inicie sessão para criar e gerir as suas chaves de API.

Iniciar sessão

Autorização

Passe a sua chave de API no cabeçalho Authorization de cada pedido.

Authorization: Bearer <your_api_key>

API Undress

Criar Undress

POST /api/v1/undress

Aceita a imagem de origem, a máscara da imagem e um dos estilos.

A imagem de origem deve ser uma imagem codificada em base64 no formato jpeg, a máscara deve ser uma imagem codificada em base64 no formato png. A máscara deve conter 2 cores: branco para as regiões que devem ser despidas e preto para o resto da imagem.

Estilos disponíveis: standard premium premium_v2 video

video é um estilo especial que gera um vídeo de animação undress como resultado.

Opções Premium v2

Ao usar premium_v2, pode opcionalmente especificar opções de personalização do corpo:

Parâmetro Tipo Descrição
body_shape string | null null (normal), fat, skinny, athletic
boobs string | null null (normal), small, large
hair string | null null (normal), hairy, shaved

Exemplo de pedido com opções premium_v2:

curl -X POST https://deepstrip.com/api/v1/undress \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"source_image": "<base64_encoded_image>", "automask": true, "style": "premium_v2", "body_shape": "athletic", "boobs": "large", "hair": "shaved"}'

Exemplo de pedido:

curl -X POST https://deepstrip.com/api/v1/undress \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"source_image": "<base64_encoded_image>", "mask": "<base64_encoded_mask>", "style": "standard"}'

Exemplo de pedido com geração automática de máscara:

curl -X POST https://deepstrip.com/api/v1/undress \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"source_image": "<base64_encoded_image>", "automask": true, "style": "standard"}'

Exemplo de pedido para gerar Undress Animado:

curl -X POST https://deepstrip.com/api/v1/undress \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"source_image": "<base64_encoded_image>", "style": "video"}'

Para geração de vídeo, pode enviar um pedido para gerar um vídeo com undress da próxima peça de roupa usando o parâmetro parent, que deve ser igual ao campo id da resposta do resultado anterior.

curl -X POST https://deepstrip.com/api/v1/undress \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"parent": "<id-of-the-response>"}'

Respostas:

201 {"id": "69d280ab-42c5-4f49-9881-51076afb1747"}

400 {"error": "no_credits"}

400 {"error": "invalid_params", "errors": ["Image is invalid"]}


Troca de Rosto em Vídeo de Undress Animado

POST /api/v1/undress_face_swap_video

Para undress animado, pode opcionalmente executar uma troca de rosto gratuita no resultado para melhorar (geralmente) a consistência do rosto. Normalmente demora 60-120 segundos a completar.

curl -X POST https://deepstrip.com/api/v1/undress_face_swap_video \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"undress_id": "<id-of-the-undress>"}'

Respostas:

201

{
  "id": "69d280ab-42c5-4f49-9881-51076afb1747",
  "face_swap_video_id": "35b4a4a8-e5e6-4613-b1a3-d538b8698d06",
  "undress_id": "69968efe-556d-4805-87bd-1556a49f4e37",
  "undress_result_id": null
}

404 {"error": "NOT_FOUND"}

Pode verificar o estado da troca de rosto em vídeo usando o id fornecido e o endpoint padrão de troca de rosto em vídeo para obter o estado.

Quando a troca de rosto em vídeo estiver concluída, pode obter o estado da troca de rosto em vídeo de undress usando o seguinte endpoint para recuperar o id do undress resultante e consultá-lo usando o endpoint padrão de undress.

GET /api/v1/undress_face_swap_video/:id

curl https://deepstrip.com/api/v1/undress_face_swap_video/<identifier> \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json"

Respostas:

200

{
  "id": "69d280ab-42c5-4f49-9881-51076afb1747",
  "face_swap_video_id": "35b4a4a8-e5e6-4613-b1a3-d538b8698d06",
  "undress_id": "69968efe-556d-4805-87bd-1556a49f4e37",
  "undress_result_id": "616c2b43-c432-416d-8ecb-470a670fbdee"
}

404 {"error": "NOT_FOUND"}


Obter Resultado do Undress

GET /api/v1/undress/:id

Retorna a imagem gerada e a máscara gerada ou o estado da geração.

O parâmetro image está descontinuado em favor de result.

curl https://deepstrip.com/api/v1/undress/<identifier> \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json"

Respostas:

200 {"status": "completed", "image": "<result url>", "result": "<result url>"}

200 {"status": "pending"}

200 {"status": "failed"}

404 {"error": "NOT_FOUND"}

API FaceSwap

Criar FaceSwap

POST /api/v1/face_swaps

Aceita a imagem do rosto e a imagem de destino.

As imagens do rosto e de destino devem ser imagens codificadas em base64 no formato jpeg, webp ou png.

curl -X POST https://deepstrip.com/api/v1/face_swaps \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"image": "<base64_encoded_image>", "face": "<base64_encoded_face>"}'

Respostas:

201 {"id": "69d280ab-42c5-4f49-9881-51076afb1747"}

400 {"error": "no_credits"}

400 {"error": "invalid_params", "errors": ["Image is invalid"]}


Obter Resultado do FaceSwap

GET /api/v1/face_swaps/:id

Retorna a imagem gerada ou o estado da geração.

curl https://deepstrip.com/api/v1/face_swaps/<identifier> \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json"

Respostas:

200 {"status": "completed", "image": "<result image url>"}

200 {"status": "pending"}

200 {"status": "failed"}

404 {"error": "NOT_FOUND"}

API Face Swap Vídeos

Requisito de pagamento A API de troca de rosto em vídeos está disponível apenas para utilizadores que tenham efetuado pagamentos de $100 ou mais.

402 {"error": "PAYMENT_REQUIRED", "message": "Face swap video API requires a completed payment of $100 or more"}


Analisar Vídeo

POST /api/v1/face_swap_videos/analyze

Calcular o preço de processamento de um vídeo com base na sua duração.

curl -X POST https://deepstrip.com/api/v1/face_swap_videos/analyze \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://example.com/video.mp4", "preview": false, "version": "v2"}'

Respostas:

200 {"price": 4.0, "duration": 20}

400 {"error": "INVALID_VIDEO_URL", "details": ["must be a valid URL", "must use HTTPS"]}

422 as dimensões do vídeo não devem exceder 1920x1080 — {"error": "ANALYSIS_FAILED", "details": "too_large"}


Criar Troca de Rosto em Vídeo

POST /api/v1/face_swap_videos

Criar um novo trabalho de troca de rosto em vídeo usando URL.

curl -X POST https://deepstrip.com/api/v1/face_swap_videos \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"video_url": "https://example.com/video.mp4", "face_url": "https://example.com/face.jpg", "preview": false, "version": "v2"}'

Respostas:

201 {"id": "69d280ab-42c5-4f49-9881-51076afb1747", "status": "created", "message": "Face swap video creation started"}

400 {"error": "VALIDATION_ERROR", "details": ["Video is required"]}


Obter Estado da Troca de Rosto em Vídeo

GET /api/v1/face_swap_videos/:id

Verificar o estado de um trabalho de troca de rosto em vídeo e obter o URL do resultado quando concluído.

curl https://deepstrip.com/api/v1/face_swap_videos/<identifier> \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json"

Respostas:

200 Em processamento

{
  "id": "69d280ab-42c5-4f49-9881-51076afb1747",
  "status": "processing",
  "progress": 45.5,
  "step": "working",
  "result_url": null,
  "error_details": null
}

200 Concluído

{
  "id": "69d280ab-42c5-4f49-9881-51076afb1747",
  "status": "completed",
  "progress": 100.0,
  "step": "uploading",
  "result_url": "https://assets.nodress.ai/videos/result.mp4",
  "error_details": null
}

404 {"error": "NOT_FOUND"}

API Animar Foto

A API Animar Foto converte fotos estáticas em vídeos com movimento suave e natural.

Criar Animação

POST /api/v1/animations

Aceita uma imagem de origem e um ID de template para criar um trabalho de animação.

A imagem de origem deve ser um data URI codificado em base64 no formato jpeg, png ou webp (ex.: data:image/jpeg;base64,/9j/4AAQ...).

Templates Disponíveis

O parâmetro template_id é obrigatório e determina o estilo da animação. preset_id também é aceite para compatibilidade retroativa (descontinuado).

GET /api/v1/animation_templates (também disponível em /api/v1/animation_presets, descontinuado)

curl https://deepstrip.com/api/v1/animation_templates

Exemplo de resposta:

[{"id": 1, "name": "Missionary POV", "name_de": "Missionarsstellung POV", "name_es": "Misionero POV", ..., "combo": false, "price": 7}, ...]

A resposta inclui nomes localizados para todos os idiomas suportados (en, de, es, pt, fr, ru, zh). O campo name contém o nome em inglês. Cada campo name_XX contém a tradução para esse idioma, recorrendo ao inglês se não estiver definido.

Templates atuais:

ID Name
3 Reverse Cowgirl
4 Face Sitting
5 Breast Expansion
6 Doggy Style
8 Cumshot on the face
9 Foot Show
12 Pet Play
13 Squirt
30 Breast Play
16 Solo Breast Play
17 Spooning
18 BBC Deep Throat
19 Blowjob
21 Double Blowjob
7 Dildo Handjob
24 Handjob
26 Double Handjob
29 Standing Doggy
33 Sex Machine
36 Masturbation
38 Doggy POV
1 Missionary POV
45 Missionary Side View
28 Kissing
46 Lesbian Kissing
47 Gay Kissing
48 Smoking
49 Blowjob POV
55 Pregnant

Os templates combo combinam dois estilos de animação e custam 14 créditos em vez de 7.

Exemplo de pedido:

curl -X POST https://deepstrip.com/api/v1/animations \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"source_image": "<base64_encoded_image>", "template_id": 1}'

Respostas:

201 {"id": "69d280ab-42c5-4f49-9881-51076afb1747"}

400 {"error": "no_credits"}

400 {"error": "invalid_params", "errors": ["Input is invalid"]}


Obter Resultado da Animação

GET /api/v1/animations/:id

Retorna o URL do vídeo gerado ou o estado da geração.

curl https://deepstrip.com/api/v1/animations/<identifier> \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json"

Respostas:

200 {"status": "completed", "result": "<result video url>"}

200 {"status": "pending"}

200 {"status": "failed"}

404 {"error": "NOT_FOUND"}

Registo de alterações

Data Alteração
15.03.2026 Adicionados templates de animação combo (14 créditos)
24.02.2026 Renomeados presets de animação para templates de animação; /api/v1/animation_presets continua a funcionar (descontinuado)
03.02.2026 Adicionados nomes localizados ao endpoint de presets de animação
02.02.2026 Adicionado endpoint de lista de presets de animação
01.02.2026 Atualização com alterações incompatíveis da API Animar Foto
21.01.2026 Adicionada API Animar Foto
21.01.2026 Adicionadas opções body_shape, boobs, hair para o estilo premium_v2
19.12.2025 Removida troca de rosto básica em fotos
13.12.2025 Atualizada documentação sobre vídeos de undress
12.12.2025 Adicionada capacidade de criar vídeos de undress
11.12.2025 Removidas opções legadas da especificação OpenAPI
26.09.2025 Removidas informações sobre estilos de undress não suportados
30.12.2024 Adicionado link para versão beta da documentação da API
27.12.2024 Adicionada API Face Swap Vídeos
10.12.2024 Adicionado campo version à API FaceSwap
25.10.2024 Adicionada API FaceSwap
18.10.2024 Adicionado estilo premium v2
21.09.2024 Adicionado link para especificação OpenAPI
21.09.2024 Adicionadas informações sobre geração automática de máscara
16.09.2024 Adicionado link para página de preços
11.05.2024 Adicionado exemplo de utilização com curl
10.05.2024 Documentação da API atualizada para sincronizar com a versão atual