Flux Kontext Pro · Text to Image

Generate images from text prompts with Flux Kontext Pro through the unified SeeAPI generation endpoint. Submit a request, then use the returned generation ID to track status and retrieve the final assets.

Developer API pricing

Provider: SeeAPI

USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.

Price: 8 credits/gen (≈ $0.03/gen)

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

For production integrations, provide callback_url to receive terminal status updates instead of polling continuously.

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key

Request

POST/v1/generations

AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

A unique key for this request. Reuse the same value only when retrying an identical request body; use a new value for a different generation.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

The public model ID documented on this page. Use flux-kontext-pro for this Endpoint.

Allowed:flux-kontext-pro

Default:: flux-kontext-pro
Example:: flux-kontext-pro

stringrequired

The model capability to invoke. Use text-to-image for this page.

Allowed:text-to-image

Default:: text-to-image
Example:: text-to-image

stringoptional

Optional public provider ID. Omit this field to use the default provider, seeapi; supported values are seeapi and replicate.

Allowed:seeapireplicate

Default:: seeapi
Example:: seeapi

objectrequired

Provider-specific generation settings. Include only fields listed under the selected provider.

Provider parameters

SeeAPIseeapiDefault Provider

stringrequired

Describe the image to generate, including subject, composition, style, lighting, and other important visual details.

max length: 2000

Example:: A modern glass pavilion in a misty pine forest, soft morning light, cinematic architectural photography

stringoptional

Select the output width-to-height ratio of the generated image.

Allowed:21:916:94:31:13:49:16

Default:: 1:1

stringoptional

Choose the file format used for the generated image asset.

Allowed:jpegpng

Default:: jpeg

booleanoptional

Enable prompt upsampling to enhance the prompt before generation.

Default:: false

booleanoptional

Enable automatic prompt translation before generation.

Default:: true

numberoptional

Set the Provider safety tolerance for this request.

min: 0max: 6

Default:: 2

Replicatereplicate

stringrequired

Describe the image to generate, including subject, composition, style, lighting, and other important visual details.

max length: 2000

Example:: A cinematic city at night

stringoptional

Select the output width-to-height ratio of the generated image.

Allowed:1:116:99:164:33:43:22:34:55:421:99:212:11:2

Default:: 1:1

stringoptional

Choose the file format used for the generated image asset.

Allowed:jpgpng

Default:: png

numberoptional

Set a seed to make repeated requests more reproducible, or omit it to let the Provider choose a seed.

min: 0max: 999999

booleanoptional

Enhance the prompt before generation.

Default:: false

numberoptional

Set the upstream safety tolerance.

min: 0max: 6

Default:: 2

string <uri>optional

An absolute HTTPS endpoint that receives terminal generation updates. Omit it if your application will poll the task details endpoint.

max length: 2048

Example:: https://client.example.com/webhooks/seeapi

Responses

202The request was accepted and a new generation task is processing.

Bodyapplication/json

Store generation.id and query the task details endpoint until a terminal status is returned, unless callback_url is configured.

objectrequired

The generation task created for this request.

stringrequired

Unique generation ID used to query task status and retrieve results.

Example:: task_xxx

stringrequired

Model ID used for the generation.

Example:: flux-kontext-pro

stringrequired

Endpoint ID used for the generation.

Example:: text-to-image

stringrequired

Public provider selected to process the generation.

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Current lifecycle status of the generation.

Allowed:processing

Example:: processing

numberrequired

Estimated credits for the generation at task creation.

Example:: 8

numberrequired

Credits consumed by the generation so far.

Example:: 0

numberrequired

Credits refunded for the generation so far.

Example:: 0

string <date-time>required

UTC timestamp when the generation was created.

Example:: 2026-08-18T10:00:00Z

string <date-time>required

UTC timestamp when the generation was last updated.

Example:: 2026-08-18T10:00:00Z

booleanrequired

True when this response reuses an earlier generation for the same idempotency key.

Example:: false

200The idempotency key matched an existing request, so the existing generation is returned instead of creating a duplicate.

Bodyapplication/json

Continue tracking the returned generation ID; do not create another request solely because the task is still processing.

objectrequired

The generation task created for this request.

stringrequired

Unique generation ID used to query task status and retrieve results.

Example:: task_xxx

stringrequired

Model ID used for the generation.

Example:: flux-kontext-pro

stringrequired

Endpoint ID used for the generation.

Example:: text-to-image

stringrequired

Public provider selected to process the generation.

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Current lifecycle status of the generation.

Allowed:processing

