Nude AI API | 脱衣 API

授权

在每个请求的 Authorization 头中传递您的 API 密钥。

Authorization: Bearer <your_api_key>

脱衣 API

创建脱衣任务

POST /api/v1/undress

接受源图像、图像蒙版和一种风格。

源图像应为 base64 编码的 jpeg 格式图像，蒙版应为 base64 编码的 png 格式图像。蒙版应包含两种颜色：白色表示需要脱衣的区域，黑色表示图像的其余部分。

可用风格：standard premium premium_v2 video

video 是一种特殊风格，生成脱衣动画视频作为结果。

Premium v2 选项

使用 premium_v2 时，您可以选择性地指定身体自定义选项：

参数	类型	描述
`body_shape`	string \| null	`null`（正常）、`fat`、`skinny`、`athletic`
`boobs`	string \| null	`null`（正常）、`small`、`large`
`hair`	string \| null	`null`（正常）、`hairy`、`shaved`

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

请求示例：

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

使用自动蒙版生成的请求示例：

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

生成动画脱衣的请求示例：

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

对于视频生成，您可以使用 parent 参数发送请求，生成脱去下一件衣物的视频，该参数的值应等于上一个结果的 id 响应字段。

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

响应：

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

400 {"error": "no_credits"}

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

动画脱衣换脸视频

POST /api/v1/undress_face_swap_video

对于动画脱衣，您可以选择对结果运行免费的换脸操作，以改善（通常情况下）面部一致性。通常需要 60-120 秒完成。

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

响应：

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

您可以使用提供的 id 和标准的换脸视频端点来检查换脸视频的状态。

当换脸视频完成后，您可以使用以下端点获取脱衣换脸视频的状态，以检索生成的脱衣结果的 id，然后通过标准脱衣端点获取该结果。

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"

响应：

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

获取脱衣结果

GET /api/v1/undress/:id

返回生成的图像和生成的蒙版，或生成状态。

参数 image 已弃用，请使用 result。

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

响应：

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

200 {"status": "pending"}

200 {"status": "failed"}

404 {"error": "NOT_FOUND"}

换脸 API

创建换脸任务

POST /api/v1/face_swaps

接受面部图像和目标图像。

面部图像和目标图像应为 base64 编码的 jpeg、webp 或 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>"}'

响应：

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

400 {"error": "no_credits"}

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

获取换脸结果

GET /api/v1/face_swaps/:id

返回生成的图像或生成状态。

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

响应：

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

200 {"status": "pending"}

200 {"status": "failed"}

404 {"error": "NOT_FOUND"}

视频换脸 API

付款要求 视频换脸 API 仅对累计付款达 100 美元或以上的用户开放。

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

分析视频

POST /api/v1/face_swap_videos/analyze

根据视频时长计算处理价格。

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

响应：

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

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

422 视频尺寸不得超过 1920x1080 — {"error": "ANALYSIS_FAILED", "details": "too_large"}

创建换脸视频

POST /api/v1/face_swap_videos

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

响应：

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

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

获取换脸视频状态

GET /api/v1/face_swap_videos/:id

检查换脸视频任务的状态，完成后获取结果 URL。

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

响应：

200 处理中

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

200 已完成

{
  "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

照片动画 API 可将静态照片转换为具有流畅自然运动的视频。

创建动画

POST /api/v1/animations

接受源图像和模板 ID 来创建动画任务。

源图像应为 base64 编码的数据 URI，格式为 jpeg、png 或 webp（例如 data:image/jpeg;base64,/9j/4AAQ...）。

可用模板

template_id 参数为必填项，用于确定动画风格。为保持向后兼容性，也接受 preset_id（已弃用）。

GET /api/v1/animation_templates（也可通过 /api/v1/animation_presets 访问，已弃用）

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

响应示例：

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

响应包含所有支持语言（en、de、es、pt、fr、ru、zh）的本地化名称。name 字段包含英文名称。每个 name_XX 字段包含对应语言的翻译，如未设置则回退为英文。

当前模板：

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

组合模板将两种动画风格合二为一，费用为 14 个积分而非 7 个。

请求示例：

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

响应：

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

400 {"error": "no_credits"}

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

获取动画结果

GET /api/v1/animations/:id

返回生成的视频 URL 或生成状态。

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

响应：

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

200 {"status": "pending"}

200 {"status": "failed"}

404 {"error": "NOT_FOUND"}

更新日志

日期	变更
15.03.2026	添加了组合动画模板（14 个积分）
24.02.2026	将动画预设重命名为动画模板；/api/v1/animation_presets 仍可使用（已弃用）
03.02.2026	为动画预设端点添加了本地化名称
02.02.2026	添加了动画预设列表端点
01.02.2026	照片动画 API 的重大更新
21.01.2026	添加了照片动画 API
21.01.2026	为 premium_v2 风格添加了 body_shape、boobs、hair 选项
19.12.2025	移除了基础照片换脸功能
13.12.2025	更新了关于脱衣视频的文档
12.12.2025	添加了创建脱衣视频的功能
11.12.2025	从 OpenAPI 规范中移除了旧版选项
26.09.2025	移除了关于不支持的脱衣风格的信息
30.12.2024	添加了 API 文档测试版的链接
27.12.2024	添加了视频换脸 API
10.12.2024	为换脸 API 添加了 version 字段
25.10.2024	添加了换脸 API
18.10.2024	添加了 premium v2 风格
21.09.2024	添加了 OpenAPI 规范的链接
21.09.2024	添加了关于自动蒙版生成的信息
16.09.2024	添加了价格页面的链接
11.05.2024	添加了 curl 使用示例
10.05.2024	更新了 API 文档以与当前版本同步

API 文档

API 密钥

授权

脱衣 API

创建脱衣任务

Premium v2 选项

动画脱衣换脸视频

获取脱衣结果

换脸 API

创建换脸任务

获取换脸结果

视频换脸 API

分析视频

创建换脸视频

获取换脸视频状态

照片动画 API

创建动画

可用模板

获取动画结果

更新日志