Generate Image
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
Request body
Quality tier (preferred): air | lite | premium | pro | max_pro. See GET /v1/tiers for the live menu and prices.
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.
LEGACY alias, still honored for backward compatibility: fast | cheap | quality | balanced. Ignored when tier is set — use tier instead.
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.
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.
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.
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.
What must NOT appear, e.g. "text, watermark, extra fingers".
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.
How far the render may travel from source_image_url. 0 keeps it, 1 ignores it.
Delivered file type: png | jpeg | webp. png is the one that carries transparency.
Transparent background, for logos and product cutouts. Forces png.
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.
Explicit pixel width; pass with height.
Explicit pixel height; pass with width.
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
Changes
No recorded changes to this operation across all 1 revision of this API.