> ## 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.

# PolloJourney V8.2 API Documentation

> PolloJourney V8.2 API delivers refined aesthetics, improved image quality, and smarter personalization. It interprets detailed prompts to generate bold, polished visuals while reducing inconsistent results. Integrate PolloJourney V8.2 API now.

Check out PolloJourney V8.2 API pricing [here](https://api.pollo.ai/pricing?modelName=pollojourney-v8-2-image\&modelType=image), cheaper than Fal AI.


## OpenAPI

````yaml POST /generation/pollojourney/pollojourney-v8-2-image/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:
  /generation/pollojourney/pollojourney-v8-2-image/image:
    post:
      tags:
        - generation
        - image generation
      summary: create image by text or image
      operationId: generation-pollojourney-v8-2-image/image
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  anyOf:
                    - allOf:
                        - {}
                        - anyOf:
                            - type: object
                              properties:
                                prompt:
                                  type: string
                                  minLength: 1
                                  maxLength: 1000
                                  description: The prompt of the generation
                                aspectRatio:
                                  type: string
                                  enum:
                                    - '1:1'
                                    - '16:9'
                                    - '3:2'
                                    - '2:3'
                                    - '3:4'
                                    - '4:3'
                                    - '9:16'
                                  default: '1:1'
                                resolution:
                                  type: string
                                  enum:
                                    - 1K
                                    - 2K
                                  default: 1K
                                  description: The resolution of the generation
                                seed:
                                  type: number
                                  description: The seed of the generation
                                imageUrl:
                                  type: string
                                  maxLength: 1000
                                  format: uri
                                  pattern: ^(?:http|https):\/\/
                                images:
                                  type: array
                                  items:
                                    type: string
                                    maxLength: 1000
                                    format: uri
                                    pattern: ^(?:http|https):\/\/
                                  maxItems: 1
                                  description: >-
                                    Only image URLs are accepted (HTTPS
                                    preferred); base64 is not allowed.
                                                Supported formats include JPG, PNG, and JPEG.
                                                Image aspect ratio must be less than 1:4 or 4:1.
                              required:
                                - prompt
                                - imageUrl
                              additionalProperties: false
                            - type: object
                              properties:
                                prompt:
                                  type: string
                                  minLength: 1
                                  maxLength: 1000
                                  description: The prompt of the generation
                                aspectRatio:
                                  type: string
                                  enum:
                                    - '1:1'
                                    - '16:9'
                                    - '3:2'
                                    - '2:3'
                                    - '3:4'
                                    - '4:3'
                                    - '9:16'
                                  default: '1:1'
                                resolution:
                                  type: string
                                  enum:
                                    - 1K
                                    - 2K
                                  default: 1K
                                  description: The resolution of the generation
                                seed:
                                  type: number
                                  description: The seed of the generation
                                imageUrl:
                                  type: string
                                  maxLength: 1000
                                  format: uri
                                  pattern: ^(?:http|https):\/\/
                                images:
                                  type: array
                                  items:
                                    type: string
                                    maxLength: 1000
                                    format: uri
                                    pattern: ^(?:http|https):\/\/
                                  minItems: 1
                                  maxItems: 1
                                  description: >-
                                    Only image URLs are accepted (HTTPS
                                    preferred); base64 is not allowed.
                                                Supported formats include JPG, PNG, and JPEG.
                                                Image aspect ratio must be less than 1:4 or 4:1.
                              required:
                                - prompt
                                - images
                              additionalProperties: false
                    - allOf:
                        - {}
                        - type: object
                          properties:
                            prompt:
                              type: string
                              minLength: 1
                              maxLength: 1000
                              description: The prompt of the generation
                            style:
                              type: string
                              default: ''
                            aspectRatio:
                              type: string
                              enum:
                                - '1:1'
                                - '16:9'
                                - '3:2'
                                - '2:3'
                                - '3:4'
                                - '4:3'
                                - '9:16'
                              default: '1:1'
                            resolution:
                              type: string
                              enum:
                                - 1K
                                - 2K
                              default: 1K
                              description: The resolution of the generation
                            seed:
                              type: number
                              description: The seed of the generation
                          required:
                            - prompt
                          additionalProperties: false
                webhookUrl:
                  type: string
                clientSource:
                  type: string
                  minLength: 1
                  maxLength: 100
              required:
                - input
              additionalProperties: false
      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
        default:
          $ref: '#/components/responses/error'
      security:
        - ApiKeyAuth: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key to authorize requests

````