ChainHub API Guide
  1. Midjourney
  • How to use ChainHub
  • Overview
    • Quick Start
    • Important Guidelines
    • Examples
    • Pricing
    • Error Codes
  • Chat
    • Chat
    • ChatGPT Interface
      • ChatGPT Audio
        • Audio to text conversion gpt-4o-transcribe
        • Creating voice gpt-4o-mini-tts
        • Create Translation (Not Supported)
      • ChatGPT Embeddings
        • Create an embed
      • ChatGPT Auto-Completion
        • Creation complete
      • Chat (Responses)
        • Create function call Copy
      • GPTs Related
        • GPTs Dialogue
    • Google Gemini API
      • Gemini Chat
      • Chat Compatible Format
        • Gemini-2.5-flash-all
        • Chat interface
        • Image recognition interface
      • Native Format
        • Embeddings
        • Create text - flow
        • Text generation + thinking-flow
        • Image generation
        • Image generation gemini-2.5-flash-image: Controlling aspect ratio
        • Image generation gemini-3-pro-image-preview controls aspect ratio and sharpness.
        • Image editing
        • google search
        • TTS Text-to-speech
        • Text generation gemini-3-pro-preview:generateContent
        • Imagen Generate image
    • Anthropic Claude Interface
      • Anthropic Claude
      • Chat Compatible Format
        • Create Chat Completion (Streaming)
        • Create Extended Thinking Chat
        • Create Chat Vision (Non-Streaming)
        • Create Chat Vision (Streaming)
        • Create Chat Completion (Non-Streaming)
      • Native Format
        • Create function calls (streaming)
        • Create chat autocomplete (streaming)
        • Create formatted output
        • Create a Thinking Chat
        • Internet search
        • PDF support
  • Image Models
    • Qwen Series
      • qwen-image-edit-2509
      • qwen-image-max
      • z-image-turbo
    • Tencent AIGC
      • Create Task
      • Get the request result
    • Midjourney
      • Upload Image
        POST
      • Submit Imagine Task
        POST
      • Query task status by task ID
        GET
      • Search for tasks based on the ID list
        POST
      • Get the seed for the task image
        GET
      • Execute Action
        POST
      • Submit Blend task
        POST
      • Submit Describe task
        POST
      • Submit Model
        POST
    • Ideogram
      • Generate 3.0 (Text and Image) Generate
      • Generate 3.0 (Image Editing) Edit
      • Generate 3.0 (Image Remix) Remix
      • Generate 3.0 (Image Reframe) Reframe
      • Generate 3.0 (Replace Background) Replace Background
      • ideogram (Text to Image)
      • Remix (Image Remix)
      • Upscale (Upscale)
      • Describe (Describe)
    • Fal.AI Platform
      • /fal-ai/nano-banana Text-to-Image
      • /fal-ai/nano-banana/edit Image Editing
      • Get the request result
    • FLUX Series
      • OpenAI Compatible Format
        • Flux Image Editing (OpenAI dall-e-3 format)
        • Flux creation (OpenAI dall-e-3 format)
      • Replicate Official Format
        • Query task
    • GPT Image Series
      • Create gpt-image-1
      • Edit gpt-image-1
      • mask gpt-image-1
      • Create gpt-image-1.5
      • Edit gpt-image-1.5
      • Mask gpt-image-1.5
  • Video Models
    • grok Video Generation
      • Video Unified Format
        • Create video
        • Query task
    • luma Video Generation
      • Official API Format
        • Submit video generation task
        • Extend video
      • Query a single task
        • Query a single task
      • Batch retrieval tasks
        • Batch retrieval tasks
    • Runway Video Generation
      • Submit video generation task
      • Query video task (free)
    • Sora Video Generation
      • OpenAI Official Video Format
        • openai Create video (with Character)
        • openai Query task
        • openai Download video
        • openai Edit video
        • Create videos with images using OpenAI.
        • Create a video with images using OpenAI in private mode.
        • Create videos using storyboards
      • Chat Format
        • Create video
        • Continuous modification to generate video
        • Create a video with images
      • Unified Video Format
        • Query task
        • Create a video with images using sora-2
        • Create video sora-2
        • Creating videos with sora-2-pro
        • Create a video (with a character)
      • Create character
    • Minimax Hailuo Video Generation
      • First and last frame video
      • Video task status query
    • Tencent AIGC Video Generation
      • Get request result
      • Create task
    • Doubao Video Generation
      • seedance-1-5-pro
      • Query video generation task list - search multiple task IDs
      • Query a single task
      • Wensheng Video Example
      • Image-based video - first frame
      • seedance-lite-first and last frames
      • Image-based video - base64 encoded
      • Seedance-Lite Reference Image
      • Query video generation task list - default
      • Query video generation task list - search multiple task ID
      • seedance-1-5-pro-first and last frames
    • Wan Video Generation
      • Generate video
      • Video query
  • Music Suno
    • Suno API Documentation
    • Task Submission
      • Generate song (concatenate song)
      • Generate lyrics
      • Concatenate songs
      • Report upload completion
      • Query upload processing status
      • Initialize audio clip
      • Request upload authorization
      • s3 upload example
      • Scenario 3: Pure Music - Custom
      • Song splicing
      • Generate a song (custom mode)
      • Generate a song (Inspiration Mode)
      • Generate a song (continuation mode)
      • Generate songs (singer style)
      • Generate a song (upload a song for secondary creation).
      • Generate a song (compose a song)
      • Report uploaded
      • Initialize audio file
      • Scene 1: Inspiration Mode
      • Scenario 2: Custom lyrics and song title
    • Query Interface
      • Batch fetch tasks
      • Query single task
      • Get wav
      • Timing: lyrics, audio timeline
      • Feed details retrieval
  • Kling Platform
    • Callback Protocol
    • Omni-Image
      • Query Task (Single)
      • Omni-Image
    • Omni-Video
      • Omni-Video
    • Custom Elements
      • Custom Elements
    • Motion Control
      • Motion Control
      • Query Task (Single)
    • Image Generation
      • Image Generation
      • Query Task (Single)
    • Image Recognition
      • Image Recognition
    • Image to Video
      • Image to Video
    • Image
      • Video
        • Query task (single)
    • Multi-image reference generation
      • Multi-image reference generation
      • Query task (single)
    • Multi-image reference video generation
      • Multi-image reference video generation
      • Query task (single)
    • Multi-modal video editing
      • Initialize video to be edited
      • Add video selection
      • Delete video selection
      • Preview selected area video
      • Multi-modal video
      • Query task (single)
    • Lip Sync
      • Face identification
      • Lip sync
    • lip-syncing
      • Query Task (Single)
      • Facial recognition
      • Lip-syncing
    • image expansion
      • Image Expansion
      • Query Task (Single)
    • digital human
      • Image to Video
      • Query Task (Single)
    • text to video
      • Text to Video
      • Query Task (Single)
    • text to audio
      • Text-to-Audio
      • Query Task (Single)
    • custom voice
      • Custom Voice
      • Query Custom Voice (Single)
      • Query Official Voices
      • Delete Custom Voice
    • virtual try-on
      • Virtual Try-On
      • Query Task (Single)
    • video extension
      • Video Extension
      • Query Task (Single)
    • video effects
      • Video Effects
      • Query Task (Single)
    • video to audio
      • Video to Audio
      • Query Task (Single)
    • text-to-speech
      • Text-to-Speech
  • Fal-ai aggregation platform
    • Integration Tutorial
    • falai-veo3 video generation
      • /fal-ai/veo3
      • /fal-ai/veo3/fast/image-to-video
      • /fal-ai/veo3/fast
      • /fal-ai/veo3/requests/{request_id}
      • /fal-ai/veo3/image-to-video
    • Get the request result
    • /fal-ai/flux-1/dev
    • /fal-ai/flux-1/dev/image-to-image
    • /fal-ai/flux-1/dev/redux
    • /fal-ai/flux-1/schnell/redux
    • /fal-ai/flux-pro/kontext
    • /fal-ai/flux-pro/kontext/text-to-image
    • /fal-ai/flux-pro/kontext/max
    • /fal-ai/flux-pro/kontext/max/multi
    • /fal-ai/wan/v2.2-a14b/image-to-image
    • /fal-ai/bytedance/seedream/v4/text-to-image
    • /fal-ai/bytedance/seedream/v4/edit
    • /fal-ai/vidu/reference-to-image
    • /fal-ai/imagen4/preview
    • /fal-ai/qwen-image-edit-lora
    • /fal-ai/qwen-image-edit-plus
    • /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
    • /fal-ai/kling-video/v2.5-turbo/pro/image-to-video
    • /fal-ai/flux-lora
    • /fal-ai/flux-lora/image-to-image
    • /fal-ai/flux-lora/inpainting
  • Replicate Aggregation Platform
    • Access Tutorial
    • Create task black-forest-labs/flux-kontext-dev
    • Query task
    • Create task lucataco/remove-bg
    • Create task ideogram-ai/ideogram-v2-turbo
    • Create task minimax/video-01-live
    • Create task minimax/video-01
    • Create task recraft-ai/recraft-v3
    • Create task recraft-ai/recraft-v3-svg
    • Create task black-forest-labs/flux-1.1-pro-ultra
    • Create task black-forest-labs/flux-kontext-pro
    • Create task black-forest-labs/flux-kontext-max
    • Create task flux-kontext-apps/multi-image-kontext-max
    • Create task flux-kontext-apps/multi-image-kontext-pro
    • Create task riffusion/riffusion
    • Create task black-forest-labs/flux-fill-dev
    • Create task black-forest-labs/flux-fill-pro
    • Create task google/imagen-4-fast
    • Create task google/imagen-4-ultra
    • Create task google/imagen-4
    • Create task prunaai/vace-14b
    • Create task bytedance/seedream-4
  • Rerank Rerank Model
    • Rerank
  • Python Configuration
    • Python Basics Discussion
    • Using gpt-4o in Python to recognize images
    • Using Claude in Python to Recognize Images
    • Python OpenAI official libraries
    • Python continuous dialogue
    • Using Python to convert speech to text
    • Using Python to convert text to speech
    • Vectorization using Embeddings in Python
    • Python calls DALL·E
    • Simple Python function calling demo
    • Simple Python LangChain calling OpenAI demo
    • Python llama\Index configuration
    • Using gpt-4o in Python to recognize local images
    • Python library for streaming output
    • GPT Realtime Model Call
    • Python request request streaming demo
    • Using Python to create and edit images with gpt-image-1
  1. Midjourney

