> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # GPT Image 2.5 Flare > [Core Function] GPT Image 2.5 Flare is a speed-oriented text-to-image generation model. [Strengths] Supports ten aspect ratios, resolution tiers up to 4K, and transparent backgrounds. [Best For] Landscape illustrations, product posters, and transparent icons. [Limitations] Do NOT use this for editing an existing image or selecting arbitrary pixel dimensions. [Routing] Choose this variant when speed is the priority; use GPT Image 2.5 Sunburst when image quality is the priority. Use GPT Image 2.5 Flare Edit when input images are required. ## OpenAPI ````yaml /media-model-api/openai/openai-t2i.json post /openai/gpt-image-2.5-flare openapi: 3.1.0 info: description: The text-to-image models API from OpenAI. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: OpenAI Text-to-Image Models API servers: - url: https://api.modellix.ai/api/v1 description: The text-to-image models API from OpenAI. security: - bearerAuth: [] paths: /openai/gpt-image-2.5-flare: post: tags: - GPT Image summary: GPT Image 2.5 Flare description: >- [Core Function] GPT Image 2.5 Flare is a speed-oriented text-to-image generation model. [Strengths] Supports ten aspect ratios, resolution tiers up to 4K, and transparent backgrounds. [Best For] Landscape illustrations, product posters, and transparent icons. [Limitations] Do NOT use this for editing an existing image or selecting arbitrary pixel dimensions. [Routing] Choose this variant when speed is the priority; use GPT Image 2.5 Sunburst when image quality is the priority. Use GPT Image 2.5 Flare Edit when input images are required. operationId: gptImage25FlareAsync requestBody: description: Request payload for GPT Image 2.5 Flare. required: true content: application/json: schema: $ref: '#/components/schemas/GPTImage25Request' examples: basic: summary: Default square image value: prompt: A cinematic mountain landscape at golden hour transparent: summary: Transparent icon value: prompt: A simple mountain icon with a transparent background background: transparent responses: '200': description: >- Task submitted successfully. Poll the URL in data.get_result.url using [Query Task Result](/api/get-task-result) to retrieve the generated image. content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: 12345678-1234-4234-8234-123456789abc model_id: openai/gpt-image-2.5-flare get_result: method: GET url: >- https://api.modellix.ai/api/v1/tasks/12345678-1234-4234-8234-123456789abc '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: GPTImage25Request: description: Request payload shared by GPT Image 2.5 Sunburst and Flare. type: object required: - prompt additionalProperties: false properties: prompt: type: string description: Image description, from 1 to 32,000 Unicode characters. minLength: 1 maxLength: 32000 example: A cinematic mountain landscape at golden hour aspect_ratio: type: string description: >- Output aspect ratio. Can be set independently of resolution; omitting it uses 1:1. default: '1:1' enum: - '1:1' - '3:2' - '2:3' - '3:4' - '4:3' - '4:5' - '5:4' - '9:16' - '16:9' - '21:9' example: '16:9' resolution: type: string description: >- Output resolution tier. Can be set independently of aspect_ratio; omitting it uses 1K. Pixel dimensions depend on both parameters: 1:1 + 1K gives 1024x1024, 1:1 + 4K gives 2880x2880, and 16:9 + 4K gives 3840x2160. default: 1K enum: - 1K - 2K - 4K example: 4K quality: type: string description: Output quality level. Defaults to low. default: low enum: - low - medium - high - xhigh - max example: high background: type: string description: >- Background mode: auto lets the model choose, opaque requests an opaque background, and transparent requests a transparent background with PNG output. default: auto enum: - auto - opaque - transparent example: transparent AsyncTaskResponse: description: Response object for asynchronous task submission. type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: description: Detailed data about the submitted asynchronous task. type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-openai-abc123 model_id: type: string description: Model ID example: gpt-image-2 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-openai-abc123 ErrorResponse: description: Standard error response object. type: object required: - code - message properties: code: type: integer description: Error code (equals HTTP status code) example: 400 message: type: string description: 'Error message in format ''Category: detail''' example: 'Invalid parameters: parameter ''prompt'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_prompt: summary: Missing required parameter value: code: 400 message: 'Invalid parameters: parameter ''prompt'' is required' invalid_size: summary: Invalid size parameter value: code: 400 message: 'Invalid parameters: size must be one of the supported values' content_violation: summary: Content policy violation value: code: 400 message: 'Content policy violation: prompt contains prohibited content' Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded or insufficient quota headers: Retry-After: description: Seconds to wait before retrying (optional) schema: type: integer example: 20 X-RateLimit-Limit-Requests: description: Maximum requests per minute schema: type: integer example: 5 X-RateLimit-Limit-Tokens: description: Maximum tokens per minute schema: type: integer example: 100000 X-RateLimit-Remaining-Requests: description: Remaining requests in current window schema: type: integer example: 0 X-RateLimit-Remaining-Tokens: description: Remaining tokens in current window schema: type: integer example: 0 X-RateLimit-Reset-Requests: description: Time when request limit resets (RFC3339 format) schema: type: string example: '2024-04-23T12:00:00Z' X-RateLimit-Reset-Tokens: description: Time when token limit resets (RFC3339 format) schema: type: string example: '2024-04-23T12:00:00Z' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rate_limit: summary: Rate limit exceeded value: code: 429 message: 'Rate limit exceeded: too many requests, retry after 20 seconds' insufficient_quota: summary: Insufficient quota value: code: 429 message: >- Quota exceeded: insufficient quota, please check your plan and billing InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: server_error: summary: Server error value: code: 500 message: 'Internal server error: please try again later' service_unavailable: summary: Service unavailable value: code: 503 message: 'Service unavailable: OpenAI service is temporarily unavailable' securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````