Documentação da API
Integre funcionalidades de undress, troca de rosto e animação na sua aplicaçã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 |