Submit Describe task

POST
/mj/submit/describe
Official documentation: https://docs.midjourney.com/hc/en-us/articles/32497889043981-Describe

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/mj/submit/describe' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "botType": "MID_JOURNEY",
    "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zUAAElgGNhQlgAASWAanVtYgAAAB5qdW1kYzJwYQARABCAAACqADibcQNjMnBhAAAANw9qdW1iAAAAR2p1bWRjMm1hABEAEIAAAKoAOJtxA3VybjpjMnBhOmU5OWY4ZDVkLTk0YTktNDRjNy1iY2QxLThjNzk3Yzk3NGY3NQAAAAHhanVtYgAAAClqdW1kYzJhcwARABCAAACqADibcQNjMnBhLmFzc2VydGlvbnMAAAABBWp1bWIAAAApanVtZGNib3IAEQAQgAAAqgA4m3EDYzJwYS5hY3Rpb25zLnYyAAAAANRjYm9yoWdhY3Rpb25zgqNmYWN0aW9ubGMycGEuY3JlYXRlZG1zb2Z0d2FyZUFnZW50v2RuYW1lZkdQVC00b/9xZGlnaXRhbFNvdXJjZVR5cGV4Rmh0dHA6Ly9jdi5pcHRjLm9yZy9uZXdzY29kZXMvZGlnaXRhbHNvdXJjZXR5cGUvdHJhaW5lZEFsZ29yaXRobWljTWVkaWGiZmFjdGlvbm5jMnBhLmNvbnZlcnRlZG1zb2Z0d2FyZUFnZW50v2RuYW1lak9wZW5BSSBBUEn/AAAAq2p1bWIAAAAoanVtZGNib3IAEQAQgAAAqgA4m3EDYzJwYS5oYXNoLmRhdGEAAAAAe2Nib3KlamV4Y2x1c2lvbnOBomVzdGFydBghZmxlbmd0aBk3QWRuYW1lbmp1bWJmIG1hbmlmZXN0Y2FsZ2ZzaGEyNTZkaGFzaFggCGr+u5unlm9dNxSzfrGn1Z6vrscnpGc++QEtDdT3vJpjcGFkSAAAAAAAAAAAAAAB4mp1bWIAAAAnanVtZGMyY2wAEQAQgAAAqgA4m3EDYzJwYS5jbGFpbS52MgAAAAGzY2JvcqZqaW5zdGFuY2VJRHgseG1wOmlpZDo2YzZlNWZiMy0zZDYxLTQ0OWYtYTdlMi05NmQ0M2FmNDNiMmR0Y2xhaW1fZ2VuZXJhdG9yX2luZm+/ZG5hbWVjQVBJb29yZy5jYWkuYzJwYV9yc2YwLjUxLjH/aXNpZ25hdHVyZXhNc2VsZiNqdW1iZj0vYzJwYS91cm46YzJwYTplOTlmOGQ1ZC05NGE5LTQ0YzctYmNkMS04Yzc5N2M5NzRmNzUvYzJwYS5zaWduYXR1cmVyY3Jl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
Response Response Example
{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        },
        {
            "url": "https://..."
        }
    ]
}
Modified at 2026-02-08 06:57:56
Previous
Submit Blend task
Next
Submit Model
Built with