images

Generate Image

post/v1/images/generate

Request

  • Base URL: https://api.corent.tech (the document declares no server; this is the origin it was published from)
  • URL: https://api.corent.tech/v1/images/generate
  • Auth: HTTP bearer

Headers

Idempotency-Keystring nullable

Request body

promptstring required
stylestring nullable
tierstring nullable

Quality tier (preferred): air | lite | premium | pro | max_pro. See GET /v1/tiers for the live menu and prices.

modelstring nullable

Direct model access: pin an exact model by name, e.g. "corent-flux-schnell". GET /v1/models publishes every name in that corent- spelling, and it is what meta.model and the receipt answer with; older spellings of the same model (the bare name, historical route names) are still accepted here, so existing integrations keep working. Bypasses smart routing -- no substitution, flat cost-plus pricing. Mutually exclusive with tier.

preferencestring

LEGACY alias, still honored for backward compatibility: fast | cheap | quality | balanced. Ignored when tier is set — use tier instead.

aspect_ratiostring
asyncboolean

When true, returns 202 with a job id immediately and renders in the background; poll GET /v1/jobs/{id} (or stream /v1/jobs/{id}/stream) for the result. Recommended for max_pro and other slow renders so a client-side timeout can never lose a finished image.

webhook_urlstring nullable
webhook_secretstring nullable
reference_image_urlsstring[] nullable

1 to 16 public https image URLs to keep a character, face or product consistent across generations. Each model takes its own number: GET /v1/models lists supports_reference_images and max_reference_images (for example 16 on corent-gpt-image-2-med, 10 on corent-seedream-4.0, 4 on the nano-banana edit models). Asking a model or tier for more than it takes is a 400 and nothing is billed. Omit for text-to-image.

ninteger

How many images to render, 1 to 10. Each one is a separate render and bills at the normal rate, so n=4 costs four images. They are produced concurrently and returned together; meta.cost_cents is the total for all of them.

seedinteger nullable

Reproducibility. The same seed with the same prompt and model gives the same image, so you can render it again and change one thing. The seed actually used comes back on the job even when you did not name one, where the provider reports it. Not every model supports it: meta.unsupported_options lists anything the chosen model could not honour.

negative_promptstring nullable

What must NOT appear, e.g. "text, watermark, extra fingers".

source_image_urlstring nullable

Image-to-image: start from this public https picture instead of from noise. Pair with strength. Different from reference_image_urls, which pins an identity on edit models.

strengthnumber nullable

How far the render may travel from source_image_url. 0 keeps it, 1 ignores it.

output_formatstring nullable

Delivered file type: png | jpeg | webp. png is the one that carries transparency.

transparentboolean

Transparent background, for logos and product cutouts. Forces png.

enhance_promptboolean

Corent rewrites your prompt before dispatch to get a better render. Set false to send it exactly as typed, which is what you want if you have already tuned it.

widthinteger nullable

Explicit pixel width; pass with height.

heightinteger nullable

Explicit pixel height; pass with width.

customer_idstring nullable

Optional tag for YOUR end user, so you can attribute spend: 1 to 128 characters from A-Z a-z 0-9 . _ : @ -. Stored on the job, returned on receipts, and filterable with GET /v1/account/usage?customer_id=...

Response

Successful Response

idstring required
statusstring required

Changes

No recorded changes to this operation across all 1 revision of this API.