> ## Documentation Index > Fetch the complete documentation index at: https://docs.magnific.com/llms.txt > Use this file to discover all available pages before exploring further. # Create image from text - Z-Image > Generate high-quality images from text descriptions using the Z-Image turbo model. **Key Features:** - Superior speed with turbo architecture - High-quality image generation - Flexible image size configuration - Supports LoRA and ControlNet variants **Best for:** - Fast prototyping and iteration - High-volume image generation - Cost-effective production workloads ## OpenAPI ````yaml post /v1/ai/text-to-image/z-image openapi: 3.0.0 info: description: >- The Magnific API is your gateway to a vast collection of high-quality digital resources for your applications and projects. As a leading platform, it offers a wide range of graphics, including vectors, photos, illustrations, icons, PSD templates, and more, all curated by talented designers from around the world. title: Magnific API version: 1.0.0 servers: - description: B2B API Production V1 url: https://api.magnific.com security: - magnificApiKey: [] paths: /v1/ai/text-to-image/z-image: post: tags: - text-to-image summary: Create image from text - Z-Image description: > Generate high-quality images from text descriptions using the Z-Image turbo model. **Key Features:** - Superior speed with turbo architecture - High-quality image generation - Flexible image size configuration - Supports LoRA and ControlNet variants **Best for:** - Fast prototyping and iteration - High-volume image generation - Cost-effective production workloads operationId: create_image_from_text_z_image requestBody: content: application/json: examples: required-params: $ref: '#/components/examples/request-z-image-required-params' all-params: $ref: '#/components/examples/request-z-image-all-params' schema: $ref: '#/components/schemas/ttizi-request-content' required: true responses: '200': content: application/json: examples: success - in progress task: $ref: '#/components/examples/200-task-in-progress' schema: $ref: >- #/components/schemas/get_style_transfer_task_status_200_response description: OK - The request has succeeded and the Z-Image process has started. '400': content: application/json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Parameter 'page' must be greater than 0 invalid_query: summary: Parameter 'query' is not valid value: message: Parameter 'query' must not be empty invalid_filter: summary: Parameter 'filter' is not valid value: message: Parameter 'filter' is not valid generic_bad_request: summary: Bad Request value: message: Parameter ':attribute' is not valid schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response' application/problem+json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Validation error invalid_params: - field: page reason: Parameter 'page' must be greater than 0 - field: per_page reason: Parameter 'per_page' must be greater than 0 schema: $ref: >- #/components/schemas/get_all_style_transfer_tasks_400_response_1 description: >- Bad Request - The server could not understand the request due to invalid syntax. '401': content: application/json: examples: invalid_api_key: summary: API key is not valid value: message: Invalid API key missing_api_key: summary: API key is not provided value: message: Missing API key schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_400_response' description: >- Unauthorized - The client must authenticate itself to get the requested response. '500': content: application/json: schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_500_response' description: >- Internal Server Error - The server has encountered a situation it doesn't know how to handle. '503': content: application/json: schema: $ref: '#/components/schemas/get_all_style_transfer_tasks_503_response' description: Service Unavailable components: examples: request-z-image-required-params: summary: Minimal request - Z-Image value: prompt: A suited raccoon smoking a cigar request-z-image-all-params: summary: Complete request - Z-Image value: prompt: >- A cyberpunk city street at night, neon signs reflecting on wet pavement, flying cars in the distance, highly detailed, cinematic lighting image_size: square_hd num_inference_steps: 8 seed: 42 output_format: png enable_safety_checker: true webhook_url: https://your-app.com/webhooks/z-image 200-task-in-progress: summary: Success - Task in progress value: data: generated: [] task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: IN_PROGRESS schemas: ttizi-request-content: properties: prompt: description: > Text description of the image you want to generate. **Tips:** - Be specific about visual details, composition, and style - Z-Image excels at fast, high-quality image generation - Works well with detailed scene descriptions **Examples:** - Simple: "A suited raccoon smoking a cigar" - Detailed: "A cyberpunk city street at night, neon signs reflecting on wet pavement, flying cars in the distance" example: A suited raccoon smoking a cigar maxLength: 4096 type: string webhook_url: description: > Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field. example: https://www.example.com/webhook format: uri type: string image_size: default: square_hd description: | The aspect ratio and size of the generated image. If not specified, defaults to `square_hd` (1024x1024). **Available sizes:** - `square`: 512x512 pixels - `square_hd`: 1024x1024 pixels (default) - `portrait_3_4`: 768x1024 pixels - `portrait_9_16`: 576x1024 pixels - `landscape_4_3`: 1024x768 pixels - `landscape_16_9`: 1024x576 pixels enum: - square - square_hd - portrait_3_4 - portrait_9_16 - landscape_4_3 - landscape_16_9 example: square_hd type: string num_inference_steps: default: 8 description: > The number of inference steps to perform. Higher values may produce more detailed images but take longer. For Z-Image turbo, 8 steps is recommended for optimal speed/quality balance. example: 8 maximum: 50 minimum: 1 type: integer seed: description: > Random seed for reproducibility. Using the same seed with identical parameters produces the same image. Useful for iterating on a design or creating variations. example: 42 maximum: 4294967295 minimum: 0 type: integer output_format: default: png description: | The format of the generated image. - `png`: Lossless format, best for images with text or sharp edges - `jpeg`: Compressed format, smaller file size enum: - jpeg - png example: png type: string enable_safety_checker: default: true description: | Whether to enable the content safety checker. When enabled, the model filters potentially unsafe content. type: boolean required: - prompt type: object get_style_transfer_task_status_200_response: example: data: generated: - https://openapi-generator.tech - https://openapi-generator.tech task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: data: $ref: '#/components/schemas/task-detail' required: - data type: object get_all_style_transfer_tasks_400_response: example: message: message properties: message: type: string type: object get_all_style_transfer_tasks_400_response_1: properties: problem: $ref: >- #/components/schemas/get_all_style_transfer_tasks_400_response_1_problem type: object get_all_style_transfer_tasks_500_response: example: message: Internal Server Error properties: message: example: Internal Server Error type: string type: object get_all_style_transfer_tasks_503_response: example: message: Service Unavailable. Please try again later. properties: message: example: Service Unavailable. Please try again later. type: string type: object task-detail: allOf: - $ref: '#/components/schemas/task' - properties: generated: items: description: URL of the generated image format: uri type: string type: array required: - generated type: object example: generated: - https://openapi-generator.tech - https://openapi-generator.tech task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED get_all_style_transfer_tasks_400_response_1_problem: properties: message: example: Validation error type: string invalid_params: items: $ref: >- #/components/schemas/get_all_style_transfer_tasks_400_response_1_problem_invalid_params_inner type: array required: - invalid_params - message type: object task: example: task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: task_id: description: Task identifier format: uuid type: string status: description: Task status enum: - CREATED - IN_PROGRESS - COMPLETED - FAILED type: string required: - status - task_id type: object get_all_style_transfer_tasks_400_response_1_problem_invalid_params_inner: properties: name: description: Name of the invalid parameter. example: page type: string field: description: Field of the invalid parameter. Mirrors `name`. example: page type: string reason: example: Parameter 'page' must be greater than 0 type: string required: - field - name - reason type: object securitySchemes: magnificApiKey: description: > Your Magnific API key. Required for authentication. [Learn how to obtain an API key](https://docs.magnific.com/quickstart) in: header name: x-magnific-api-key type: apiKey ````