ChainHub API Guide
  1. Ideogram
  • 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
      • Submit Imagine Task
      • Query task status by task ID
      • Search for tasks based on the ID list
      • Get the seed for the task image
      • Execute Action
      • Submit Blend task
      • Submit Describe task
      • Submit Model
    • Ideogram
      • Generate 3.0 (Text and Image) Generate
        POST
      • Generate 3.0 (Image Editing) Edit
        POST
      • Generate 3.0 (Image Remix) Remix
        POST
      • Generate 3.0 (Image Reframe) Reframe
        POST
      • Generate 3.0 (Replace Background) Replace Background
        POST
      • ideogram (Text to Image)
        POST
      • Remix (Image Remix)
        POST
      • Upscale (Upscale)
        POST
      • Describe (Describe)
        POST
    • 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. Ideogram

ideogram (Text to Image)

POST
/ideogram/generate
Generates images synchronously based on a given prompt and optional parameters.
For specific parameters, please refer to the Official documentation: https://developer.ideogram.ai/api-reference/api-reference/describe
generates images synchronously based on given prompts and optional parameters.
The returned image URL is valid for 24 hours, after which it will not be accessible.
Image has been reverse proxied

Request

Authorization
Header Params

Body Params application/json

Examples

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/ideogram/generate' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image_request": {
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "model": "V_1",
        "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset."
    }
}'
Response Response Example
{
    "created": "2024-12-15T17:32:00.965408+00:00",
    "data": [
        {
            "is_image_safe": true,
            "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
            "resolution": "768x1232",
            "seed": 1785282233,
            "style_type": null,
            "url": "https://ideogram.ai/api/images/ephemeral/WkoxvqiOTaaCqG1nO2tQoA.png?exp=1734370337&sig=110fe96dc9e01002c8d837e5b4cde1aaa266195561d231ce76e19e095e478ffe"
        }
    ]
}
Modified at 2026-02-08 06:57:56
Previous
Generate 3.0 (Replace Background) Replace Background
Next
Remix (Image Remix)
Built with