ccapi-ai Midjourney Imagine API

openapi: 3.2.0
info:
  title: CCAPI Midjourney Imagine API
  description: CCAPI Model Gateway — OpenAI-compatible unified API
  version: 1.0.0
servers:
- url: https://api.ccapi.ai
  description: CCAPI API Gateway
tags:
- name: Midjourney Imagine API
  description: 'Generate Midjourney images through CCAPI''s simplified asynchronous image API.


    Submit one `mj_imagine` text-to-image task, then poll by `task_id`. A successful task returns four ordered split images in `result_urls`; the original four-image grid remains available as `preview_url` and the backward-compatible `result_url`.


    No provider-specific upscale, variation, reroll, or continuation endpoint is required.


    ---


    ## Pricing


    Visit the Pricing page to see full model pricing for this provider.'
paths:
  /v1/images/generations/async:
    post:
      deprecated: false
      description: 'Unified asynchronous image generation endpoint. Choose the matching request schema branch based on `model`, such as GPT Image 2 or Midjourney Imagine.


        The response immediately returns a `task_id`; poll `GET /v1/images/tasks/{task_id}` for status and results.'
      operationId: openai-compatible-async-image-generation
      parameters: []
      requestBody:
        content:
          application/json:
            examples:
              image_to_image:
                summary: Image-to-image with reference
                value:
                  image: https://example.com/photo.jpg
                  model: gpt-image-2
                  prompt: Transform this portrait into anime style while keeping facial features recognizable
              midjourney-imagine-api_imagine_fast:
                summary: Fast Imagine task
                value:
                  mode: fast
                  model: mj_imagine
                  prompt: A small red fox reading a book under warm lantern light, watercolor illustration --no text
              text_to_image:
                summary: Text-to-image
                value:
                  model: gpt-image-2
                  prompt: A serene mountain landscape at sunset with vibrant orange and purple skies
            schema:
              oneOf:
              - description: GPT Image 2 async generation request body. Identical to the synchronous endpoint.
                properties:
                  image:
                    description: Optional. Reference image URL(s) for image-to-image or multi-image blending. Single URL string or an array of URL strings.
                    oneOf:
                    - example: https://example.com/photo.jpg
                      type: string
                    - items:
                        type: string
                      type: array
                  model:
                    default: gpt-image-2
                    enum:
                    - gpt-image-2
                    example: gpt-image-2
                    type: string
                  prompt:
                    description: Text description of the image to generate.
                    example: A serene mountain landscape at sunset with vibrant orange and purple skies
                    type: string
                  size:
                    description: Requested image dimensions. Task-based channels translate this value to a supported aspect ratio; exact output pixels are provider-defined and may differ from the request. Omit it to use the platform default.
                    type: string
                required:
                - prompt
                title: GPT Image 2 Per-Call Image Generation
                type: object
              - properties:
                  mode:
                    default: fast
                    description: Generation speed. Defaults to `fast`.
                    enum:
                    - relax
                    - fast
                    - turbo
                    example: fast
                    type: string
                  model:
                    default: mj_imagine
                    description: Use `mj_imagine`.
                    enum:
                    - mj_imagine
                    example: mj_imagine
                    type: string
                  prompt:
                    description: Image description. Midjourney prompt parameters may be included.
                    example: A small red fox reading a book under warm lantern light, watercolor illustration --no text
                    type: string
                required:
                - model
                - prompt
                title: Midjourney Imagine API
                type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                code: success
                data:
                  created: 1773294301
                  model: gpt-image-2
                  status: queued
                  task_id: task_7b3f1c9e2a
                message: submitted
              schema:
                $ref: '#/components/schemas/ImageAsyncSubmitResponse'
          description: Task accepted; poll for the result
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Invalid request parameters
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Authentication failed
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Insufficient permissions or current group unavailable
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Submission failed
      security:
      - bearer: []
      summary: Submit Async Image Task
      tags:
      - Midjourney Imagine API
      x-apifox-folder: Image/GPT Image 2
  /v1/images/tasks/{task_id}:
    get:
      deprecated: false
      description: Poll an asynchronous image task by `task_id`. On success, single-image tasks use `result_url`; tasks with split outputs use ordered `result_urls` and may provide a composite `preview_url`.
      operationId: openai-compatible-async-image-task-fetch
      parameters:
      - description: The task_id returned by the async submit endpoint.
        example: task_7b3f1c9e2a
        in: path
        name: task_id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                in_progress:
                  summary: Still generating
                  value:
                    code: success
                    data:
                      progress: 50%
                      status: IN_PROGRESS
                      task_id: task_7b3f1c9e2a
                succeeded:
                  summary: Completed
                  value:
                    code: success
                    data:
                      progress: 100%
                      result_url: https://cdn.ccapi.ai/images/generated/gpt-image-2/1773294301681-0.png
                      status: SUCCESS
                      task_id: task_7b3f1c9e2a
              schema:
                $ref: '#/components/schemas/ImageAsyncTaskResponse'
          description: Task status and result
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Authentication failed
        '404':
          content:
            application/json:
              example:
                code: task_not_exist
                message: task not found
              schema:
                $ref: '#/components/schemas/ImageAsyncTaskResponse'
          description: Task not found for this user
      security:
      - bearer: []
      summary: Get Async Image Task
      tags:
      - Midjourney Imagine API
      x-apifox-folder: Image/GPT Image 2