Example:: processing

numberrequired

Estimated credits for the generation at task creation.

Example:: 8

numberrequired

Credits consumed by the generation so far.

Example:: 0

numberrequired

Credits refunded for the generation so far.

Example:: 0

string <date-time>required

UTC timestamp when the generation was created.

Example:: 2026-08-18T10:00:00Z

string <date-time>required

UTC timestamp when the generation was last updated.

Example:: 2026-08-18T10:00:00Z

booleanrequired

True when this response reuses an earlier generation for the same idempotency key.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Code Examples

Request

const response = await fetch("https://api.seeapi.com/v1/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": "order-20260818-001",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "model": "flux-kontext-pro",
  "endpoint": "text-to-image",
  "provider": "seeapi",
  "input": {
    "prompt": "A modern glass pavilion in a misty pine forest, soft morning light, cinematic architectural photography",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "prompt_upsampling": false,
    "enable_translation": true,
    "safety_tolerance": 2
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "flux-kontext-pro",
    "endpoint": "text-to-image",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 8,
    "consumed_credits": 0,
    "refunded_credits": 0,
    "created_at": "2026-08-18T10:00:00Z",
    "updated_at": "2026-08-18T10:00:00Z"
  },
  "idempotent": false
}

const response = await fetch("https://api.seeapi.com/v1/generations", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Idempotency-Key": "order-20260818-001", "Content-Type": "application/json" }, body: JSON.stringify({ "model": "flux-kontext-pro", "endpoint": "text-to-image", "provider": "seeapi", "input": { "prompt": "A modern glass pavilion in a misty pine forest, soft morning light, cinematic architectural photography", "aspect_ratio": "1:1", "output_format": "jpeg", "prompt_upsampling": false, "enable_translation": true, "safety_tolerance": 2 }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

{ "generation": { "id": "task_xxx", "model": "flux-kontext-pro", "endpoint": "text-to-image", "provider": "seeapi", "status": "processing", "estimated_credits": 8, "consumed_credits": 0, "refunded_credits": 0, "created_at": "2026-08-18T10:00:00Z", "updated_at": "2026-08-18T10:00:00Z" }, "idempotent": false }

Responses

202The request was accepted and a new generation task is processing.

Bodyapplication/json

Store generation.id and query the task details endpoint until a terminal status is returned, unless callback_url is configured.

objectrequired

The generation task created for this request.

stringrequired

Unique generation ID used to query task status and retrieve results.

Example:: task_xxx

stringrequired

Model ID used for the generation.

Example:: flux-kontext-pro

stringrequired

Endpoint ID used for the generation.

Example:: text-to-image

stringrequired

Public provider selected to process the generation.

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Current lifecycle status of the generation.

Allowed:processing

Example:: processing

numberrequired

Estimated credits for the generation at task creation.

Example:: 8

numberrequired

Credits consumed by the generation so far.

Example:: 0

numberrequired

Credits refunded for the generation so far.

Example:: 0

string <date-time>required

UTC timestamp when the generation was created.

Example:: 2026-08-18T10:00:00Z

string <date-time>required

UTC timestamp when the generation was last updated.

Example:: 2026-08-18T10:00:00Z

booleanrequired

True when this response reuses an earlier generation for the same idempotency key.

Example:: false

200The idempotency key matched an existing request, so the existing generation is returned instead of creating a duplicate.

Bodyapplication/json

Continue tracking the returned generation ID; do not create another request solely because the task is still processing.

objectrequired

The generation task created for this request.

stringrequired

Unique generation ID used to query task status and retrieve results.

Example:: task_xxx

stringrequired

Model ID used for the generation.

Example:: flux-kontext-pro

stringrequired

Endpoint ID used for the generation.

Example:: text-to-image

stringrequired

Public provider selected to process the generation.

Allowed:seeapireplicate

seeapi: SeeAPI
replicate: Replicate

Example:: seeapi

stringrequired

Current lifecycle status of the generation.

Allowed:processing

Example:: processing

numberrequired

Estimated credits for the generation at task creation.

Example:: 8

numberrequired

Credits consumed by the generation so far.

Example:: 0

numberrequired

Credits refunded for the generation so far.

Example:: 0

string <date-time>required

UTC timestamp when the generation was created.

Example:: 2026-08-18T10:00:00Z

string <date-time>required

UTC timestamp when the generation was last updated.

Example:: 2026-08-18T10:00:00Z

booleanrequired

True when this response reuses an earlier generation for the same idempotency key.

Example:: false

400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable