Colour Drop API

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

Example request

curl -X POST https://thenewblack.ai/api/v1/generate \
  -H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "motion_colour_drop-v1",
    "slot_1": "https://example.com/image.jpg",
    "slot_2": "https://example.com/image.jpg",
    "slot_3": "https://example.com/image.jpg",
    "slot_4": "https://example.com/image.jpg",
    "fields": {
      "title": "ESSENTIALS",
      "subtitle": "THE CORE COLLECTION",
      "tag_1": "HEAVYWEIGHT",
      "tag_2": "100% COTTON",
      "tag_3": "480 GSM",
      "tag_4": "OVERSIZED FIT",
      "footer": "BUY 2 OR MORE — 15% OFF",
      "background": "#EDEDE6",
      "colour_1": "#D9A3A8",
      "colour_2": "#C9A58A",
      "colour_3": "#8FAF9A",
      "colour_4": "#B8A98E"
    },
    "duration": "10",
    "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": "motion_colour_drop",
  "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