API Doc-ElkAPI
  1. Official API format
API Doc-ElkAPI
  • Quick Start
    • Quick Start
    • Must-read for beginners
    • ElkAPI Announcement
  • API Reference
    • Error status code description
    • OpenAI Format
      • Veo3-chat format
      • seedance
      • response
      • generate video
      • image
      • Image Editing (gpt-image-1)
      • embed
      • Realtime
      • Get model list
      • Response ID to obtain results
      • Hunyuan3D
    • Anthropic Format
      • Anthropic Claude
    • Midjourney Image Generation
      • Quick teaching-complete process in one go
      • Task Query
        • pagination query
        • Specify ID to obtain task
      • Submit Imagine task
      • Submit video task
      • Submit editing task
      • Submit Action Task
      • Submit Blend task
      • Submit Describe task
      • Submit Modal
    • Image Generation
      • ideogram(images)
        • Official documentation (updated in real time)
        • Generate 3.0 (illustrated in the text)
        • Reframe 3.0 (Refactoring)
        • Replace Background 3.0
        • Remix 3.0 (Mixed Graph)
        • Edit 3.0 (Edit)
        • Generate (text and image)
        • Remix (mixed image)
        • Upscale (enlarged high-definition)
        • Describe
        • Edit
      • Flux(images)
        • Create Task - General
        • generate image
        • Fine tuning (temporarily unavailable)
        • query task
        • Generate image (replica format)
      • Replicate(image)
        • Create Task - General
        • Create task - float kontext pro, max
        • Create task-black forest labs/flux-1.1-pro
        • Create task-black forest labs/flux-1.1-pro ultra
        • query task
        • Create task
      • Recraft(images)
        • Generate Image
        • Vectorize Image
        • Remove Background
        • Clarity Upscale
        • Create style
        • Generative Upscale
    • Music Generation
      • Suno
        • Set suno version
        • Suno API Scenario Application Guide
        • Generate lyrics
        • Generate music
        • Upload music
        • Song Splicing
        • Full track acoustic separation
        • Single track acoustic separation
        • Create a new Persona
        • Query a single task
        • Generate MP4 MV video
        • Retrieve WAV format files
        • Timing: Lyrics, audio timeline
        • Batch query task
        • Create music using persona_id
      • Udio (not available yet)
        • Generate music
        • Query a single task
    • Video Generation
      • veo3
        • veo3-chat format
        • Submit video generation task
        • Check the video generation status
      • Dream Test
        • seedance
      • runway(video)
        • Official format
          • Generate videos from images
          • Get detailed task information
        • Reverse format
          • Generate (text)
          • Generate (refer to image)
          • Video2video video to video style redrawing
          • Act one emoji transfer
          • Feed - Get Task
      • kling (video)
        • Callback Protocol
        • image expansion
        • generate image
        • text-to-video
        • image-to-video
        • Video extension
        • Virtual try on
        • lip-sync
        • video effects
        • Query task (single)
      • luma (video)
        • Official API format
          • generate video
            POST
          • Single query task
            GET
      • MiniMax Conch (video)
        • Official Documentation
        • video generation
        • query task
        • File Download
      • PIKA(video)
        • Universal version
          • generate video
          • Query video tasks
        • Generate (reference video/extended video)
        • Generate (refer to image)
        • Generate (text)
        • feed
      • sora
        • Reverse format
          • Create video
          • Generate Video
          • Query video tasks
    • Audio
      • Text to audio conversion
      • audio to text
      • Create translation
  • Integration Guide
    • Best Practices
      • Claude code access instructions
      • ElkAPI Account Balance Query API Usage Instructions
      • Retry logic documentation using ElkAPI and OpenAI's official API
      • Midjorney Calling Best Practices
      • Runway Call Best Practices
    • Application Integration Guide
  • Pricing and Billing
    • About Price
    • About Grouping
  • Help Center
    • Help Center
    • Interface stability
    • Common Misconceptions
    • Use confusion
    • Privacy Policy
    • Terms of Service
  1. Official API format

Single query task

GET
https://api.elkapi.com/dream-machine/v1/generations/{task_id}

Request

Path Params

Header Params

Responses

🟢200Successful Response
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.elkapi.com/dream-machine/v1/generations/48a94ce2-ce6c-4184-aa59-bdf3409b162b' \
--header 'Authorization: Bearer {{api-key}}'
Response Response Example
{
  "id": "f8ec5bf5-a860-420e-b663-5a478e0d5301",
  "state": "completed",
  "video": {
    "url": "https://storage.cdn-luma.com/dream-machine/af45d2e2-5175-4339-a6e5-2456e73f308b/4cd5e5d4-c760-42b6-9ddc-cd892c732302/2025-05-16T02-38-11_generation.mp4",
    "width": 1360,
    "height": 752,
    "duration": 5.041667,
    "download_url": "https://storage.cdn-luma.com/dream-machine/af45d2e2-5175-4339-a6e5-2456e73f308b/4cd5e5d4-c760-42b6-9ddc-cd892c732302/2025-05-16T02-38-11_generation.mp4"
  },
  "thumbnail": {
    "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/bbccab18-6661-4a63-adf1-069f838e9f00/public",
    "width": 1360,
    "height": 752,
    "palette": {
      "grid": "/f39/v7+/v7+/v7+/Pz8/Pz8/v7+/v7+/v7+/Pz8/Pz8/v7+/v7+/v7+/Pz8/Pz8/v7+/f39/v7++/v7/Pz8/f3+/f39/v7+/Pz8"
    },
    "media_type": "image"
  },
  "video_raw": {
    "url": "https://storage.cdn-luma.com/dream-machine/af45d2e2-5175-4339-a6e5-2456e73f308b/4cd5e5d4-c760-42b6-9ddc-cd892c732302/2025-05-16T02-38-11_generation.mp4",
    "width": 1360,
    "height": 752,
    "duration": 5.041667,
    "media_type": "video"
  },
  "created_at": "0001-01-01T00:00:00Z",
  "last_frame": {
    "url": "https://storage.cdn-luma.com/dream-machine/af45d2e2-5175-4339-a6e5-2456e73f308b/5d994815-caf7-4453-a4f8-aa804da8d310/2025-05-16T02-38-11_generation_last_frame.jpg",
    "width": 1360,
    "height": 752,
    "palette": null,
    "media_type": "image"
  }
}
Previous
generate video
Next
Official Documentation
Built with