Generate images, edit product photos, animate images, swap faces and lip-sync video. Start with a single image, then retrieve its result. Set api_key as a local secret in your environment; never publish it. Each generation request consumes credits. Send generation requests individually; do not run the entire collection. Source: https://docs.magichour.ai/api-reference/openapi.json (retrieved 2026-09-07T09:47:30.379Z). Schema checked. The nine-request collection was exercised against production on 2026-09-07; five generation flows completed. Results depend on inputs and selected models. Start with one request rather than running the whole collection.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"58041837","collectionId":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","publishedId":"2sBYAxPp2b","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-09-07T22:29:23.000Z"},"item":[{"name":"01 — Generate one image","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.environment.get(\"api_key\")) { console.error(\"Set api_key locally in the selected environment.\"); pm.execution.skipRequest(); }"],"id":"35a42290-5bc4-44be-8da1-db6aab8a3b36"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Request succeeded\", () => pm.expect(pm.response.code).to.be.within(200, 299));","if (pm.response.code >= 200 && pm.response.code < 300) {"," const result = pm.response.json();"," pm.test(\"Project ID returned\", () => pm.expect(result.id).to.be.a(\"string\").and.not.empty);"," if (result.id) pm.environment.set('image_project_id', result.id);","}"],"id":"0ba429c9-caa6-4df3-98af-86d95068ad49"}}],"id":"49bc5014-c6fd-4fce-ab4f-dc8429af895c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Postman first image\",\n \"image_count\": 1,\n \"model\": \"flux-schnell\",\n \"resolution\": \"640px\",\n \"style\": {\n \"prompt\": \"A studio photograph of a plain ceramic coffee cup on a pale blue background, soft natural light, no text.\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.magichour.ai/v1/ai-image-generator","description":"Send once, then run Get image result. This creates one image using a model available to free accounts; credits are still consumed.
\nCreate an AI image with advanced model selection and quality controls.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{api_key}}"}]},"isInherited":true,"source":{"_postman_id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","name":"Magic Hour — Generate and retrieve AI media","type":"collection"}},"urlObject":{"path":["v1","ai-image-generator"],"host":["https://api.magichour.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"49bc5014-c6fd-4fce-ab4f-dc8429af895c"},{"name":"02 — Get image result","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.environment.get(\"api_key\")) { console.error(\"Set api_key locally in the selected environment.\"); pm.execution.skipRequest(); }","if (!pm.environment.get('image_project_id')) { console.error('Set image_project_id before sending this request.'); pm.execution.skipRequest(); }"],"id":"a5f27ad6-76a4-4a4e-bebb-ce2bd6be81c6"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Request succeeded\", () => pm.expect(pm.response.code).to.be.within(200, 299));","if (pm.response.code === 200) {"," const result = pm.response.json();"," pm.test(\"Known project state\", () => pm.expect([\"queued\", \"rendering\", \"complete\", \"error\", \"canceled\", \"draft\"]).to.include(result.status));"," pm.test(\"Project did not fail or cancel\", () => pm.expect([\"error\", \"canceled\"]).not.to.include(result.status));"," if (result.status === \"complete\") pm.test(\"Download available\", () => pm.expect(result.downloads).to.be.an(\"array\").and.not.empty);","}"],"id":"1eee2929-6788-43ab-84c4-0c831ba2fa34"}}],"id":"3b2d7e14-e521-4b5d-bc84-fb6c4eac0506","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.magichour.ai/v1/image-projects/{{image_project_id}}","description":"Retrieves the image_project_id saved by the last image creation request. Repeat manually after several seconds while queued/rendering. Do not re-send the generation request.
\nCheck the progress of a image project. The downloads field is populated after a successful render.
Statuses
\nqueued — waiting to startrendering — in progresscomplete — ready; see downloadserror — a failure occurred (see error)canceled — user canceleddraft — not usedSet image_url to a direct image URL you own or a completed Magic Hour upload file_path. Default model and credit cost depend on plan.
\nWhat this API does
\nCreate the same Image To Video you can make in the browser, but programmatically, so you can automate it, run it at scale, or connect it to your own app or workflow.
\nGood for
\nHow it works (3 steps)
\nfile_path. complete, then download the result from downloads.Key options
\nface_swap_mode, start_seconds/end_seconds, or a text promptCost
Credits are only charged for the frames that actually render. You'll see an estimate when the job is queued, and the final total after it's done.
For detailed examples, see the product page.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{api_key}}"}]},"isInherited":true,"source":{"_postman_id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","name":"Magic Hour — Generate and retrieve AI media","type":"collection"}},"urlObject":{"path":["v1","image-to-video"],"host":["https://api.magichour.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"12c5a0fd-c974-4e8b-bc65-673c8a2dce59"},{"name":"04 — Get video result","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.environment.get(\"api_key\")) { console.error(\"Set api_key locally in the selected environment.\"); pm.execution.skipRequest(); }","if (!pm.environment.get('video_project_id')) { console.error('Set video_project_id before sending this request.'); pm.execution.skipRequest(); }"],"id":"d58bab2c-21c8-4765-ac8c-3327d703529d"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Request succeeded\", () => pm.expect(pm.response.code).to.be.within(200, 299));","if (pm.response.code === 200) {"," const result = pm.response.json();"," pm.test(\"Known project state\", () => pm.expect([\"queued\", \"rendering\", \"complete\", \"error\", \"canceled\", \"draft\"]).to.include(result.status));"," pm.test(\"Project did not fail or cancel\", () => pm.expect([\"error\", \"canceled\"]).not.to.include(result.status));"," if (result.status === \"complete\") pm.test(\"Download available\", () => pm.expect(result.downloads).to.be.an(\"array\").and.not.empty);","}"],"id":"de7565a8-548c-42c4-9a6e-d76519910c2f"}}],"id":"3d9b84b5-2e09-4e83-b643-2282576af9bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.magichour.ai/v1/video-projects/{{video_project_id}}","description":"Retrieves video_project_id saved by the last video request. Repeat manually while queued/rendering. Download from the returned downloads array after complete.
\nCheck the progress of a video project. The downloads field is populated after a successful render.
Statuses
\nqueued — waiting to startrendering — in progresscomplete — ready; see downloadserror — a failure occurred (see error)canceled — user canceleddraft — not usedSet image_url; send once, then Get image result.
\nEdit images with AI.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{api_key}}"}]},"isInherited":true,"source":{"_postman_id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","name":"Magic Hour — Generate and retrieve AI media","type":"collection"}},"urlObject":{"path":["v1","ai-image-editor"],"host":["https://api.magichour.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"9deb6308-c2e3-44b6-bf49-7d4cc1e15ff8"},{"name":"06 — Face swap a photo","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.environment.get(\"api_key\")) { console.error(\"Set api_key locally in the selected environment.\"); pm.execution.skipRequest(); }","if (!pm.environment.get('source_face_url')) { console.error('Set source_face_url before sending this request.'); pm.execution.skipRequest(); }","if (!pm.environment.get('target_image_url')) { console.error('Set target_image_url before sending this request.'); pm.execution.skipRequest(); }"],"id":"22be0528-a409-41a1-876d-140780885be3"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Request succeeded\", () => pm.expect(pm.response.code).to.be.within(200, 299));","if (pm.response.code >= 200 && pm.response.code < 300) {"," const result = pm.response.json();"," pm.test(\"Project ID returned\", () => pm.expect(result.id).to.be.a(\"string\").and.not.empty);"," if (result.id) pm.environment.set('image_project_id', result.id);","}"],"id":"5710e3a6-18aa-42cb-86e0-e15a925c57d9"}}],"id":"5aaade88-7eb6-46b2-871a-8cc5930b2a08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Postman consented face swap\",\n \"assets\": {\n \"face_swap_mode\": \"all-faces\",\n \"source_file_path\": \"{{source_face_url}}\",\n \"target_file_path\": \"{{target_image_url}}\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.magichour.ai/v1/face-swap-photo","description":"Use source and target images you have permission to use. Send once, then Get image result.
\nCreate a face swap photo. Each photo costs 10 credits. The height/width of the output image depends on your subscription. Please refer to our pricing page for more details
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{api_key}}"}]},"isInherited":true,"source":{"_postman_id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","name":"Magic Hour — Generate and retrieve AI media","type":"collection"}},"urlObject":{"path":["v1","face-swap-photo"],"host":["https://api.magichour.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"5aaade88-7eb6-46b2-871a-8cc5930b2a08"},{"name":"07 — Lip-sync five seconds","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.environment.get(\"api_key\")) { console.error(\"Set api_key locally in the selected environment.\"); pm.execution.skipRequest(); }","if (!pm.environment.get('video_url')) { console.error('Set video_url before sending this request.'); pm.execution.skipRequest(); }","if (!pm.environment.get('audio_url')) { console.error('Set audio_url before sending this request.'); pm.execution.skipRequest(); }"],"id":"482779f8-a7ac-4afa-a8c6-af6091efe155"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Request succeeded\", () => pm.expect(pm.response.code).to.be.within(200, 299));","if (pm.response.code >= 200 && pm.response.code < 300) {"," const result = pm.response.json();"," pm.test(\"Project ID returned\", () => pm.expect(result.id).to.be.a(\"string\").and.not.empty);"," if (result.id) pm.environment.set('video_project_id', result.id);","}"],"id":"e8713b0d-0e41-4445-950b-c66aba911f8b"}}],"id":"a84e439f-165a-4c5c-b9b0-5c012ebb1f90","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Postman lip sync\",\n \"start_seconds\": 0,\n \"end_seconds\": 5,\n \"max_fps_limit\": 12,\n \"assets\": {\n \"video_source\": \"file\",\n \"video_file_path\": \"{{video_url}}\",\n \"audio_file_path\": \"{{audio_url}}\"\n },\n \"style\": {\n \"generation_mode\": \"lite\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.magichour.ai/v1/lip-sync","description":"Set direct URLs or uploaded file paths for a consented video and audio at least five seconds long. Send once, then Get video result.
\nWhat this API does
\nCreate the same Lip Sync you can make in the browser, but programmatically, so you can automate it, run it at scale, or connect it to your own app or workflow.
\nGood for
\nHow it works (3 steps)
\nfile_path. complete, then download the result from downloads.Key options
\nface_swap_mode, start_seconds/end_seconds, or a text promptCost
Credits are only charged for the frames that actually render. You'll see an estimate when the job is queued, and the final total after it's done.
For detailed examples, see the product page.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{api_key}}"}]},"isInherited":true,"source":{"_postman_id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","id":"e17029a6-d3fe-4d99-94c9-f29c9f73077c","name":"Magic Hour — Generate and retrieve AI media","type":"collection"}},"urlObject":{"path":["v1","lip-sync"],"host":["https://api.magichour.ai"],"query":[],"variable":[]}},"response":[],"_postman_id":"a84e439f-165a-4c5c-b9b0-5c012ebb1f90"},{"name":"08 — Create image upload URL","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["if (!pm.environment.get(\"api_key\")) { console.error(\"Set api_key locally in the selected environment.\"); pm.execution.skipRequest(); }"],"id":"82dd5568-07b7-4f81-85bf-b62e79d16e7a"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Request succeeded\", () => pm.expect(pm.response.code).to.be.within(200, 299));","if (pm.response.code === 200) { const item = pm.response.json().items[0]; pm.environment.set(\"upload_url\", item.upload_url); pm.environment.set(\"image_url\", item.file_path); }"],"id":"b5b42a28-ed50-4de9-ad2c-2194c0fb8a99"}}],"id":"24d03760-351f-4d11-afd9-f166dcf14f9e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"items\": [\n {\n \"type\": \"image\",\n \"extension\": \"png\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.magichour.ai/v1/files/upload-urls","description":"Optional alternative to a public input URL. Generate a signed URL, then choose a PNG in Upload PNG bytes. Signed URLs expire.
\nGenerates a list of pre-signed upload URLs for the assets required. This API is only necessary if you want to upload to Magic Hour's storage. Refer to the Input Files Guide for more details.
\nThe response array will match the order of items in the request body.
\nValid file extensions per asset type:
\n\n\nNote:
\ngifis only supported for face swap APIvideo_file_pathfield.
Once you receive an upload URL, send a PUT request to upload the file directly.
Example:
\ncurl -X PUT --data '@/path/to/file/video.mp4' \\\n https://videos.magichour.ai/api-assets/id/video.mp4?<auth params from the API response>\nChoose the local PNG in Body → binary before sending. No Magic Hour Authorization header is sent to storage. Only use the signed URL from request 08. After success, image_url contains the file_path used by requests 03 and 05.
\n","urlObject":{"host":["{{upload_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"4f23740f-05df-40a6-947e-bd81371f35a1"}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{api_key}}"}]}},"variable":[{"key":"base_url","value":"https://api.magichour.ai"}]}