AI Fashion Video API

Animate a fashion image into a short video: the start frame is yours, the motion is prompted, billing is per second.

POST/v1/generateworkflow: freeform_video-v1

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

Parameter	Value for this workflow
workflow	"freeform_video-v1" required
prompt	Describe the creation or the change — English works best.
start_image	Start frame — one public HTTPS URL.
duration	5 · 10 (seconds)
end_image	Optional closing frame — one public HTTPS URL.
tier	"standard" (1 cr/s) or "pro" (3 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": "freeform_video-v1",
    "prompt": "The model walks toward the camera, fabric flowing",
    "start_image": "https://example.com/start-frame.jpg",
    "duration": "5",
    "tier": "standard"
  }'

Example response

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

// 200 OK
{
  "generation_id": "3f1c9a6e-...",
  "workflow": "freeform_video",
  "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 video endpoint need?

A start image URL, a motion prompt, and a duration from the allowed list. The output keeps the image's aspect ratio.

How is video billed?

Per second of output — see the per-second standard and pro prices in the catalogue.

How much does it cost?

1 credit per second on the standard tier, 3 per second on pro. Credits come with plans and packs; a failed generation is always refunded.

Affiliation & Blog

Contact

Legal