> ## Documentation Index > Fetch the complete documentation index at: https://docs.pollo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Qwen Image 3 Pro API Documentation > Qwen Image 3 Pro API creates detailed images from complex prompts with refined composition, clear text, and reliable prompt adherence. It is designed for polished visuals with fine detail. Integrate the Qwen Image 3 Pro API now. Check out Qwen Image 3 Pro API pricing [here](https://api.pollo.ai/pricing?modelName=qwen-image-3-pro\&modelType=image), cheaper than Fal AI. ## OpenAPI ````yaml POST /v1/generation/qwen/qwen-image-3-pro/image openapi: 3.0.3 info: title: Pollo | AI Video Collection description: >- ✨RESTful API Document. Model discovery: GET /api/v1/model-specs (public, keyless). version: 1.0.0 servers: - url: https://pollo.ai/api/platform security: [] externalDocs: url: https://pollo.ai/api/platform/api/openapi.json paths: /v1/generation/qwen/qwen-image-3-pro/image: post: tags: - Image summary: qwen-image-3-pro operationId: v1-qwen/qwen-image-3-pro/image parameters: [] requestBody: required: true content: application/json: schema: type: object required: - input properties: input: oneOf: - type: object properties: images: type: array minItems: 1 items: type: string format: uri maxItems: 3 description: >- Reference image URLs (HTTP(S); base64 not allowed). Supported formats: JPG/JPEG, PNG. prompt: type: string maxLength: 4500 minLength: 1 description: Text prompt describing the content to generate. aspectRatio: type: string enum: - '1:1' - '3:4' - '4:3' - '16:9' - '9:16' default: '1:1' description: Output aspect ratio, as width:height (e.g. 16:9). resolution: type: string enum: - 1K - 2K default: 1K description: >- Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive. required: - images - prompt title: Image To Image - type: object properties: prompt: type: string maxLength: 4500 minLength: 1 description: Text prompt describing the content to generate. aspectRatio: type: string enum: - '1:1' - '3:4' - '4:3' - '16:9' - '9:16' default: '1:1' description: Output aspect ratio, as width:height (e.g. 16:9). resolution: type: string enum: - 1K - 2K default: 1K description: >- Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive. required: - prompt title: Text To Image webhookUrl: type: string format: uri description: >- Webhook URL (HTTP(S)) that receives status callbacks when the generation succeeds or fails. responses: '200': description: Successful response content: application/json: schema: type: object properties: taskId: type: string status: type: string enum: - waiting - succeed - failed - processing required: - taskId - status additionalProperties: false '400': $ref: '#/components/responses/ApiError400' '401': $ref: '#/components/responses/ApiError401' '403': $ref: '#/components/responses/ApiError403' '404': $ref: '#/components/responses/ApiError404' '429': $ref: '#/components/responses/ApiError429' '500': $ref: '#/components/responses/ApiError500' default: $ref: '#/components/responses/error' security: - ApiKeyAuth: [] components: responses: ApiError400: description: >- Invalid request — schema validation failed (`INPUT_VALIDATION_FAILED`, detail in `issues`), a cross-field constraint was violated (`INPUT_CONSTRAINT_VIOLATED`), or the input did not pass moderation (`MODERATION_*`). content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiError401: description: >- Missing or invalid credential (`CREDENTIAL_*`, `CLI_TOKEN_EXPIRED`, `EMAIL_LOGIN_REQUIRED`). content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiError403: description: >- Rejected — not enough credits (`CREDITS_INSUFFICIENT`), quota exhausted (`QUOTA_*`), plan required (`PLAN_FEATURE_REQUIRED`), account state (`ACCOUNT_*`), or no permission (`PERMISSION_DENIED`). content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiError404: description: >- Nothing matched — unknown route, model (`MODEL_NOT_FOUND`), task (`TASK_NOT_FOUND`) or asset (`ASSET_NOT_FOUND`). content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiError429: description: >- Rate limited (`RATE_LIMIT_*`). `RATE_LIMIT_MODERATION` means recent content was blocked — adjust the input rather than simply retrying. content: application/json: schema: $ref: '#/components/schemas/ApiError' ApiError500: description: Unexpected server-side failure (`INTERNAL`). content: application/json: schema: $ref: '#/components/schemas/ApiError' error: description: >- Error response. Every failure on this API uses this shape; branch on `errorCode`. content: application/json: schema: $ref: '#/components/schemas/ApiError' schemas: ApiError: type: object required: - errorCode - message - code additionalProperties: true properties: errorCode: type: string enum: - REJECTED - INTERNAL - CREDENTIAL_MISSING - CREDENTIAL_INVALID - CLI_TOKEN_EXPIRED - CLI_REFRESH_TOKEN_INVALID - PERMISSION_DENIED - ACCOUNT_SUSPENDED - ACCOUNT_DELETED - CREDITS_INSUFFICIENT - PLAN_FEATURE_REQUIRED - PARALLEL_TASK_LIMIT_REACHED - ACTIVITY_DAILY_LIMIT_REACHED - QUOTA_ELEMENT_FREE - QUOTA_ELEMENT_PAID - QUOTA_BRAND_KIT_FREE - QUOTA_BRAND_KIT_PAID - RATE_LIMIT_EXCEEDED - RATE_LIMIT_PRODUCT_EXTRACT - INPUT_VALIDATION_FAILED - MODERATION_REJECTED - ASSET_DISABLED_BY_REVIEW - GENERATION_IN_PROGRESS description: >- Stable business error identifier — **the only field to branch on**. Codes are append-only: existing codes are never renamed or repurposed, but new ones are added over time, so treat this as an open set. Match the exact code you handle, else the family prefix (`MODERATION_`, `RATE_LIMIT_`, `QUOTA_`, `ACCOUNT_`, …), else fall back to the HTTP status. message: type: string description: >- Developer-facing text. Varies with locale and product copy — **never match on it**. code: type: string description: >- Transport-level code (tRPC / JSON-RPC naming). Deprecated for business logic; may be removed. requestId: type: string description: Correlation id — quote it when contacting support. issues: type: array description: >- Per-field validation detail. Present when `errorCode` is `INPUT_VALIDATION_FAILED`. items: type: object required: - message additionalProperties: true properties: message: type: string path: type: array items: type: string description: Path to the offending field. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key to authorize requests ````