components:
  schemas:
    ImageAsyncSubmitResponse:
      description: Acknowledgement returned by the async submit endpoint.
      properties:
        code:
          example: success
          type: string
        data:
          properties:
            created:
              description: Submission timestamp.
              type: integer
            model:
              example: gpt-image-2
              type: string
            status:
              example: queued
              type: string
            task_id:
              description: Poll GET /v1/images/tasks/{task_id} with this id.
              type: string
          required:
          - task_id
          - status
          type: object
        message:
          example: submitted
          type: string
      required:
      - code
      - data
      type: object
    ImageAsyncTaskResponse:
      description: Status and result of an async image task.
      properties:
        code:
          example: success
          type: string
        data:
          properties:
            fail_reason:
              description: Failure detail. Present when status is FAILURE.
              type: string
            preview_url:
              description: Optional composite preview URL for multi-result image tasks.
              type: string
            progress:
              example: 100%
              type: string
            result_url:
              description: Final image URL. Present when status is SUCCESS.
              type: string
            result_urls:
              description: Ordered image URLs when an async provider returns multiple split results.
              items:
                type: string
              type: array
            status:
              description: 'One of: SUBMITTED, QUEUED, IN_PROGRESS, SUCCESS, FAILURE.'
              example: SUCCESS
              type: string
            task_id:
              type: string
          required:
          - task_id
          - status
          type: object
        message:
          type: string
      required:
      - code
      - data
      type: object
    ErrorResponse:
      properties:
        error:
          properties:
            code: {}
            message:
              type: string
            param: {}
            type:
              type: string
          required:
          - message
          - type
          type: object
      required:
      - error
      type: object
  securitySchemes:
    bearer:
      description: 'CCAPI API Key. Format: `Bearer sk-xxx`'
      scheme: bearer
      type: http
x-tagGroups:
- name: Integration Guides
  tags:
  - OpenClaw Integration
  - Hermes Integration
  - Claude Code Integration
  - Codex CLI Integration
  - Gemini CLI Integration
- name: Chat
  tags:
  - Claude / Anthropic LLM Integration
  - OpenAI LLM Integration
  - Google Gemini LLM Integration
  - DeepSeek LLM Integration
  - MiniMax LLM Integration
- name: Image
  tags:
  - GPT Image 2 Per-Call Image Generation
  - Midjourney Imagine API
  - Gemini Per-Call Image Generation
  - CCAPI Image Upscale
  - Z-Image Turbo
  - Doubao Seedream Official Image API
- name: Video
  tags:
  - Gemini Video (Veo 3.1 / Omni Flash)
  - Grok Imagine Video
  - MiniMax H3 Family Video Generation
  - Seedance Trusted Asset Library
  - Seedance 2.5 / 2.0 Video Generation
  - Vidu Video Generation API
- name: Audio
  tags:
  - Producer Task API
  - Suno Task API