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 premium_v3

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

Premium v3

Premium v3 utiliza o mais recente modelo de IA a 2.0 MP de resolução. A máscara é gerada automaticamente. Apenas precisa fornecer a imagem de origem. Custa 10 créditos.

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>", "style": "premium_v3"}'

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 Combo Price (credits)
3 Reverse Cowgirl No 7
4 Face Sitting No 7
5 Breast Expansion No 7
6 Doggy Style No 7
8 Cumshot on the face No 7
9 Foot Show No 7
12 Pet Play No 7
13 Squirt No 7
30 Breast Play No 7
16 Breast Play Solo No 7
17 Spooning No 7
18 Deep Throat BBC No 7
19 Blowjob No 7
21 Double Blowjob No 7
7 Dildo Handjob No 7
24 Handjob No 7
26 Two-Hand Handjob No 7
29 Standing Doggy No 7
33 Sex Machine No 7
36 Pussy Fingering No 7
38 Doggy POV No 7
1 Missionary POV No 7
45 Missionary Side View No 7
28 Kissing No 7
46 Lesbian Kissing No 7
47 Gay Kissing No 7
48 Smoking No 7
49 Blowjob POV No 7
79 Ahegao No 7
55 Pregnant No 7
56 Deep Throat with Cumshot BBC Yes 14
57 Two Guys Handjob No 7
58 Rough Blowjob No 7
73 Kissing & Undressing No 7
75 Pussy Rubbing No 7
76 Pussy rubbing with creampie Yes 14
77 Riding the gear shift No 7

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

400 Analise falhou — menor detectado:

{"error": "analysis_failed", "error_details": {"code": "face.child", "underage_persons": [{"age": 17.6, "face": {"x1": 36, "x2": 99, "y1": 103, "y2": 176}, "body": {"x1": 1, "x2": 170, "y1": 72, "y2": 735}}]}}

400 Analise falhou — nenhum rosto encontrado:

{"error": "analysis_failed", "error_details": {"code": "no_face_found"}}

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"} — erro do sistema ou falha desconhecida

200 Falhou — menor detectado:

{"status": "failed", "error_details": {"code": "face.child", "underage_persons": [{"age": 17.6, "face": {"x1": 36, "x2": 99, "y1": 103, "y2": 176}, "body": {"x1": 1, "x2": 170, "y1": 72, "y2": 735}}]}}

200 Falhou — nenhum rosto encontrado:

{"status": "failed", "error_details": {"code": "no_face_found"}}

404 {"error": "NOT_FOUND"}

Registo de alterações

Data Alteração
07.04.2026 Premium v3 simplificado para um unico estilo premium_v3 a 2.0 MP, 10 creditos fixos
01.04.2026 Adicionados estilos Premium v3
28.03.2026 Adicionado error_details às respostas da API de animação (deteção de menores e rosto não encontrado)
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