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

# GPT Image 1.5

Strong prompt adherence, detail preservation, fast.


## OpenAPI

````yaml /openapi.json post /generation/openai/gpt-image-1.5
openapi: 3.1.0
info:
  title: skills.video OpenAPI
  version: 1.0.0
  description: OpenAPI schema for skills.video API endpoints.
servers:
  - url: https://open.skills.video/api/v1
security: []
paths:
  /generation/openai/gpt-image-1.5:
    post:
      summary: GPT Image 1.5
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/openai_gpt_image_1_5CreateRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/openai_gpt_image_1_5MultipartCreateRequest'
      responses:
        '200':
          description: Generation submission accepted
          content:
            application/json:
              example:
                id: gen_123
                status: IN_QUEUE
                input:
                  prompt: a cat
                  aspect_ratio: '1:1'
                  resolution: 1024x1024
                  'n': 1
                usage:
                  total: 20
                  subscription: 20
                  permanent: 0
              schema:
                $ref: '#/components/schemas/openai_gpt_image_1_5Prediction'
        '400':
          description: >-
            Image generation request was rejected as invalid or model is not
            supported.
          content:
            application/json:
              example:
                error: IMAGE_GENERATION_INVALID_INPUT
                code: IMAGE_GENERATION_INVALID_INPUT
                message: '''prompt'' parameter is required'
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ImageGenerationErrorResponse'
                  - $ref: '#/components/schemas/TemplateErrorResponse'
                  - $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication required or failed
          content:
            application/json:
              example:
                error: UNAUTHORIZED
                code: UNAUTHORIZED
                message: Unauthorized
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '402':
          description: Workspace does not have enough credits to run this generation.
          content:
            application/json:
              example:
                error: INSUFFICIENT_CREDITS
                code: IMAGE_GENERATION_INSUFFICIENT_CREDITS
                message: Insufficient credits for this generation.
              schema:
                $ref: '#/components/schemas/ImageGenerationErrorResponse'
        '403':
          description: Workspace access is forbidden or Seedance verification is required.
          content:
            application/json:
              example:
                error: WORKSPACE_FORBIDDEN
                code: WORKSPACE_FORBIDDEN
                message: You do not have access to this workspace.
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $ref: '#/components/schemas/SeedanceVerificationErrorResponse'
        '404':
          description: Resource, model, or template not found.
          content:
            application/json:
              example:
                error: TEMPLATE_NOT_FOUND
                code: TEMPLATE_NOT_FOUND
                message: Template not found.
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $ref: '#/components/schemas/TemplateErrorResponse'
        '422':
          description: Upstream moderation rejected the request content.
          content:
            application/json:
              example:
                error: IMAGE_GENERATION_CONTENT_REJECTED
                code: IMAGE_GENERATION_CONTENT_REJECTED
                message: Request content was rejected by the moderation policy.
              schema:
                $ref: '#/components/schemas/ImageGenerationErrorResponse'
        '429':
          description: Generation rate limit exceeded upstream.
          content:
            application/json:
              example:
                error: IMAGE_GENERATION_RATE_LIMITED
                code: IMAGE_GENERATION_RATE_LIMITED
                message: Rate limit exceeded. Please retry later.
              schema:
                $ref: '#/components/schemas/ImageGenerationErrorResponse'
        '500':
          description: >-
            Image generation failed before provider execution completed.
            Response includes code and message fields.
          content:
            application/json:
              example:
                error: IMAGE_GENERATION_FAILED
                code: IMAGE_GENERATION_FAILED
                message: Generation failed.
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ImageGenerationErrorResponse'
                  - $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            Image generation failed. Returned when the upstream provider reports
            a generic failure.
          content:
            application/json:
              example:
                error: IMAGE_GENERATION_FAILED
                code: IMAGE_GENERATION_FAILED
                message: Generation failed.
              schema:
                $ref: '#/components/schemas/ImageGenerationErrorResponse'
        '503':
          description: Upstream generation provider is unavailable.
          content:
            application/json:
              example:
                error: IMAGE_GENERATION_PROVIDER_UNAVAILABLE
                code: IMAGE_GENERATION_PROVIDER_UNAVAILABLE
                message: Upstream generation provider is temporarily unavailable.
              schema:
                $ref: '#/components/schemas/ImageGenerationErrorResponse'
        '504':
          description: Image generation exceeded the upstream timeout.
          content:
            application/json:
              example:
                error: IMAGE_GENERATION_TIMEOUT
                code: IMAGE_GENERATION_TIMEOUT
                message: Generation timed out.
              schema:
                $ref: '#/components/schemas/ImageGenerationErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    openai_gpt_image_1_5CreateRequest:
      type: object
      properties:
        prompt:
          description: The prompt for image generation
          title: Prompt
          order: 1
          type: string
        image_urls:
          description: >-
            Input images to transform or use as reference (supports multiple
            images)
          title: Image Input
          order: 1
          xMax: 5
          default: []
          type: array
          items:
            format: uri
            type: string
        image_size:
          description: Aspect ratio for the generated image
          title: image_size
          order: 2
          default: default
          type: string
          enum:
            - default
            - 1024x1024
            - 1536x1024
            - 1024x1536
        aspect_ratio:
          description: Aspect ratio for the generated image
          title: aspect_ratio
          order: 3
          default: '1:1'
          type: string
          enum:
            - '1:1'
            - '3:2'
            - '2:3'
        resolution:
          description: Resolution hint for generated image
          title: resolution
          order: 4
          default: 1080p
          type: string
          enum:
            - 1080p
        background:
          description: Background for the generated image
          title: background
          order: 5
          default: auto
          type: string
          enum:
            - auto
            - transparent
            - opaque
        quality:
          description: Quality for the generated image
          title: quality
          order: 6
          default: default
          type: string
          enum:
            - default
            - low
            - medium
            - high
        num_images:
          description: Number of images to generate (1-10)
          title: Number Of Images
          order: 7
          default: 1
          type: integer
          minimum: 1
          maximum: 10
        output_format:
          description: Output format for the images
          title: output_format
          order: 8
          default: png
          type: string
          enum:
            - jpeg
            - png
            - webp
        'n':
          default: 1
          description: Number of results to generate (1-4)
          type: integer
          minimum: 1
          maximum: 4
      required:
        - prompt
      additionalProperties: false
    openai_gpt_image_1_5MultipartCreateRequest:
      type: object
      properties:
        prompt:
          description: The prompt for image generation
          title: Prompt
          order: 1
          type: string
        image_urls:
          description: >-
            Input images to transform or use as reference (supports multiple
            images)
          title: Image Input
          order: 1
          xMax: 5
          x-cli-aliases:
            - image
            - images
          default: []
          type: array
          items:
            description: >-
              When using application/json, send a public URL. When using
              multipart/form-data, send either a public URL or a binary file
              upload.
            anyOf:
              - format: uri
                type: string
              - format: binary
                type: string
        image_size:
          description: Aspect ratio for the generated image
          title: image_size
          order: 2
          default: default
          type: string
          enum:
            - default
            - 1024x1024
            - 1536x1024
            - 1024x1536
        aspect_ratio:
          description: Aspect ratio for the generated image
          title: aspect_ratio
          order: 3
          default: '1:1'
          type: string
          enum:
            - '1:1'
            - '3:2'
            - '2:3'
        resolution:
          description: Resolution hint for generated image
          title: resolution
          order: 4
          default: 1080p
          type: string
          enum:
            - 1080p
        background:
          description: Background for the generated image
          title: background
          order: 5
          default: auto
          type: string
          enum:
            - auto
            - transparent
            - opaque
        quality:
          description: Quality for the generated image
          title: quality
          order: 6
          default: default
          type: string
          enum:
            - default
            - low
            - medium
            - high
        num_images:
          description: Number of images to generate (1-10)
          title: Number Of Images
          order: 7
          default: 1
          type: integer
          minimum: 1
          maximum: 10
        output_format:
          description: Output format for the images
          title: output_format
          order: 8
          default: png
          type: string
          enum:
            - jpeg
            - png
            - webp
        'n':
          default: 1
          description: Number of results to generate (1-4)
          type: integer
          minimum: 1
          maximum: 4
      required:
        - prompt
      additionalProperties: false
    openai_gpt_image_1_5Prediction:
      type: object
      properties:
        id:
          description: Generation id.
          type: string
        status:
          $ref: '#/components/schemas/QueueState'
        input:
          $ref: '#/components/schemas/openai_gpt_image_1_5Input'
          title: Input
          description: Normalized input payload for the generation task.
        usage:
          $ref: '#/components/schemas/Usage'
        code:
          $ref: '#/components/schemas/__schema1'
        message:
          $ref: '#/components/schemas/__schema2'
      required:
        - id
        - status
        - input
        - usage
      additionalProperties: false
    ImageGenerationErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations.
          type: string
        code:
          description: >-
            Image generation error code. `*_FAILED` is the generic fallback;
            more specific codes (`*_TIMEOUT`, `*_RATE_LIMITED`,
            `*_PROVIDER_UNAVAILABLE`, `*_UNSUPPORTED_MODEL`, `*_INVALID_INPUT`,
            `*_INSUFFICIENT_CREDITS`, `*_CONTENT_REJECTED`) are surfaced when
            applicable.
          type: string
          enum:
            - IMAGE_GENERATION_FAILED
            - IMAGE_GENERATION_TIMEOUT
            - IMAGE_GENERATION_RATE_LIMITED
            - IMAGE_GENERATION_PROVIDER_UNAVAILABLE
            - IMAGE_GENERATION_UNSUPPORTED_MODEL
            - IMAGE_GENERATION_INVALID_INPUT
            - IMAGE_GENERATION_INSUFFICIENT_CREDITS
            - IMAGE_GENERATION_CONTENT_REJECTED
        message:
          description: Human readable error message. Upstream vendor names are redacted.
          type: string
        errors:
          description: Field-level validation errors when available.
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - path
              - message
              - code
            additionalProperties: false
        details:
          description: Additional structured error details when available.
        requested:
          description: Requested credits when the error is insufficient credits.
          type: number
        available:
          description: Available credits when the error is insufficient credits.
          type: number
      required:
        - code
        - message
      additionalProperties: false
    TemplateErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations.
          type: string
        code:
          description: Template error code.
          type: string
          enum:
            - TEMPLATE_NOT_FOUND
            - TEMPLATE_MODEL_MISMATCH
            - TEMPLATE_INVALID_INPUT
            - TEMPLATE_TRANSFORM_FAILED
        message:
          description: Human readable template error message.
          type: string
        errors:
          description: Field-level template validation errors when available.
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - path
              - message
              - code
            additionalProperties: false
        details:
          description: Additional structured error details when available.
      required:
        - code
        - message
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations. This may contain an unprefixed compatibility code for
            older clients.
          type: string
        code:
          description: Machine-readable error code. Use this to branch in client code.
          type: string
        message:
          description: Human readable error message.
          type: string
        errors:
          description: Field-level validation errors when available.
          type: array
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
              code:
                type: string
            required:
              - path
              - message
              - code
            additionalProperties: false
        details:
          description: Additional structured error details when available.
      required:
        - code
        - message
      additionalProperties: false
    SeedanceVerificationErrorResponse:
      type: object
      properties:
        error:
          description: >-
            Legacy machine-readable error field. Prefer `code` for new
            integrations.
          type: string
        code:
          description: Seedance verification error code.
          type: string
          const: SEEDANCE_VERIFICATION_REQUIRED
        message:
          description: Human readable verification error message.
          type: string
        verification:
          description: Current Seedance verification state when available.
          anyOf:
            - {}
            - type: 'null'
      required:
        - code
        - message
      additionalProperties: false
    QueueState:
      description: Queue status
      type: string
      enum:
        - IN_QUEUE
        - IN_PROGRESS
        - COMPLETED
        - FAILED
        - CANCELED
    openai_gpt_image_1_5Input:
      $ref: '#/components/schemas/__schema39'
      title: Input
    Usage:
      description: Credit usage breakdown for the request
      type: object
      properties:
        total:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        subscription:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        permanent:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
      required:
        - total
        - subscription
        - permanent
      additionalProperties: false
    __schema1:
      description: >-
        Machine-readable generation error code. Present when `status` is
        `FAILED`.
      type: string
    __schema2:
      description: >-
        Sanitized human-readable failure message. Present when `status` is
        `FAILED`.
      type: string
    __schema39:
      title: Input
      type: object
      properties:
        prompt:
          description: The prompt for image generation
          title: Prompt
          order: 1
          type: string
        image_urls:
          description: >-
            Input images to transform or use as reference (supports multiple
            images)
          title: Image Input
          order: 1
          xMax: 5
          default: []
          type: array
          items:
            format: uri
            type: string
        image_size:
          description: Aspect ratio for the generated image
          title: image_size
          order: 2
          default: default
          type: string
          enum:
            - default
            - 1024x1024
            - 1536x1024
            - 1024x1536
        aspect_ratio:
          description: Aspect ratio for the generated image
          title: aspect_ratio
          order: 3
          default: '1:1'
          type: string
          enum:
            - '1:1'
            - '3:2'
            - '2:3'
        resolution:
          description: Resolution hint for generated image
          title: resolution
          order: 4
          default: 1080p
          type: string
          enum:
            - 1080p
        background:
          description: Background for the generated image
          title: background
          order: 5
          default: auto
          type: string
          enum:
            - auto
            - transparent
            - opaque
        quality:
          description: Quality for the generated image
          title: quality
          order: 6
          default: default
          type: string
          enum:
            - default
            - low
            - medium
            - high
        num_images:
          description: Number of images to generate (1-10)
          title: Number Of Images
          order: 7
          default: 1
          type: integer
          minimum: 1
          maximum: 10
        output_format:
          description: Output format for the images
          title: output_format
          order: 8
          default: png
          type: string
          enum:
            - jpeg
            - png
            - webp
      required:
        - prompt
      additionalProperties: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API Key for API endpoints

````