alibabastable

Qwen Image 2.1 · Text to Image

Generate an image from a text prompt with Qwen Image 2.1. Choose the output resolution, aspect ratio and background, then retrieve the image when the asynchronous generation completes.

Developer API pricing

Provider: SeeAPI

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

1K: 5 credits/gen (≈ $0.019/gen)

2K: 10 credits/gen (≈ $0.037/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

Keep the returned generation ID and query task status until completion. A successful submission only confirms that the task was accepted; retrieve the image from the completed task result.

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 new, stable key for each generation request. Reuse it only when retrying the same request body.

max length: 255

Example:: order-20260818-001

Body Params

application/json

stringrequired

The model ID shown in the selected model's API documentation.

Allowed:qwen-image-2-1

Default:: qwen-image-2-1
Example:: qwen-image-2-1

stringrequired

Text to Image. Use the Endpoint ID shown in this model's API documentation.

Allowed:text-to-image

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

stringoptional

Optional public Provider ID. Omit it to use the Endpoint default Provider (seeapi).

Allowed:seeapi

Default:: seeapi
Example:: seeapi

objectrequired

Place the image generation parameters below inside this object.

Provider parameters

SeeAPIseeapiDefault Provider

stringrequired

Describe the subject, composition, style and any text to render. For a transparent output, describe the subject without adding a surrounding scene.

min length: 1max length: 5000

Example:: A small ceramic fox figurine

stringoptional

Choose the proportions of the generated image.

Choose a supported aspect ratio to match your intended layout, such as 1:1 for square images or 16:9 for landscape images.

Allowed:1:14:33:43:22:316:99:1621:99:21

Default:: 1:1

stringoptional

Choose the output resolution tier. This setting affects the credits required for the generation.

Resolution must be 1K or 2K

Allowed:1K2K

Default:: 1K

stringoptional

Choose an opaque image or a subject with a transparent background. Transparent output requires PNG or WebP.

Allowed:opaquetransparent

Default:: opaque
Example:: transparent

stringoptional

Choose the output file format. JPEG is only available with an opaque background.

Transparent backgrounds require PNG or WebP

Allowed:pngwebpjpeg

Default:: png
Example:: webp

booleanoptional

Enable automatic prompt rewriting before generation. Disable it when you want to submit your wording without prompt enhancement.

Default:: true

numberoptional

Optional integer seed. Omit it for a random seed; comparisons should use the same model version and generation settings.

booleanoptional

Enable the optional content safety check. API requests default to false.

Default:: false

string <uri>optional

An absolute HTTPS URL that receives the terminal generation Webhook.

max length: 2048

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

Responses

202Generation accepted for asynchronous processing. Save generation.id to query progress and retrieve the finished image.

Bodyapplication/json

objectrequired

stringrequired

Unique generation identifier. Use it to query task status and match completion events.

Example:: task_xxx

stringrequired

Example:: qwen-image-2-1

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task status. The submission response reports processing; query the task for its final result.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 5

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Time the generation was created.

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

string <date-time>required

Time the generation record was last updated.

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

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Unique generation identifier. Use it to query task status and match completion events.

Example:: task_xxx

stringrequired

Example:: qwen-image-2-1

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task status. The submission response reports processing; query the task for its final result.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 5

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Time the generation was created.

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

string <date-time>required

Time the generation record was last updated.

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

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON or input parameters. Check the parameter values and cross-field requirements before retrying.

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": "qwen-image-2-1",
  "endpoint": "text-to-image",
  "provider": "seeapi",
  "input": {
    "prompt": "A small ceramic fox figurine",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "background": "transparent",
    "output_format": "webp",
    "enhance_prompt": true,
    "nsfw_checker": false
  },
  "callback_url": "https://client.example.com/webhooks/seeapi"
})
});

const result = await response.json();

ResponseHTTP 202

{
  "generation": {
    "id": "task_xxx",
    "model": "qwen-image-2-1",
    "endpoint": "text-to-image",
    "provider": "seeapi",
    "status": "processing",
    "estimated_credits": 5,
    "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": "qwen-image-2-1", "endpoint": "text-to-image", "provider": "seeapi", "input": { "prompt": "A small ceramic fox figurine", "aspect_ratio": "1:1", "resolution": "1K", "background": "transparent", "output_format": "webp", "enhance_prompt": true, "nsfw_checker": false }, "callback_url": "https://client.example.com/webhooks/seeapi" }) }); const result = await response.json();

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

Responses

202Generation accepted for asynchronous processing. Save generation.id to query progress and retrieve the finished image.

Bodyapplication/json

objectrequired

stringrequired

Unique generation identifier. Use it to query task status and match completion events.

Example:: task_xxx

stringrequired

Example:: qwen-image-2-1

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task status. The submission response reports processing; query the task for its final result.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 5

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Time the generation was created.

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

string <date-time>required

Time the generation record was last updated.

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

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

200Idempotent replay of an existing generation request

Bodyapplication/json

objectrequired

stringrequired

Unique generation identifier. Use it to query task status and match completion events.

Example:: task_xxx

stringrequired

Example:: qwen-image-2-1

stringrequired

Example:: text-to-image

stringrequired

Allowed:seeapi

seeapi: SeeAPI

Example:: seeapi

stringrequired

Current task status. The submission response reports processing; query the task for its final result.

Allowed:processing

Example:: processing

numberrequired

Estimated public credits. Values can include up to three decimal places.

Example:: 5

numberrequired

Consumed public credits, with up to three decimal places.

Example:: 0

numberrequired

Refunded public credits, with up to three decimal places.

Example:: 0

string <date-time>required

Time the generation was created.

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

string <date-time>required

Time the generation record was last updated.

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

booleanrequired

Whether this response is an idempotent replay of an earlier request.

Example:: false

400

Invalid JSON or input parameters. Check the parameter values and cross-field requirements before retrying.

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