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

# Generate picture

> Generate images from a text prompt with optional reference images. You can upload up to 6 reference images and submit 1 to 4 generation jobs in a single request.



## OpenAPI

````yaml /openapi.old.json post /api/createNormalPicture
openapi: 3.0.3
info:
  title: Neural4D Management API
  description: Management endpoints for Neural4D, including request and response examples.
  version: 1.5.4
servers:
  - url: https://alb.neural4d.com:3000
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: text-to-3d
    description: Create 3D models from text prompts.
    x-group: Text to 3D
  - name: image-to-3d
    description: Create 3D models from uploaded images.
    x-group: Image to 3D
  - name: model-management
    description: Retrieve finished models, track jobs, and convert model formats.
    x-group: Model management
  - name: media-generation
    description: Generate pictures and videos and query their results.
    x-group: Picture and video generation
  - name: account-and-validation
    description: Check portrait inputs and query remaining points.
    x-group: Account and validation
paths:
  /api/createNormalPicture:
    post:
      tags:
        - media-generation
      summary: Generate picture
      description: >-
        Generate images from a text prompt with optional reference images. You
        can upload up to 6 reference images and submit 1 to 4 generation jobs in
        a single request.
      operationId: createNormalPicture
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CreateNormalPictureRequest'
            examples:
              default:
                value:
                  prompt: a beautiful flower
                  images:
                    - (binary)
                    - (binary)
                    - (binary)
                  jobNum: 2
                  modelKey: image-2
                  aspectRatio: '4:3'
      responses:
        '200':
          description: Picture generation job accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueuedGenerationResponse'
              examples:
                queued:
                  value:
                    success: true
                    data:
                      pointsDeducted: 26
                      queueStatus: queued
                      jobNum: 2
                      uuids:
                        - 834d7e8c-bd70-48d8-9830-ca1ad9886e33
                        - 774bd78d-d14f-4531-8972-321086c92edu
components:
  schemas:
    CreateNormalPictureRequest:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          description: Text prompt describing the desired generated image.
        images:
          type: array
          maxItems: 6
          items:
            type: string
            format: binary
          description: Optional reference images used to guide generation.
        modelKey:
          type: string
          enum:
            - image-2
            - nano_banana_pro
          default: image-2
          description: Image generation model key.
        aspectRatio:
          type: string
          enum:
            - '1:1'
            - '16:9'
            - '9:16'
            - '4:3'
            - '3:4'
          default: '1:1'
          description: Target aspect ratio for the generated images.
        jobNum:
          type: integer
          minimum: 1
          maximum: 4
          default: 1
          description: Number of generation jobs to submit.
    QueuedGenerationResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the generation request was accepted.
        data:
          $ref: '#/components/schemas/QueuedGenerationData'
          description: Queue and task details for the accepted generation request.
    QueuedGenerationData:
      type: object
      required:
        - pointsDeducted
        - queueStatus
        - jobNum
        - uuids
      properties:
        pointsDeducted:
          type: integer
          description: Points deducted for the accepted generation request.
        queueStatus:
          type: string
          description: Current queue state for the submitted job.
        jobNum:
          type: integer
          description: Number of accepted generation jobs.
        uuids:
          type: array
          description: UUIDs assigned to each accepted generation job.
          items:
            type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use the bearer token provided through the Neural4D website.
      x-default: YOUR_TOKEN

````