> ## Documentation Index
> Fetch the complete documentation index at: https://ailabtools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Flower Wallpaper API

> AI Flower Wallpaper API turns names into personalized floral wallpapers, bouquet art, and flower-language image designs.

## Query Task

<Tip>
  This is an asynchronous task API. The submission request returns only `task_id`.

  Use `task_id` to call [Querying Async Task Results](/docs/ai-common/async-task-results/api) and retrieve the final result. Async task results remain available for 24 hours. Query every 5 seconds.
</Tip>

| Field             | Type     | Description        |
| :---------------- | :------- | :----------------- |
| `data`            | `object` | Final result data. |
| +`result_urls`    | `array`  | Result image URLs. |
| ++`result_urls[]` | `string` | Result image URL.  |

```json theme={null}
{
  "data": {
    "result_urls": [""]
  }
}
```

<Tip>
  `result_urls` are temporary and remain valid for 24 hours. Download the files to your own storage before the URLs expire if you need long-term storage.
</Tip>

## Submit Task


## OpenAPI

````yaml POST /api/image/generation/ai-flower-wallpaper
openapi: 3.0.0
info:
  title: AILabAPI
  description: >-
    [<b>AILabTools</b>](https://www.ailabtools.com) is an advanced tool that
    offers a vast array of simple and flexible API endpoints to suit your
    specific needs. With just one [<b>API
    KEY</b>](https://www.ailabtools.com/doc/get-api-key), you can easily call
    any of the endpoints and integrate them quickly into your application or
    workflow, allowing for smooth and efficient operations.


    [<b>AILabTools</b>](https://www.ailabtools.com) is continuously evolving,
    and you can anticipate even more API endpoints being added in the future,
    further enhancing its capabilities and usefulness for your artificial
    intelligence and machine learning requirements.
  version: 1.0.0
servers:
  - url: https://www.ailabapi.com
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: AI IMAGE
  - name: AI IMAGE > Image Enhancement
  - name: AI IMAGE > Image Effects
  - name: AI IMAGE > Image Editing
  - name: AI IMAGE > Image Scoring
  - name: AI BACKGROUND REMOVAL
  - name: AI BACKGROUND REMOVAL > Portrait
  - name: AI BACKGROUND REMOVAL > General
  - name: AI PORTRAIT
  - name: AI PORTRAIT > Portrait Effects
  - name: AI PORTRAIT > Portrait Enhance
  - name: AI PORTRAIT > Portrait Editing
  - name: AI PORTRAIT > Portrait Analysis
  - name: AI COMMON
paths:
  /api/image/generation/ai-flower-wallpaper:
    post:
      tags:
        - AI IMAGE > Image Generation
      summary: AI Flower Wallpaper
      description: >-
        AI Flower Wallpaper API turns names into personalized floral wallpapers,
        bouquet art, and flower-language image designs.
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: User name to display in the wallpaper (English only).
                  maxLength: 500
                  default: AUTO
                flower_elements:
                  type: string
                  description: >-
                    Flower elements and bouquet composition description (English
                    only).
                  maxLength: 4000
                  default: AUTO
                style:
                  type: string
                  description: Artwork style for the generated wallpaper (English only).
                  maxLength: 4000
                  default: soft watercolor floral illustration
                background:
                  type: string
                  description: >-
                    Background style or color theme for the wallpaper (English
                    only).
                  maxLength: 4000
                  default: pastel gradient background
                aspect_ratio:
                  type: string
                  description: Output Image Aspect Ratio.
                  enum:
                    - auto
                    - '1:1'
                    - '3:4'
                    - '4:3'
                    - '9:16'
                    - '16:9'
                  default: auto
      responses:
        '200':
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
              example:
                request_id: ''
                log_id: ''
                error_code: 0
                error_code_str: ''
                error_msg: ''
                error_detail:
                  status_code: 200
                  code: ''
                  code_message: ''
                  message: ''
                task_type: async
                task_id: ''
          description: Success
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: ailabapi-api-key
      description: API Key for authentication

````