API Doc-ElkAPI
  1. Reverse 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
          • Single query task
      • 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
            POST
          • Generate Video
            POST
          • Query video tasks
            GET
    • 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. Reverse format

Query video tasks

Developing
GET
https://api.elkapi.com/sora/v1/videos/{task_id}

Request

Path Params

Header Params

Responses

🟢200success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.elkapi.com/sora/v1/videos/task_01jhjnz502ejqsm6r37km2q637' \
--header 'Authorization: Bearer  {{api-key}}'
Response Response Example
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_01jhjp54x0f759wceyasz6xrge",
    "notify_hook": "",
    "action": "sora-video",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1736867805,
    "start_time": 0,
    "finish_time": 1736867860,
    "progress": "100%",
    "data": {
      "actions": {
        "0": "A man with insect-like features, including large compound eyes and translucent wings, hovers in the air against a backdrop of towering city skyscrapers. His appearance is a blend of human and fly, with a sleek, aerodynamic body covered in a shiny, chitinous exoskeleton. The sun sets behind the skyline, casting long shadows across the scene. The air around him shimmers as his wings buzz rapidly, keeping him aloft.",
        "75": "The fly man performs a series of agile maneuvers, showcasing his aerial acrobatics."
      },
      "created_at": "2025-01-14T15:15:46.724124Z",
      "estimated_queue_wait_time": null,
      "failure_reason": null,
      "generations": [
        {
          "actions": {
            "0": "A man with insect-like features, including large compound eyes and translucent wings, hovers in the air against a backdrop of towering city skyscrapers. His appearance is a blend of human and fly, with a sleek, aerodynamic body covered in a shiny, chitinous exoskeleton. The sun sets behind the skyline, casting long shadows across the scene. The air around him shimmers as his wings buzz rapidly, keeping him aloft.",
            "75": "The fly man performs a series of agile maneuvers, showcasing his aerial acrobatics."
          },
          "can_download": true,
          "caption": {
            "0": "wide-angle shot with a vibrant color palette and dramatic lighting, capturing a futuristic landscape as the backdrop. the view focuses on a man with insect-like features hovering in the air against a towering backdrop of city skyscrapers. his large compound eyes and translucent wings are prominent, while his sleek, aerodynamic body is covered in a shiny, chitinous exoskeleton. the setting sun casts long, exaggerated shadows across the skyscrapers, creating a riveting contrast with his otherworldly appearance. the air around him shimmers in the sunlight, as his wings buzz rapidly, keeping him aloft. the atmosphere is both surreal and awe-inspiring, showcasing the unique fusion of human and insect anatomy.",
            "75": "wide-angle shot with a vibrant color palette and dramatic lighting, capturing a futuristic urban environment. the focus remains on the man with insect-like features, now performing a series of agile maneuvers in the air. his aerial acrobatics are dynamic and fluid, showcasing his immense agility and control. his translucent wings shimmer and blur in motion, sustaining his flight with effortless grace. the vista of towering skyscrapers contrasts with his smooth, exuberant movements, while the setting sun continues to cast long shadows, enhancing the dramatic atmosphere. the scene unfolds with a sense of exhilarating freedom and the spectacle of an extraordinary blend of human and fly capabilities."
          },
          "cf_thumbnail_url": null,
          "cloudflare_metadata": null,
          "config": {
            "actions": {
              "0": "A man with insect-like features, including large compound eyes and translucent wings, hovers in the air against a backdrop of towering city skyscrapers. His appearance is a blend of human and fly, with a sleek, aerodynamic body covered in a shiny, chitinous exoskeleton. The sun sets behind the skyline, casting long shadows across the scene. The air around him shimmers as his wings buzz rapidly, keeping him aloft.",
              "75": "The fly man performs a series of agile maneuvers, showcasing his aerial acrobatics."
            },
            "caption": {
              "0": "wide-angle shot with a vibrant color palette and dramatic lighting, capturing a futuristic landscape as the backdrop. the view focuses on a man with insect-like features hovering in the air against a towering backdrop of city skyscrapers. his large compound eyes and translucent wings are prominent, while his sleek, aerodynamic body is covered in a shiny, chitinous exoskeleton. the setting sun casts long, exaggerated shadows across the skyscrapers, creating a riveting contrast with his otherworldly appearance. the air around him shimmers in the sunlight, as his wings buzz rapidly, keeping him aloft. the atmosphere is both surreal and awe-inspiring, showcasing the unique fusion of human and insect anatomy.",
              "75": "wide-angle shot with a vibrant color palette and dramatic lighting, capturing a futuristic urban environment. the focus remains on the man with insect-like features, now performing a series of agile maneuvers in the air. his aerial acrobatics are dynamic and fluid, showcasing his immense agility and control. his translucent wings shimmer and blur in motion, sustaining his flight with effortless grace. the vista of towering skyscrapers contrasts with his smooth, exuberant movements, while the setting sun continues to cast long shadows, enhancing the dramatic atmosphere. the scene unfolds with a sense of exhilarating freedom and the spectacle of an extraordinary blend of human and fly capabilities."
            },
            "prompt": "fly man"
          },
          "created_at": "2025-01-14T15:16:28.791941Z",
          "download_status": "ready",
          "encodings": {
            "ld": {
              "duration_secs": 5,
              "height": 480,
              "path": "https://videos.openai.com/vg-assets/assets%2Ftask_01jhjp54x0f759wceyasz6xrge%2Ftask_01jhjp54x0f759wceyasz6xrge_genid_9fbb9402-72ec-4e3d-9481-d8be9ef31db2_25_01_14_15_16_277508%2Fvideos%2F00000_968194097%2Fld.mp4?st=2025-01-14T13%3A28%3A09Z&se=2025-01-20T14%3A28%3A09Z&sks=b&skt=2025-01-14T13%3A28%3A09Z&ske=2025-01-20T14%3A28%3A09Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=5f13508c-2274-47a2-9941-e8329f2d7b6a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=fnuwemoUSAYXmZsp3TVTs3AdE3bYDVBbx7OdOYGMs%2BI%3D&az=oaivgprodscus",
              "size": 363718,
              "ssim": 0.9114589,
              "width": 854
            },
            "md": {
              "duration_secs": 5,
              "height": 480,
              "path": "https://videos.openai.com/vg-assets/assets%2Ftask_01jhjp54x0f759wceyasz6xrge%2Ftask_01jhjp54x0f759wceyasz6xrge_genid_9fbb9402-72ec-4e3d-9481-d8be9ef31db2_25_01_14_15_16_277508%2Fvideos%2F00000_968194097%2Fmd.mp4?st=2025-01-14T13%3A28%3A09Z&se=2025-01-20T14%3A28%3A09Z&sks=b&skt=2025-01-14T13%3A28%3A09Z&ske=2025-01-20T14%3A28%3A09Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=5f13508c-2274-47a2-9941-e8329f2d7b6a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=lKTvJdLHcpyxPg5eds1v%2BRc4P7embZ2eLPiwFFIvybY%3D&az=oaivgprodscus",
              "size": 866705,
              "ssim": 0.960498,
              "width": 854
            },
            "source": {
              "duration_secs": 5,
              "height": 480,
              "path": "https://videos.openai.com/vg-assets/assets%2Ftask_01jhjp54x0f759wceyasz6xrge%2Ftask_01jhjp54x0f759wceyasz6xrge_genid_9fbb9402-72ec-4e3d-9481-d8be9ef31db2_25_01_14_15_16_277508%2Fvideos%2F00000_968194097%2Fsource.mp4?st=2025-01-14T13%3A28%3A09Z&se=2025-01-20T14%3A28%3A09Z&sks=b&skt=2025-01-14T13%3A28%3A09Z&ske=2025-01-20T14%3A28%3A09Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=5f13508c-2274-47a2-9941-e8329f2d7b6a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=0jw1aqljMIKb%2BIFQf2AWmVaQLJ%2B5%2BRVIJgbBn73XNlI%3D&az=oaivgprodscus",
              "size": 4034268,
              "ssim": 0.9911103,
              "width": 854
            },
            "spritesheet": {
              "path": "https://videos.openai.com/vg-assets/assets%2Ftask_01jhjp54x0f759wceyasz6xrge%2Ftask_01jhjp54x0f759wceyasz6xrge_genid_9fbb9402-72ec-4e3d-9481-d8be9ef31db2_25_01_14_15_16_277508%2Fvideos%2F00000_968194097%2Fsprite.jpg?st=2025-01-14T13%3A28%3A09Z&se=2025-01-20T14%3A28%3A09Z&sks=b&skt=2025-01-14T13%3A28%3A09Z&ske=2025-01-20T14%3A28%3A09Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=5f13508c-2274-47a2-9941-e8329f2d7b6a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=UFw6x4ONBjVoMICXwab58jMN9SOLyJuR9eOLlpud5w8%3D&az=oaivgprodscus",
              "size": null
            },
            "thumbnail": {
              "path": "https://videos.openai.com/vg-assets/assets%2Ftask_01jhjp54x0f759wceyasz6xrge%2Ftask_01jhjp54x0f759wceyasz6xrge_genid_9fbb9402-72ec-4e3d-9481-d8be9ef31db2_25_01_14_15_16_277508%2Fvideos%2F00000_968194097%2Fthumb.webp?st=2025-01-14T13%3A28%3A09Z&se=2025-01-20T14%3A28%3A09Z&sks=b&skt=2025-01-14T13%3A28%3A09Z&ske=2025-01-20T14%3A28%3A09Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=5f13508c-2274-47a2-9941-e8329f2d7b6a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=evmaa%2FGj9r4dQnzRyqo1s4NR1NKKGL5NC7%2F037Am1Ek%3D&az=oaivgprodscus",
              "size": null
            }
          },
          "has_feedback": false,
          "height": 480,
          "id": "gen_01jhjp646berwt0ezg1faay7mt",
          "inpaint_items": null,
          "interpolation": null,
          "is_archived": false,
          "is_favorite": false,
          "is_featured": false,
          "is_public": true,
          "legal_classifier_result": {
            "face": [
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              },
              {
                "l": -1,
                "p": 0,
                "v": false
              }
            ],
            "ip": [
              {
                "l": 788,
                "p": 0.98486328125,
                "v": false
              },
              {
                "l": 788,
                "p": 0.98291015625,
                "v": false
              },
              {
                "l": 788,
                "p": 0.970703125,
                "v": false
              },
              {
                "l": 788,
                "p": 0.9892578125,
                "v": false
              },
              {
                "l": 788,
                "p": 0.986328125,
                "v": false
              },
              {
                "l": 788,
                "p": 0.99365234375,
                "v": false
              },
              {
                "l": 788,
                "p": 0.99609375,
                "v": false
              },
              {
                "l": 788,
                "p": 0.98828125,
                "v": false
              },
              {
                "l": 788,
                "p": 0.98974609375,
                "v": false
              },
              {
                "l": 788,
                "p": 0.970703125,
                "v": false
              }
            ],
            "trademark": [
              {
                "l": 311,
                "p": 0.9990234375,
                "v": false
              },
              {
                "l": 311,
                "p": 0.99853515625,
                "v": false
              },
              {
                "l": 311,
                "p": 0.99853515625,
                "v": false
              },
              {
                "l": 311,
                "p": 0.99853515625,
                "v": false
              },
              {
                "l": 311,
                "p": 0.998046875,
                "v": false
              },
              {
                "l": 311,
                "p": 0.99755859375,
                "v": false
              },
              {
                "l": 311,
                "p": 0.99853515625,
                "v": false
              },
              {
                "l": 311,
                "p": 0.99658203125,
                "v": false
              },
              {
                "l": 311,
                "p": 0.9921875,
                "v": false
              },
              {
                "l": 311,
                "p": 0.99462890625,
                "v": false
              }
            ]
          },
          "max_visibility": null,
          "model": "turbo",
          "moderation_result": {
            "code": null,
            "is_output_rejection": false,
            "results_by_frame_index": {},
            "task_id": "task_01jhjp54x0f759wceyasz6xrge",
            "type": "passed"
          },
          "n_frames": 150,
          "operation": "simple_compose",
          "output_moderation_result": {
            "filter_results": {
              "election_misinformation": {
                "flagged_indices": null,
                "labels": [],
                "metadata": null,
                "reason": null,
                "type": "passed"
              },
              "moderation_api": {
                "flagged_indices": null,
                "labels": [],
                "metadata": {
                  "global": {
                    "A1": 0,
                    "A2": 0,
                    "A3": 0,
                    "C1": 0.001,
                    "C11": 0.006,
                    "C2": 0,
                    "E1": 0,
                    "E2": 0,
                    "E3": 0,
                    "H1": 0,
                    "H2": 0,
                    "H3": 0,
                    "IMG-C1": 0,
                    "IMG-C11": 0.005,
                    "IMG-C2": 0,
                    "IMG-S1": 0,
                    "IMG-SH": 0.002,
                    "IMG-V1": 0.006,
                    "IMG-V2+": 0.011,
                    "IMG-V4+": 0,
                    "JB1": 0,
                    "K1": 0,
                    "K2": 0,
                    "K3": 0,
                    "K4": 0,
                    "P1": 0,
                    "P2": 0,
                    "P3": 0,
                    "P4": 0,
                    "PD1": 0,
                    "PD4": 0,
                    "S1": 0.001,
                    "S3+": 0,
                    "S4": 0,
                    "SH": 0.001,
                    "TXT-C3": 0,
                    "TXT-C4": 0,
                    "V1": 0.019,
                    "V2+": 0.024,
                    "V4+": 0
                  }
                },
                "reason": null,
                "type": "passed"
              },
              "wellknown_figure": {
                "flagged_indices": null,
                "labels": [],
                "metadata": null,
                "reason": null,
                "type": "passed"
              }
            },
            "is_flagged": false,
            "is_terminal": false,
            "mapper_metadata": {
              "u18": {
                "is_child": false,
                "is_realistic": false,
                "rationale": "The images depict a large insect-like creature flying through a cityscape. There are no human figures present, so no children are visible."
              }
            },
            "original_prompt": "",
            "rewrite_results": {},
            "risk_level": 0,
            "type": "passed"
          },
          "paragen_status": null,
          "preset_id": null,
          "prompt": "fly man",
          "safety_classifier_result": [],
          "sdedit": null,
          "seed": 968194097,
          "task_id": "task_01jhjp54x0f759wceyasz6xrge",
          "title": "Aerial Acrobatics Fly Man",
          "url": "https://videos.openai.com/vg-assets/assets%2Ftask_01jhjp54x0f759wceyasz6xrge%2Ftask_01jhjp54x0f759wceyasz6xrge_genid_9fbb9402-72ec-4e3d-9481-d8be9ef31db2_25_01_14_15_16_277508%2Fvideos%2F00000_968194097_watermarked.mp4?st=2025-01-14T13%3A28%3A09Z&se=2025-01-20T14%3A28%3A09Z&sks=b&skt=2025-01-14T13%3A28%3A09Z&ske=2025-01-20T14%3A28%3A09Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=5f13508c-2274-47a2-9941-e8329f2d7b6a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=IvL2WVbSG20blL2aak7hPfAc9hQvU3D11S%2Bs1FJuNDw%3D&az=oaivgprodscus",
          "user": {
            "id": "user-EycidxDufsSNkq096Ee8M4XY",
            "username": null
          },
          "width": 854
        }
      ],
      "guidance": null,
      "height": 480,
      "id": "task_01jhjp54x0f759wceyasz6xrge",
      "inpaint_items": [],
      "interpolation": null,
      "model": "turbo",
      "moderation_result": {
        "code": null,
        "is_output_rejection": false,
        "results_by_frame_index": {},
        "task_id": "task_01jhjp54x0f759wceyasz6xrge",
        "type": "passed"
      },
      "n_frames": 150,
      "n_variants": 1,
      "needs_user_review": false,
      "operation": "simple_compose",
      "preset_id": null,
      "priority": 1,
      "progress_pct": null,
      "progress_pos_in_queue": null,
      "prompt": "fly man",
      "queue_status_message": null,
      "sdedit": null,
      "seed": null,
      "status": "succeeded",
      "style": "natural",
      "title": "Aerial Acrobatics Fly Man",
      "type": "video_gen",
      "user": "user-EycidxDufsSNkq096Ee8M4XY",
      "width": 854
    }
  }
}
Previous
Generate Video
Next
Text to audio conversion
Built with