Reimagine Model API

Keep the garment, change everything else: new model, new pose, new scene — from one existing photo.

POST/v1/generateworkflow: reimagine_scene-v1

One endpoint serves every workflow — this page documents reimagine_scene-v1, the current version. Credits are debited at submission (1 cr standard, 3 cr 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	"reimagine_scene-v1" required
model_image	Reference model — one public HTTPS URL.required
fields.scene	New scene. The new scene and model, e.g. "same dress, new model walking in Paris at dusk".required
ratio	9:16 · 1:1 · 3:4 · 2:3 · auto · 4:3 · 3:2 · 4:5 · 16:9 · 5:4 · 21:9
tier	"standard" (1 cr) or "pro" (3 cr)
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": "reimagine_scene-v1",
    "model_image": "https://example.com/model.jpg",
    "fields": {
      "scene": "same dress, new model walking in Paris at dusk"
    },
    "ratio": "9:16",
    "tier": "standard"
  }'

Example response

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

// 200 OK
{
  "generation_id": "3f1c9a6e-...",
  "workflow": "reimagine_scene",
  "status": "succeeded",
  "result": {
    "type": "image",
    "url": "https://.../result.webp",
    "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 reimagine endpoint keep?

The clothing stays faithful to the input photo; the model, pose, background and light follow your prompt.

How much does it cost?

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

Affiliation & Blog

Contact

Legal