Imagen Customize

Live

imageedit

Subject- or style-customized generation from reference images.

Endpoint

POSThttps://brahmand-api.bulletshorts.co/v1/image/imagen-customize

Authenticate with the X-API-Key request header.

Pricing

6 credits / image1 credit = ₹1. Billed on success: per image.

List price. Volume / bulk customers get a discounted rate — contact us for account pricing.

Parameters

Name	Type	Required	Description	Default / options
prompt	string	required	Text prompt describing the desired output.	—
reference_image_urls	string[]	required	Reference images of the subject or style.	—
type	string	optional	Customization target.	default: `subject` `subjectstyle`
subject_type	string	optional	Subject category hint: SUBJECT_TYPE_DEFAULT \| SUBJECT_TYPE_PERSON \| SUBJECT_TYPE_ANIMAL \| SUBJECT_TYPE_PRODUCT.	default: `SUBJECT_TYPE_DEFAULT`
description	string	optional	Optional extra description of the reference subject.	—
sample_count	number	optional	Number of images to generate (1-4).	default: `1`
negative_prompt	string	optional	Things to avoid in the output.	—
guidance_scale	number	optional	Prompt-adherence strength.	—
seed	number	optional	RNG seed (0-4294967295) for deterministic output. Forces add_watermark off when set.	—
add_watermark	boolean	optional	Add SynthID watermark. Cannot be combined with seed.	default: `true`
person_generation	string	optional	Allow people in output: dont_allow \| allow_adult \| allow_all.	default: `allow_adult`
safety_setting	string	optional	Safety filter: block_low_and_above \| block_medium_and_above \| block_only_high \| block_none.	—

Request

curl

curl -X POST https://brahmand-api.bulletshorts.co/v1/image/imagen-customize \
  -H "X-API-Key: $TRINETRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"the cat wearing a tiny wizard hat","reference_image_urls":["https://example.com/cat1.jpg","https://example.com/cat2.jpg"],"type":"subject"}'

request body (JSON)

{
  "prompt": "the cat wearing a tiny wizard hat",
  "reference_image_urls": [
    "https://example.com/cat1.jpg",
    "https://example.com/cat2.jpg"
  ],
  "type": "subject"
}

Response

Submitting a job returns 202 Accepted with a job id. Poll GET /v1/jobs/{id} until the job reaches a terminal state, or register a webhook to be notified.

202 Accepted

{
  "job_id": "job_imagencustomize_a1b2c3",
  "status": "queued"
}

GET /v1/jobs/{id} → succeeded

{
  "id": "job_imagencustomize_a1b2c3",
  "model": "imagen-customize",
  "status": "succeeded",
  "output": {
    "outputs": [
      {
        "url": "https://cdn.trinetra.ai/out/imagen-customize/a1b2c3.png",
        "type": "image"
      }
    ]
  },
  "credits_charged": 10
}

Webhook: set a webhook_url on your API key to receive a POST with the terminal job document instead of polling.