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

# Midjourney Submit Blend

> Use DeerAPI to call the Midjourney Submit Blend endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Midjourney Submit Blend workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/image/midjourney/post-submit-blend.openapi.json POST /mj/submit/blend
openapi: 3.1.0
info:
  title: Blend (image -> image) API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /mj/submit/blend:
    post:
      summary: Blend (image -> image)
      operationId: blend
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - base64Array
              properties:
                base64Array:
                  type: array
                  description: >-
                    Two or more base64-encoded images to blend. Each item should
                    be a data URI such as `data:image/png;base64,xxx`.
                  items:
                    type: string
                  default:
                    - example
                dimensions:
                  type: string
                  description: Output aspect ratio.
                  enum:
                    - PORTRAIT
                    - SQUARE
                    - LANDSCAPE
                notifyHook:
                  type: string
                  description: >-
                    Webhook URL to receive task status updates. Falls back to
                    your account-level webhook if omitted.
                state:
                  type: string
                  description: >-
                    Custom state string. Returned as-is in the task result and
                    webhook callback for your own tracking.
                botType:
                  type: string
                  description: >-
                    Bot type to use. `MID_JOURNEY` for Midjourney (default),
                    `NIJI_JOURNEY` for Niji.
                  enum:
                    - MID_JOURNEY
                    - NIJI_JOURNEY
              default:
                base64Array:
                  - example
            examples:
              Default:
                summary: Default
                value:
                  botType: MID_JOURNEY
                  base64Array:
                    - data:image/png;base64,xxx1
                    - data:image/png;base64,xxx2
            example:
              botType: MID_JOURNEY
              base64Array:
                - data:image/png;base64,xxx1
                - data:image/png;base64,xxx2
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - description
                  - properties
                  - result
                properties:
                  code:
                    type: integer
                    description: Status code
                  description:
                    type: string
                    description: >-
                      Human-readable description message corresponding to the
                      status code
                  properties:
                    type: object
                    description: Additional properties or metadata
                    properties: {}
                  result:
                    type: integer
                    description: Returned task ID
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/mj/submit/blend \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "botType": "MID_JOURNEY",
                "base64Array": [
                  "data:image/png;base64,xxx1",
                  "data:image/png;base64,xxx2"
                ]
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/mj/submit/blend"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "botType": "MID_JOURNEY",
              "base64Array": [
                "data:image/png;base64,xxx1",
                "data:image/png;base64,xxx2"
              ]
            }

            response = requests.post(url, headers=headers, json=payload)
            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const response = await
            fetch("https://api.deerapi.com/mj/submit/blend", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "botType": "MID_JOURNEY",
                "base64Array": [
                  "data:image/png;base64,xxx1",
                  "data:image/png;base64,xxx2"
                ]
              }),
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````