Outfit Transition Video API

One look becomes the other in a single move: two photos of the same model, one clip that switches between them.

POST/v1/generateworkflow: outfit_transition-v1

One endpoint serves every workflow — this page documents outfit_transition-v1, the current version. Credits are debited at submission (2.2 cr/s standard, 4.4 cr/s pro); a failed generation is refunded automatically. Earlier versions of this endpoint, if any, keep being served under their own names. This workflow needs an active plan.

Parameter	Value for this workflow
workflow	"outfit_transition-v1" required
start_image	First look — one public HTTPS URL.required
end_image	Second look — one public HTTPS URL.required
fields.transition	Transition. How the change happens — a quick spin, a snap of the fingers, a jump.
duration	5 (seconds)
tier	"standard" (2.2 cr/s) or "pro" (4.4 cr/s)
webhook_url	Optional — we POST the outcome here when the generation settles. Without it, poll the URL returned in the response until the status settles.

Example request

curl -X POST https://thenewblack.ai/api/v1/generate \
  -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "outfit_transition-v1",
    "start_image": "https://example.com/start-frame.jpg",
    "end_image": "https://example.com/image.jpg",
    "fields": {
      "transition": "a quick spin, the outfit changes mid-turn"
    },
    "duration": "5",
    "tier": "standard"
  }'

// 202 Accepted
{
  "generation_id": "3f1c9a6e-...",
  "status": "running",
  "poll": "/api/v1/generations/3f1c9a6e-..."
}

Example response

Poll /v1/generations/{id} (or receive the webhook) until the generation settles:

// 200 OK
{
  "generation_id": "3f1c9a6e-...",
  "workflow": "outfit_transition",
  "status": "succeeded",
  "result": {
    "type": "video",
    "url": "https://.../result.mp4",
    "thumbnail": "https://.../thumb.webp"
  }
}

Results are stored for 48 hours — copy them to your own storage. Authentication, errors and webhooks are documented in the full API reference.

Frequently asked questions

What does the transition endpoint need?

Two images: the first look and the second look, and a sentence describing the move that connects them.

What is it for?

Social clips — the outfit-change format that Reels and TikTok reward — made from two stills instead of a shoot.

How much does it cost?

2.2 credits per second on the standard tier, 4.4 per second on pro. Credits come with plans and packs; a failed generation is always refunded.

Other endpoints: Virtual Try-On API · AI Fashion Models API · Fashion Design API · Reimagine Model API · Swap Model API · AI Stylist API · all endpoints