{"openapi":"3.1.0","info":{"title":"Krea API","version":"v1"},"tags":[{"name":"General","description":"Core API operations including job management and billing information"},{"name":"Assets","description":"Asset management endpoints for uploading and managing images, videos, audio files, and 3D models"},{"name":"Styles","description":"Style (LoRA) generation and management endpoints"},{"name":"Node Apps","description":"Executing custom node apps built in our nodes tool"},{"name":"Image","description":"Image generation endpoints"},{"name":"Image Enhance","description":"Image enhance endpoints"},{"name":"Video","description":"Video generation endpoints"}],"servers":[{"url":"https://api.krea.ai","description":"Krea API"}],"security":[{"bearerAuth":[]}],"paths":{"/jobs":{"get":{"tags":["General"],"summary":"List jobs","description":"List jobs with pagination and filtering. Returns jobs belonging to the authenticated user.","parameters":[{"in":"query","name":"cursor","description":"ISO 8601 timestamp cursor for pagination (jobs created before this time)","schema":{"type":"string","format":"date-time","description":"ISO 8601 timestamp cursor for pagination (jobs created before this time)"}},{"in":"query","name":"limit","description":"Number of items to return (1-1000, default: 100)","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100,"description":"Number of items to return (1-1000, default: 100)"}},{"in":"query","name":"types","description":"Comma-separated list of job types to filter (e.g., \"flux,k1,externalImage\")","schema":{"type":"string","description":"Comma-separated list of job types to filter (e.g., \"flux,k1,externalImage\")"}},{"in":"query","name":"status","description":"Filter by job status","schema":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"],"description":"Filter by job status"}}],"responses":{"200":{"description":"List of jobs","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"result":{"type":"object","properties":{"urls":{"type":"array","items":{"type":"string","format":"uri"}},"style_id":{"type":"string"}}}},"required":["job_id","status","created_at"]}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"]}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/jobs/{id}":{"get":{"tags":["General"],"summary":"Get a job by ID","parameters":[{"in":"path","name":"id","description":"A unique identifier for a job","schema":{"type":"string","description":"A unique identifier for a job","example":"4d0e5f97-9721-4422-b88c-73a9032d7de1"},"required":true}],"responses":{"200":{"description":"The most up-to-date state of the job. You can check when the job is completed by checking the `status` field. For completed loraTraining jobs, the result will include a `style_id` field.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"result":{"type":"object","properties":{"urls":{"type":"array","items":{"type":"string","format":"uri"}},"style_id":{"type":"string"}}}},"required":["job_id","status","created_at"]}}}},"404":{"description":"The job was not found or the client is not authorized to see it","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["General"],"summary":"Delete a job by ID","parameters":[{"in":"path","name":"id","description":"A unique identifier for a job","schema":{"type":"string","description":"A unique identifier for a job","example":"4d0e5f97-9721-4422-b88c-73a9032d7de1"},"required":true}],"responses":{"200":{"description":"The job was deleted successfully"},"404":{"description":"The job was not found or the client is not authorized to delete it","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/assets":{"post":{"tags":["Assets"],"summary":"Upload an asset","description":"Upload a new asset (image, video, audio, or 3D model). Accepts multipart/form-data with a file and optional description. Maximum file size: 75MB.","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"The file to upload (JPEG, PNG, WebP, HEIC, MP4, MOV, WebM, GLB, WAV, MP3). Maximum size: 75MB.","format":"binary"},"description":{"type":"string","description":"Optional description for the asset"}},"required":["file"]}}}},"responses":{"200":{"description":"Asset uploaded successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"image_url":{"type":"string","format":"uri"},"uploaded_at":{"type":"string","format":"date-time"},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"size_bytes":{"type":["number","null"]},"mime_type":{"type":["string","null"]},"description":{"type":"string"},"metadata":{}},"required":["id","image_url","uploaded_at","width","height","size_bytes","mime_type"]}}}},"400":{"description":"Invalid file type or size","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"get":{"tags":["Assets"],"summary":"List assets","description":"List assets with pagination.","parameters":[{"in":"query","name":"limit","description":"Number of items to return (1-1000, default: 100)","schema":{"type":"integer","minimum":1,"maximum":1000,"description":"Number of items to return (1-1000, default: 100)"}},{"in":"query","name":"cursor","description":"Cursor for pagination","schema":{"type":"string","format":"date-time","description":"Cursor for pagination"}}],"responses":{"200":{"description":"List of assets","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"image_url":{"type":"string","format":"uri"},"uploaded_at":{"type":"string","format":"date-time"},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"size_bytes":{"type":["number","null"]},"mime_type":{"type":["string","null"]},"description":{"type":"string"},"metadata":{}},"required":["id","image_url","uploaded_at","width","height","size_bytes","mime_type"]}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/assets/{id}":{"get":{"tags":["Assets"],"summary":"Get an asset","description":"Get a single asset by ID","parameters":[{"in":"path","name":"id","description":"Asset ID","schema":{"type":"string","format":"uuid","description":"Asset ID"},"required":true}],"responses":{"200":{"description":"Asset details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"image_url":{"type":"string","format":"uri"},"uploaded_at":{"type":"string","format":"date-time"},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"size_bytes":{"type":["number","null"]},"mime_type":{"type":["string","null"]},"description":{"type":"string"},"metadata":{}},"required":["id","image_url","uploaded_at","width","height","size_bytes","mime_type"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Assets"],"summary":"Delete an asset","description":"Delete an asset.","parameters":[{"in":"path","name":"id","description":"Asset ID","schema":{"type":"string","format":"uuid","description":"Asset ID"},"required":true}],"responses":{"200":{"description":"Asset deleted successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Asset not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/styles/train":{"post":{"tags":["Styles"],"summary":"Train a custom style (LoRA)","description":"Train a custom style (LoRA) with simplified parameters. Uses intelligent defaults based on the training type (Default/Style/Object/Character).\n\n**Note:** Trained styles are private and only usable by the API user that created them. To allow other workspace members to use the style, share it with the workspace using `POST /styles/{id}/share/workspace`.\n| Model | Compute Units/Step |\n|-------|-------------------|\n| **qwen** | ~8.3 |\n| **wan22** | ~5.3 |\n| **flux_schnell** | ~3.4 |\n| **wan** | ~3.4 |\n| **flux_dev** | ~3.0 |\n| **z-image** | ~2.4 |","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"model":{"type":"string","enum":["flux_dev","flux_schnell","wan","wan22"],"default":"flux_dev"},"type":{"type":"string","enum":["Style","Object","Character","Default"],"default":"Default"},"name":{"type":"string"},"urls":{"type":"array","items":{"type":"string","format":"uri"}},"trigger_word":{"type":"string"},"learning_rate":{"type":"number"},"max_train_steps":{"type":"integer","minimum":1,"maximum":2000},"batch_size":{"type":"integer","minimum":1}},"required":["name","urls"]},{"type":"object","properties":{"model":{"type":"string","enum":["qwen","z-image"]},"type":{"type":"string","enum":["Style","Object","Character"],"default":"Style"},"name":{"type":"string"},"urls":{"type":"array","items":{"type":"string","format":"uri"}},"trigger_word":{"type":"string"},"max_train_steps":{"type":"integer","minimum":1,"maximum":2000}},"required":["model","name","urls"]}]}}}},"responses":{"200":{"description":"Training job created successfully. The job will be in a pending state until completed. Use /jobs/{id} to check progress.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Maximum number of concurrent jobs reached","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/styles":{"get":{"tags":["Styles"],"summary":"Search styles","description":"List styles with pagination and filtering. Returns public styles, user-created styles, or shared styles based on the filter parameter.","parameters":[{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":1000}},{"in":"query","name":"ids","schema":{"type":"string"}},{"in":"query","name":"liked","schema":{"type":"boolean","default":false}},{"in":"query","name":"user","schema":{"type":"string"}},{"in":"query","name":"model","schema":{"type":"string"}},{"in":"query","name":"filter","schema":{"type":"string","enum":["all","user","community","krea","shared","unapproved","editor","gallery","public"],"default":"all"}}],"responses":{"200":{"description":"List of styles","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the style"},"title":{"type":["string","null"],"description":"Name of the style"},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Portrait-oriented preview URLs"},"public":{"type":"boolean","description":"Whether the style is publicly visible"},"cover_url":{"type":["string","null"],"format":"uri","description":"Cover image URL"},"prompt":{"type":"string","description":"Suggested prompt for using this style"},"models":{"type":"array","items":{"type":"string"},"description":"Compatible model names (e.g., flux_dev, wan)"},"owner":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"avatar_url":{"type":["string","null"],"format":"uri"}},"required":["id","name"],"description":"Style creator info (null for Krea-official styles)"},"like_count":{"type":"number","description":"Number of likes"},"created_at":{"type":"string","description":"Creation timestamp"}},"required":["id","title","urls","public","prompt","owner","like_count","created_at"],"description":"Style response schema"}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"]}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/styles/{id}":{"get":{"tags":["Styles"],"summary":"Get a single style by ID","description":"Get a single style by ID. Returns public styles or your own private styles.","parameters":[{"in":"path","name":"id","description":"A unique identifier for a style","schema":{"type":"string","description":"A unique identifier for a style","example":"a816d79d-55c9-43ee-81c3-8330ffe79e6c"},"required":true}],"responses":{"200":{"description":"Style details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the style"},"title":{"type":["string","null"],"description":"Name of the style"},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Portrait-oriented preview URLs"},"public":{"type":"boolean","description":"Whether the style is publicly visible"},"cover_url":{"type":["string","null"],"format":"uri","description":"Cover image URL"},"prompt":{"type":"string","description":"Suggested prompt for using this style"},"models":{"type":"array","items":{"type":"string"},"description":"Compatible model names (e.g., flux_dev, wan)"},"owner":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"avatar_url":{"type":["string","null"],"format":"uri"}},"required":["id","name"],"description":"Style creator info (null for Krea-official styles)"},"like_count":{"type":"number","description":"Number of likes"},"created_at":{"type":"string","description":"Creation timestamp"}},"required":["id","title","urls","public","prompt","owner","like_count","created_at"],"description":"Style response schema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Style not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"tags":["Styles"],"summary":"Update a style","description":"Update style properties. Currently supports updating the public visibility of a style you own.","parameters":[{"in":"path","name":"id","description":"A unique identifier for a style","schema":{"type":"string","description":"A unique identifier for a style","example":"a816d79d-55c9-43ee-81c3-8330ffe79e6c"},"required":true}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"public":{"type":["boolean","null"]},"urls":{"type":"array","items":{"type":"string","format":"uri"}},"title":{"type":"string"},"cover_url":{"type":"string"}}}}}},"responses":{"200":{"description":"Style updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the style"},"title":{"type":["string","null"],"description":"Name of the style"},"urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Portrait-oriented preview URLs"},"public":{"type":"boolean","description":"Whether the style is publicly visible"},"cover_url":{"type":["string","null"],"format":"uri","description":"Cover image URL"},"prompt":{"type":"string","description":"Suggested prompt for using this style"},"models":{"type":"array","items":{"type":"string"},"description":"Compatible model names (e.g., flux_dev, wan)"},"owner":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"avatar_url":{"type":["string","null"],"format":"uri"}},"required":["id","name"],"description":"Style creator info (null for Krea-official styles)"},"like_count":{"type":"number","description":"Number of likes"},"created_at":{"type":"string","description":"Creation timestamp"}},"required":["id","title","urls","public","prompt","owner","like_count","created_at"],"description":"Style response schema"}}}},"400":{"description":"No valid fields to update","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Style not found or you are not the owner","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/styles/{id}/share/link":{"get":{"tags":["Styles"],"summary":"Get a shareable link for a style","description":"Generate or retrieve a shareable link for a style you own. The link allows others to access the style.","parameters":[{"in":"path","name":"id","description":"A unique identifier for a style","schema":{"type":"string","description":"A unique identifier for a style","example":"a816d79d-55c9-43ee-81c3-8330ffe79e6c"},"required":true}],"responses":{"200":{"description":"Shareable link retrieved (existing link)","content":{"application/json":{"schema":{"type":"object","properties":{"share_link":{"type":"string","format":"uri","description":"Shareable URL for the style"},"is_new":{"type":"boolean","description":"Whether the share link is new"}},"required":["share_link","is_new"],"description":"Response containing a shareable link for a style"}}}},"201":{"description":"Shareable link created (new link)","content":{"application/json":{"schema":{"type":"object","properties":{"share_link":{"type":"string","format":"uri","description":"Shareable URL for the style"},"is_new":{"type":"boolean","description":"Whether the share link is new"}},"required":["share_link","is_new"],"description":"Response containing a shareable link for a style"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Style not found or you are not the owner","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/styles/{id}/share/workspace":{"post":{"tags":["Styles"],"summary":"Share a style with your workspace","description":"Share a style you own with your API workspace. All members of the workspace will be able to use the style.","parameters":[{"in":"path","name":"id","description":"A unique identifier for a style","schema":{"type":"string","description":"A unique identifier for a style","example":"a816d79d-55c9-43ee-81c3-8330ffe79e6c"},"required":true}],"responses":{"200":{"description":"Style shared with workspace successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the operation succeeded"},"style_id":{"type":"string","description":"The ID of the shared style"},"workspace":{"type":"object","properties":{"id":{"type":"string","description":"Workspace ID"},"name":{"type":["string","null"],"description":"Workspace name"},"is_default":{"type":"boolean","description":"Whether this is the default workspace"}},"required":["id","name","is_default"],"description":"The workspace the style was shared with"}},"required":["success","style_id","workspace"],"description":"Response after sharing a style within a workspace"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"You do not own this style or are not a member of the workspace","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Style not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"tags":["Styles"],"summary":"Remove a style from your workspace","description":"Remove a style you own from your API workspace. Workspace members will no longer have access to the style.","parameters":[{"in":"path","name":"id","description":"A unique identifier for a style","schema":{"type":"string","description":"A unique identifier for a style","example":"a816d79d-55c9-43ee-81c3-8330ffe79e6c"},"required":true}],"responses":{"200":{"description":"Style removed from workspace successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"}},"required":["success"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"You do not own this style","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Style not found or not shared with this workspace","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/node-apps/{id}":{"get":{"tags":["Node Apps"],"summary":"Get a node app by version ID","description":"Get a single node app by version ID. Returns the node app details including input/output schemas.","parameters":[{"in":"path","name":"id","description":"Node app version ID","schema":{"type":"string","description":"Node app version ID"},"required":true}],"responses":{"200":{"description":"Node app details","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the node app"},"author_id":{"type":"string","description":"ID of the node app author"},"workspace_id":{"type":"string","description":"ID of the workspace that owns the node app"},"name":{"type":"string","description":"Name of the node app"},"slug":{"type":"string","description":"URL-friendly identifier for the node app"},"description":{"type":"string","description":"Description of the node app"},"scope":{"type":"string","description":"Visibility scope: \"public\", \"user\", or \"workspace\""},"created_at":{"type":"string","description":"Creation timestamp"},"updated_at":{"type":"string","description":"Last update timestamp"},"last_version_id":{"type":"string","description":"ID of the latest version of the node app"},"version":{"type":"number","description":"Selected node app version number"},"version_created_at":{"type":["string","null"],"description":"Creation timestamp of the latest version"},"username":{"type":"string","description":"Username of the node app creator"},"example_outputs":{"type":["array","null"],"items":{"type":"string"},"description":"Example output URLs"},"input_openapi_schema":{"type":["object","null"],"properties":{"type":{"type":"string","const":"object"},"properties":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"required":{"type":"array","items":{"type":"string"}}},"required":["type","properties"],"description":"OpenAPI 3.1 JSON Schema for input parameters"},"output_openapi_schema":{"type":["object","null"],"properties":{"type":{"type":"string","const":"object"},"properties":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"required":{"type":"array","items":{"type":"string"}}},"required":["type","properties"],"description":"OpenAPI 3.1 JSON Schema for output values"},"input_key_mapping":{"type":["object","null"],"additionalProperties":{"type":"string"},"description":"Maps OpenAPI input keys to internal keys for execution"},"output_key_mapping":{"type":["object","null"],"additionalProperties":{"type":"string"},"description":"Maps internal output keys (nodeId-handleId) to API keys"}},"required":["id","author_id","workspace_id","name","slug","description","scope","created_at","updated_at","last_version_id","version","version_created_at","username","example_outputs","input_openapi_schema","output_openapi_schema","input_key_mapping","output_key_mapping"],"description":"Node app response schema"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Node app not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/node-apps/{id}/execute":{"post":{"tags":["Node Apps"],"summary":"Execute a node app","description":"Execute a node app by version ID. The request body should contain the input data as a JSON object matching the node app's input schema. Returns a job that can be tracked using /jobs/{id}.","parameters":[{"in":"path","name":"id","description":"Node app version ID","schema":{"type":"string","description":"Node app version ID"},"required":true}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{},"description":"Input data for the node app execution, matching the node app's input schema"}}}},"responses":{"200":{"description":"Execution job created successfully. The job will be in a processing state until completed. Use /jobs/{id} to check progress.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"result":{"type":"object","properties":{"urls":{"type":"array","items":{"type":"string","format":"uri"}},"style_id":{"type":"string"}}}},"required":["job_id","status","created_at"]}}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Node app version not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/bfl/flux-1-dev":{"post":{"tags":["Image"],"description":"Fast model. Best for LoRAs.\n| Compute Units | Average Completion Time |\n|---------------|-------------------------|\n| ~3 | ~7 seconds |\n> **Deprecated request fields:**\n>\n> - `imageUrl` -> `image_url` until 2026-06-19\n> - `presetStyles` -> `styles` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n> - `imageStyleRefs` -> `image_style_references` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Flux","x-krea-deprecated-field-aliases":[{"from":"imageUrl","to":"image_url","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"presetStyles","to":"styles","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"imageStyleRefs","to":"image_style_references","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":1800},"strength":{"type":"number","default":1},"seed":{"type":"number","default":3317551338},"steps":{"type":"integer","minimum":1,"maximum":100,"default":25},"width":{"type":"number","minimum":512,"maximum":2368,"default":1024},"height":{"type":"number","minimum":512,"maximum":2368,"default":1024},"guidance_scale_flux":{"type":"number","minimum":0,"maximum":24,"default":3},"image_url":{"type":["string","null"],"format":"uri"},"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strength":{"type":"number","minimum":-2,"maximum":2}},"required":["id","strength"]},"description":"Styles (typically LoRAs) to use for the generation"},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"description":"Image prompts to use for the generation"},"image_style_references":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"description":"Style references to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"An anime-inspired cyberpunk market in Neo Tokyo's heart."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/bfl/flux-1-kontext-dev":{"post":{"tags":["Image"],"description":"Frontier model designed for image editing, optimized for Krea\n| Compute Units | Average Completion Time |\n|---------------|-------------------------|\n| ~6 | ~23 seconds |\n> **Deprecated request fields:**\n>\n> - `imageUrl` -> `image_url` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Flux Kontext","x-krea-deprecated-field-aliases":[{"from":"imageUrl","to":"image_url","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":1800},"strength":{"type":"number","default":1},"seed":{"type":"number","default":3261419148},"steps":{"type":"integer","minimum":1,"maximum":100,"default":25},"width":{"type":"number","minimum":512,"maximum":2368,"default":1024},"height":{"type":"number","minimum":512,"maximum":2368,"default":1024},"guidance_scale_flux":{"type":"number","minimum":0,"maximum":24,"default":3},"image_url":{"type":["string","null"],"format":"uri"},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"maxItems":1,"description":"Image prompts to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Treehouses in the Amazon, woven amidst emerald canopies."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/google/nano-banana-pro":{"post":{"tags":["Image"],"description":"World's most intelligent model.\n| Resolution | Compute Units |\n|------------|---------------|\n| 1K | 60.1 |\n| 2K | 60.1 |\n| 4K | 120 |\n> **Deprecated request fields:**\n>\n> - `imageUrls` -> `image_urls` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Nano Banana Pro","x-krea-deprecated-field-aliases":[{"from":"imageUrls","to":"image_urls","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":3},"width":{"type":"number","description":"Width of the generated image."},"height":{"type":"number","description":"Height of the generated image."},"image_urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Image prompts to use for the generation. If provided, style images are ignored."},"aspect_ratio":{"type":"string","enum":["21:9","1:1","4:3","3:2","2:3","5:4","4:5","3:4","16:9","9:16"]},"resolution":{"type":"string","enum":["1K","2K","4K"],"default":"1K"},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"description":"Image prompts to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Rolling sand dunes, with the silhouette of a solitary camel caravan at dusk."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/google/nano-banana-2":{"post":{"tags":["Image"],"description":"Cheaper quality version of Nano Banana.\n| Resolution | Compute Units |\n|------------|---------------|\n| 1K | 34.4 |\n| 2K | 57.8 |\n| 4K | 86.5 |\n> **Deprecated request fields:**\n>\n> - `imageUrls` -> `image_urls` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Nano Banana 2","x-krea-deprecated-field-aliases":[{"from":"imageUrls","to":"image_urls","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":3},"width":{"type":"number","description":"Width of the generated image."},"height":{"type":"number","description":"Height of the generated image."},"image_urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Image prompts to use for the generation. If provided, style images are ignored."},"aspect_ratio":{"type":"string","enum":["4:1","21:9","1:1","4:3","3:2","2:3","5:4","4:5","3:4","16:9","9:16","1:4","1:8"]},"resolution":{"type":"string","enum":["1K","2K","4K"],"default":"1K"},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"description":"Image prompts to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A sprawling vineyard, with a rustic chateau overlooking the grape-laden vines."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/google/nano-banana":{"post":{"tags":["Image"],"description":"Most versatile intelligent model.\n| Compute Units |\n|---------------|\n| 22.3 |\n> **Deprecated request fields:**\n>\n> - `imageUrls` -> `image_urls` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Nano Banana","x-krea-deprecated-field-aliases":[{"from":"imageUrls","to":"image_urls","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","description":"Width of the generated image."},"height":{"type":"number","description":"Height of the generated image."},"image_urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"Image prompts to use for the generation. If provided, style images are ignored."},"aspect_ratio":{"type":"string","enum":["21:9","1:1","4:3","3:2","2:3","5:4","4:5","3:4","16:9","9:16"]},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"description":"Image prompts to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Seaside town at dusk, lantern boats setting sail, echoing serene slice-of-life anime aesthetics."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/bfl/flux-1.1-pro":{"post":{"tags":["Image"],"description":"Advanced yet efficent model from BFL.\n| Compute Units |\n|---------------|\n| 22.9 |","summary":"Flux 1.1 Pro","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":256,"maximum":1440},"height":{"type":"number","minimum":256,"maximum":1440},"seed":{"type":"number","default":1337}},"required":["prompt","width","height"],"additionalProperties":false},"example":{"prompt":"Rolling countryside with magical bathhouses and whispering forests, reminiscent of a Ghibli masterpiece.","width":1024,"height":1024}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/bfl/flux-1.1-pro-ultra":{"post":{"tags":["Image"],"description":"BFL's highest quality text to image model.\n| Compute Units |\n|---------------|\n| 34.4 |","summary":"Flux 1.1 Pro Ultra","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337},"raw":{"type":"boolean","default":true}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Cobblestone streets of a medieval town, with lanterns lighting up historic facades."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/ideogram/ideogram-2-turbo":{"post":{"tags":["Image"],"description":"Distilled version of Ideogram 2.0\n| Compute Units |\n|---------------|\n| 14.3 |","summary":"Ideogram 2.0A Turbo","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A bayou with moss-draped trees, silent except for the chorus of frogs and crickets."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/ideogram/ideogram-3":{"post":{"tags":["Image"],"description":"Highly aesthetic, general-purpose model.\n| Character Reference | Compute Units |\n|---------------------|---------------|\n| Yes | 85.9 |\n| No | 34.4 |\n> **Deprecated request fields:**\n>\n> - `characterReferenceImages` -> `character_reference_images` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Ideogram 3.0","x-krea-deprecated-field-aliases":[{"from":"characterReferenceImages","to":"character_reference_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337},"character_reference_images":{"type":"array","items":{"type":"string","format":"uri"}},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"description":"Image prompts to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Cliff dwellings in Colorado, echoing Anasazi songs."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/google/imagen-3":{"post":{"tags":["Image"],"description":"Google's previous generation image model.\n| Model | Compute Units |\n|-------|---------------|\n| Standard | 22.9 |","summary":"Imagen 3","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Adobe castles in Mali, sculpted by wind and time's hands."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/google/imagen-4":{"post":{"tags":["Image"],"description":"Google's current generation image model\n| Compute Units |\n|---------------|\n| 22.9 |","summary":"Imagen 4","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A sunflower field, stretching endlessly, turning in unison towards the sun."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/google/imagen-4-fast":{"post":{"tags":["Image"],"description":"Google's fastest image model\n| Compute Units |\n|---------------|\n| 11.5 |","summary":"Imagen 4 Fast","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Vibrant marketplace in the heart of a bamboo forest, influenced by traditional anime aesthetics."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/google/imagen-4-ultra":{"post":{"tags":["Image"],"description":"Google's best image model\n| Compute Units |\n|---------------|\n| 34.4 |","summary":"Imagen 4 Ultra","parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Night market under a starry sky, spirits peddling wares, echoing spirited-away vibes."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/runway/gen-4-image":{"post":{"tags":["Image"],"description":"Cinematic image model with references.\n| Compute Units | Average Completion Time |\n|---------------|-------------------------|\n| ~44 | ~38 seconds |\n> **Deprecated request fields:**\n>\n> - `referenceImages` -> `reference_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Runway Gen-4","x-krea-deprecated-field-aliases":[{"from":"referenceImages","to":"reference_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":1000},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"seed":{"type":"number","default":1337},"reference_images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"tag":{"type":"string","pattern":"^[a-z][a-z0-9_]+$","minLength":3,"maxLength":16}},"required":["url","tag"]},"minItems":1,"maxItems":3}},"required":["prompt","reference_images"],"additionalProperties":false},"example":{"prompt":"A bustling boardwalk beside a tranquil beach, with carnival lights twinkling at dusk."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/openai/gpt-image":{"post":{"tags":["Image"],"description":"Original ChatGPT image model.\n| Compute Units | Average Completion Time |\n|---------------|-------------------------|\n| ~179 | ~72 seconds |\n> **Deprecated request fields:**\n>\n> - `imageUrls` -> `image_urls` until 2026-06-19\n> - `presetStyles` -> `styles` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"ChatGPT Image","x-krea-deprecated-field-aliases":[{"from":"imageUrls","to":"image_urls","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"presetStyles","to":"styles","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"quality":{"type":"string","enum":["low","medium","high","auto"],"default":"auto"},"image_urls":{"type":"array","items":{"type":"string"}},"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strength":{"type":"number","minimum":-2,"maximum":2}},"required":["id","strength"]},"maxItems":5},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"maxItems":15,"description":"Image prompts to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A coral atoll, with hues of blue revealing marine life in clear lagoon waters."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/openai/gpt-image-2":{"post":{"tags":["Image"],"description":"Smart powerful model for editing.\n| Compute Units | Average Completion Time |\n|---------------|-------------------------|\n| ~127 | ~55 seconds |\n> **Deprecated request fields:**\n>\n> - `imageUrls` -> `image_urls` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"ChatGPT 2","x-krea-deprecated-field-aliases":[{"from":"imageUrls","to":"image_urls","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number"},"height":{"type":"number"},"quality":{"type":"string","enum":["low","medium","high","auto"],"default":"high"},"image_urls":{"type":"array","items":{"type":"string"},"maxItems":10},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"maxItems":10,"description":"Image prompts to use for the generation"}},"required":["prompt","width","height"],"additionalProperties":false},"example":{"prompt":"Rocky shoreline, with tide pools teeming with life and seabirds soaring above.","width":1024,"height":1024}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/luma/uni-1":{"post":{"tags":["Image"],"description":"Reasoning image model for prompt-faithful text to image.\n| Mode | Reference Images | Compute Units |\n|------|------------------|---------------|\n| standard | 0 | 23.1 |\n| standard | 1 | 24.9 |\n| standard | 2 | 26.6 |\n| standard | 3 | 28.3 |\n| standard | 4 | 30.0 |\n| standard | 5 | 31.7 |\n| standard | 6 | 33.4 |\n| standard | 7 | 35.2 |\n| standard | 8 | 36.9 |\n| standard | 9 | 38.6 |\n| max | 0 | 57.3 |\n| max | 1 | 59.0 |\n| max | 2 | 60.7 |\n| max | 3 | 62.4 |\n| max | 4 | 64.1 |\n| max | 5 | 65.9 |\n| max | 6 | 67.6 |\n| max | 7 | 69.3 |\n| max | 8 | 71.0 |\n| max | 9 | 72.7 |\n> **Deprecated request fields:**\n>\n> - `outputFormat` -> `output_format` until 2026-06-19\n> - `webSearch` -> `web_search` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Luma UNI-1","x-krea-deprecated-field-aliases":[{"from":"outputFormat","to":"output_format","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"webSearch","to":"web_search","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":6000},"width":{"type":"number","minimum":512,"maximum":8192,"default":1024},"height":{"type":"number","minimum":512,"maximum":8192,"default":1024},"mode":{"type":"string","enum":["standard","max"],"default":"standard"},"style":{"type":"string","enum":["auto","manga"],"default":"auto"},"output_format":{"type":["string","null"],"enum":["png","jpeg",null]},"web_search":{"type":"boolean","default":false},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"maxItems":9,"description":"Image prompts to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Stepping stones across a tranquil pond, leading to a tea house."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/bytedance/seedream-4":{"post":{"tags":["Image"],"description":"New high quality model for photorealism and text rendering\n| Compute Units |\n|---------------|\n| 17.2 |\n> **Deprecated request fields:**\n>\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Seedream 4","x-krea-deprecated-field-aliases":[{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","maximum":4096},"height":{"type":"number","maximum":4096},"seed":{"type":"number","default":1337},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"description":"Image prompts to use for the generation"}},"required":["prompt","width","height"],"additionalProperties":false},"example":{"prompt":"A Victorian greenhouse where each pane frames a universe.","width":1024,"height":1024}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/bytedance/seedream-5-lite":{"post":{"tags":["Image"],"description":"Medium quality model with reasoning and web search.\n| Compute Units |\n|---------------|\n| 20.0 |\n> **Deprecated request fields:**\n>\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Seedream 5 Lite","x-krea-deprecated-field-aliases":[{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"width":{"type":"number","maximum":4096},"height":{"type":"number","maximum":4096},"seed":{"type":"number","default":1337},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"maxItems":14,"description":"Image prompts to use for the generation"}},"required":["prompt","width","height"],"additionalProperties":false},"example":{"prompt":"Maori marae in New Zealand, carvings guarding ancient lore.","width":1024,"height":1024}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/qwen/2512":{"post":{"tags":["Image"],"description":"Affordable medium quality model.\n| Compute Units | Average Completion Time |\n|---------------|-------------------------|\n| ~9 | ~22 seconds |\n> **Deprecated request fields:**\n>\n> - `skipPromptExpansion` -> `skip_prompt_expansion` until 2026-06-19\n> - `presetStyles` -> `styles` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Qwen 2512","x-krea-deprecated-field-aliases":[{"from":"skipPromptExpansion","to":"skip_prompt_expansion","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"presetStyles","to":"styles","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"negative_prompt":{"type":"string","default":""},"width":{"type":"integer","default":1024},"height":{"type":"integer","default":1024},"num_inference_steps":{"type":"integer","default":30},"cfg_scale":{"type":"number","default":4},"seed":{"type":"number"},"skip_prompt_expansion":{"type":"boolean"},"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strength":{"type":"number","minimum":-2,"maximum":2}},"required":["id","strength"]},"description":"Styles (typically LoRAs) to use for the generation"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Majestic fjords with small fishing villages nestled at their bases."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/z-image/z-image":{"post":{"tags":["Image"],"description":"Fastest model. Realistic, low diversity.\n| Compute Units | Average Completion Time |\n|---------------|-------------------------|\n| ~1 | ~5 seconds |\n> **Deprecated request fields:**\n>\n> - `presetStyles` -> `styles` until 2026-06-19\n> - `skipPromptExpansion` -> `skip_prompt_expansion` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `imageUrl` -> `image_url` until 2026-06-19\n> - `styleImages` -> `style_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Z Image","x-krea-deprecated-field-aliases":[{"from":"presetStyles","to":"styles","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"skipPromptExpansion","to":"skip_prompt_expansion","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"imageUrl","to":"image_url","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleImages","to":"style_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"seed":{"type":"number"},"denoising_strength":{"type":"number","minimum":0,"maximum":1,"default":0.6},"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strength":{"type":"number","minimum":-2,"maximum":2}},"required":["id","strength"]},"description":"Styles (typically LoRAs) to use for the generation"},"skip_prompt_expansion":{"type":"boolean","default":false},"aspect_ratio":{"type":"string","enum":["1:1","4:3","2:3","16:9","9:16"],"description":"Aspect ratio. One of: 1:1, 4:3, 2:3, 16:9, 9:16."},"resolution":{"type":"string","enum":["1K"],"description":"Resolution scale. One of: 1K."},"image_url":{"type":["string","null"],"format":"uri"},"style_images":{"type":"array","items":{"type":"object","properties":{"strength":{"type":"number","minimum":-2,"maximum":2},"url":{"type":"string","format":"uri"}},"required":["strength"]},"maxItems":1,"description":"Image prompts to use for the generation"}},"required":["prompt","aspect_ratio","resolution"],"additionalProperties":false},"example":{"prompt":"Bustling train station, portals to different realms, in the style of adventure anime.","aspect_ratio":"1:1","resolution":"1K"}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/enhance/topaz/generative-enhance":{"post":{"tags":["Image Enhance"],"description":"Most powerful creative enhancer. Max 16K.\n> **Deprecated request fields:**\n>\n> - `imageUrl` -> `image_url` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Topaz Generative","x-krea-deprecated-field-aliases":[{"from":"imageUrl","to":"image_url","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","default":""},"width":{"type":"number","minimum":1,"maximum":32000},"height":{"type":"number","minimum":1,"maximum":32000},"seed":{"type":"number","default":1337},"image_url":{"type":"string","format":"uri"},"model":{"type":"string","enum":["Redefine","Recovery","Recovery V2","Reimagine"],"default":"Redefine"},"output_format":{"type":"string","enum":["png","jpg","webp"],"default":"jpg"},"subject_detection":{"type":"string","enum":["All","Foreground","Background"],"default":"All"},"face_enhancement":{"type":"boolean","default":false},"face_enhancement_creativity":{"type":"number","minimum":0,"maximum":1,"default":0.5},"face_enhancement_strength":{"type":"number","minimum":0,"maximum":1,"default":0.5},"crop_to_fill":{"type":"boolean","default":false},"upscaling_activated":{"type":"boolean","default":false},"image_scaling_factor":{"type":"number","minimum":1,"maximum":32,"default":1},"creativity":{"type":"integer","minimum":1,"maximum":6,"default":3},"texture":{"type":"integer","minimum":1,"maximum":5,"default":3},"sharpen":{"type":"number","minimum":0,"maximum":1,"default":0.5},"denoise":{"type":"number","minimum":0,"maximum":1,"default":0.5},"detail":{"type":"number","minimum":0,"maximum":1,"default":0.5}},"required":["width","height","image_url"],"additionalProperties":false},"example":{"width":1024,"height":1024,"image_url":"https://gen.krea.ai/images/0424f602-2999-4d0c-a46e-39cbf0ef384b.png"}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/enhance/topaz/standard-enhance":{"post":{"tags":["Image Enhance"],"description":"Powerful faithful upscaler. Up to 22K resolution. Best for photos.\n> **Deprecated request fields:**\n>\n> - `imageUrl` -> `image_url` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Topaz","x-krea-deprecated-field-aliases":[{"from":"imageUrl","to":"image_url","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","default":""},"width":{"type":"number","minimum":1,"maximum":32000},"height":{"type":"number","minimum":1,"maximum":32000},"seed":{"type":"number","default":1337},"image_url":{"type":"string","format":"uri"},"model":{"type":"string","enum":["Standard V2","Low Resolution V2","CGI","High Fidelity V2","Text Refine"]},"output_format":{"type":"string","enum":["png","jpg","webp"],"default":"jpg"},"subject_detection":{"type":"string","enum":["All","Foreground","Background"],"default":"All"},"face_enhancement":{"type":"boolean","default":false},"face_enhancement_creativity":{"type":"number","minimum":0,"maximum":1,"default":0.5},"face_enhancement_strength":{"type":"number","minimum":0,"maximum":1,"default":0.5},"crop_to_fill":{"type":"boolean","default":false},"upscaling_activated":{"type":"boolean","default":false},"image_scaling_factor":{"type":"number","minimum":1,"maximum":32,"default":1},"sharpen":{"type":"number","minimum":0,"maximum":1,"default":0.5},"denoise":{"type":"number","minimum":0,"maximum":1,"default":0.5},"fix_compression":{"type":"number","minimum":0,"maximum":1,"default":0.5},"strength":{"type":"number","minimum":0.01,"maximum":1,"default":0.5}},"required":["width","height","image_url","model"],"additionalProperties":false},"example":{"width":1024,"height":1024,"image_url":"https://gen.krea.ai/images/0424f602-2999-4d0c-a46e-39cbf0ef384b.png"}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/enhance/topaz/bloom-enhance":{"post":{"tags":["Image Enhance"],"description":"Creative upscaler that adds new details. Max 10K.\n> **Deprecated request fields:**\n>\n> - `imageUrl` -> `image_url` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Topaz Bloom","x-krea-deprecated-field-aliases":[{"from":"imageUrl","to":"image_url","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","default":""},"width":{"type":"number","minimum":1,"maximum":10000},"height":{"type":"number","minimum":1,"maximum":10000},"seed":{"type":"number","default":1337},"image_url":{"type":"string","format":"uri"},"model":{"type":"string","const":"Reimagine"},"output_format":{"type":"string","enum":["png","jpg","webp"],"default":"jpg"},"crop_to_fill":{"type":"boolean","default":false},"creativity":{"type":"integer","minimum":1,"maximum":9,"default":3},"face_preservation":{"type":"boolean","default":false},"color_preservation":{"type":"boolean","default":false},"upscaling_activated":{"type":"boolean","default":false},"image_scaling_factor":{"type":"number","minimum":1,"maximum":32,"default":1}},"required":["width","height","image_url","model"],"additionalProperties":false},"example":{"width":1024,"height":1024,"image_url":"https://gen.krea.ai/images/0424f602-2999-4d0c-a46e-39cbf0ef384b.png"}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-1":{"post":{"tags":["Video"],"description":"High-control model with 10s duration.\n| Mode | Duration | Compute Units |\n|------|----------|---------------|\n| std | 5s | 60.1 |\n| std | 10s | 120 |\n| pro | 5s | 210 |\n| pro | 10s | 421 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `cameraControl` -> `camera_control` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 1.0","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"cameraControl","to":"camera_control","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"camera_control":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"simple"},"config":{"type":"object","properties":{"zoom":{"type":"number","minimum":-10,"maximum":10},"roll":{"type":"number","minimum":-10,"maximum":10},"pan":{"type":"number","minimum":-10,"maximum":10},"tilt":{"type":"number","minimum":-10,"maximum":10},"vertical":{"type":"number","minimum":-10,"maximum":10},"horizontal":{"type":"number","minimum":-10,"maximum":10}}}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"down_back"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"forward_up"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"right_turn_forward"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"left_turn_forward"},"config":{"type":"null","default":null}},"required":["type"]}]},"end_image":{"type":"string","format":"uri"},"end_video":{"type":"string","format":"uri"},"mode":{"type":"string","enum":["std","pro"],"default":"std"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Ice citadel, frost mages and snow beasts, in a cool, fantasy anime style."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-1.5":{"post":{"tags":["Video"],"description":"Slow, quality model for complex scenes.\n| Mode | Duration | Compute Units |\n|------|----------|---------------|\n| pro | 5s | 210 |\n| pro | 10s | 421 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `cameraControl` -> `camera_control` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 1.5","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"cameraControl","to":"camera_control","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"camera_control":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"simple"},"config":{"type":"object","properties":{"zoom":{"type":"number","minimum":-10,"maximum":10},"roll":{"type":"number","minimum":-10,"maximum":10},"pan":{"type":"number","minimum":-10,"maximum":10},"tilt":{"type":"number","minimum":-10,"maximum":10},"vertical":{"type":"number","minimum":-10,"maximum":10},"horizontal":{"type":"number","minimum":-10,"maximum":10}}}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"down_back"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"forward_up"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"right_turn_forward"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"left_turn_forward"},"config":{"type":"null","default":null}},"required":["type"]}]},"end_image":{"type":"string","format":"uri"},"end_video":{"type":"string","format":"uri"},"mode":{"type":"string","const":"pro","default":"pro"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A serene Japanese koi pond garden, framed by cherry blossoms."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-1.6":{"post":{"tags":["Video"],"description":"Previous gen model for complex scenes.\n| Mode | Duration | Compute Units |\n|------|----------|---------------|\n| std | 5s | 120 |\n| std | 10s | 241 |\n| pro | 5s | 210 |\n| pro | 10s | 421 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `cameraControl` -> `camera_control` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 1.6","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"cameraControl","to":"camera_control","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"camera_control":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"simple"},"config":{"type":"object","properties":{"zoom":{"type":"number","minimum":-10,"maximum":10},"roll":{"type":"number","minimum":-10,"maximum":10},"pan":{"type":"number","minimum":-10,"maximum":10},"tilt":{"type":"number","minimum":-10,"maximum":10},"vertical":{"type":"number","minimum":-10,"maximum":10},"horizontal":{"type":"number","minimum":-10,"maximum":10}}}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"down_back"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"forward_up"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"right_turn_forward"},"config":{"type":"null","default":null}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"left_turn_forward"},"config":{"type":"null","default":null}},"required":["type"]}]},"end_image":{"type":"string","format":"uri"},"end_video":{"type":"string","format":"uri"},"mode":{"type":"string","enum":["std","pro"],"default":"std"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Desert caravan, mystical oases and sand sorcerers, channeling adventure anime vibes."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-2":{"post":{"tags":["Video"],"description":"High-quality model with great aesthetics.\n| Duration | Compute Units |\n|----------|---------------|\n| 5s | 802 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 2.0","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"type":"number","const":5,"default":5},"end_image":{"type":"string","format":"uri"},"mode":{"type":"string","enum":["master","pro"],"default":"master"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A hidden valley, with wildflowers carpeting the ground and cascading waterfalls."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-2.1":{"post":{"tags":["Video"],"description":"Frontier model with 1080p resolution.\n| Mode | Duration | Compute Units |\n|------|----------|---------------|\n| std | 5s | 143 |\n| std | 10s | 286 |\n| pro | 5s | 258 |\n| pro | 10s | 515 |\n| master | 5s | 802 |\n| master | 10s | 1604 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 2.1","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"end_image":{"type":"string","format":"uri"},"mode":{"type":"string","enum":["master","pro"],"default":"master"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"An Art Nouveau manor, where nature and architecture flirt."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-2.5":{"post":{"tags":["Video"],"description":"Improved dynamics and style adaptation.\n| Duration | Compute Units |\n|----------|---------------|\n| 5s | 200 |\n| 10s | 401 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 2.5","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"end_image":{"type":"string","format":"uri"},"mode":{"type":"string","const":"pro","default":"pro"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Cavern city glowing with crystals, inhabitants with glowing tattoos, channeling dark fantasy anime visuals."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-2.6":{"post":{"tags":["Video"],"description":"Frontier model with native audio.\n| Audio | Duration | Compute Units |\n|-------|----------|---------------|\n| No | 5s | 200 |\n| No | 10s | 401 |\n| Yes | 5s | 401 |\n| Yes | 10s | 802 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 2.6","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"end_image":{"type":"string","format":"uri"},"end_video":{"type":"string","format":"uri"},"generate_audio":{"type":"boolean","default":false}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Cybernetic skyline with flying cars and holograms, reflecting a futuristic anime realm."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-3.0":{"post":{"tags":["Video"],"description":"Frontier model with audio and up to 15s.\n| Mode | Audio | Duration | Compute Units |\n|------|-------|----------|---------------|\n| std | No | 3s | 289 |\n| std | No | 4s | 385 |\n| std | No | 5s | 481 |\n| std | No | 6s | 577 |\n| std | No | 7s | 674 |\n| std | No | 8s | 770 |\n| std | No | 9s | 866 |\n| std | No | 10s | 962 |\n| std | No | 11s | 1058 |\n| std | No | 12s | 1155 |\n| std | No | 13s | 1251 |\n| std | No | 14s | 1347 |\n| std | No | 15s | 1443 |\n| std | Yes | 3s | 433 |\n| std | Yes | 4s | 577 |\n| std | Yes | 5s | 722 |\n| std | Yes | 6s | 866 |\n| std | Yes | 7s | 1010 |\n| std | Yes | 8s | 1155 |\n| std | Yes | 9s | 1299 |\n| std | Yes | 10s | 1443 |\n| std | Yes | 11s | 1588 |\n| std | Yes | 12s | 1732 |\n| std | Yes | 13s | 1876 |\n| std | Yes | 14s | 2021 |\n| std | Yes | 15s | 2165 |\n| pro | No | 3s | 385 |\n| pro | No | 4s | 513 |\n| pro | No | 5s | 641 |\n| pro | No | 6s | 770 |\n| pro | No | 7s | 898 |\n| pro | No | 8s | 1026 |\n| pro | No | 9s | 1155 |\n| pro | No | 10s | 1283 |\n| pro | No | 11s | 1411 |\n| pro | No | 12s | 1540 |\n| pro | No | 13s | 1668 |\n| pro | No | 14s | 1796 |\n| pro | No | 15s | 1924 |\n| pro | Yes | 3s | 577 |\n| pro | Yes | 4s | 770 |\n| pro | Yes | 5s | 962 |\n| pro | Yes | 6s | 1155 |\n| pro | Yes | 7s | 1347 |\n| pro | Yes | 8s | 1540 |\n| pro | Yes | 9s | 1732 |\n| pro | Yes | 10s | 1924 |\n| pro | Yes | 11s | 2117 |\n| pro | Yes | 12s | 2309 |\n| pro | Yes | 13s | 2502 |\n| pro | Yes | 14s | 2694 |\n| pro | Yes | 15s | 2887 |\n| 4k | No | 3s | 722 |\n| 4k | No | 4s | 962 |\n| 4k | No | 5s | 1203 |\n| 4k | No | 6s | 1443 |\n| 4k | No | 7s | 1684 |\n| 4k | No | 8s | 1924 |\n| 4k | No | 9s | 2165 |\n| 4k | No | 10s | 2405 |\n| 4k | No | 11s | 2646 |\n| 4k | No | 12s | 2887 |\n| 4k | No | 13s | 3127 |\n| 4k | No | 14s | 3368 |\n| 4k | No | 15s | 3608 |\n| 4k | Yes | 3s | 722 |\n| 4k | Yes | 4s | 962 |\n| 4k | Yes | 5s | 1203 |\n| 4k | Yes | 6s | 1443 |\n| 4k | Yes | 7s | 1684 |\n| 4k | Yes | 8s | 1924 |\n| 4k | Yes | 9s | 2165 |\n| 4k | Yes | 10s | 2405 |\n| 4k | Yes | 11s | 2646 |\n| 4k | Yes | 12s | 2887 |\n| 4k | Yes | 13s | 3127 |\n| 4k | Yes | 14s | 3368 |\n| 4k | Yes | 15s | 3608 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n> - `multiPrompt` -> `multi_prompt` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling 3.0","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"multiPrompt","to":"multi_prompt","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":2500},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"type":"number","minimum":3,"maximum":15,"default":5},"end_image":{"type":"string","format":"uri"},"generate_audio":{"type":"boolean","default":false},"mode":{"type":"string","enum":["std","pro","4k"],"default":"std"},"multi_prompt":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string","maxLength":512},"duration":{"type":"number","minimum":1,"maximum":15}},"required":["prompt","duration"]}}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Bustling academy in a meteor, students harnessing star magic, resonating with cosmic anime themes."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/kling/kling-o1":{"post":{"tags":["Video"],"description":"Intelligent model that thinks before generating.\n| Video Reference | Duration | Compute Units |\n|-----------------|----------|---------------|\n| No | 3s | 192 |\n| No | 4s | 257 |\n| No | 5s | 321 |\n| No | 6s | 385 |\n| No | 7s | 449 |\n| No | 8s | 513 |\n| No | 9s | 577 |\n| No | 10s | 641 |\n| Yes | 3s | 289 |\n| Yes | 4s | 385 |\n| Yes | 5s | 481 |\n| Yes | 6s | 577 |\n| Yes | 7s | 674 |\n| Yes | 8s | 770 |\n| Yes | 9s | 866 |\n| Yes | 10s | 962 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `styleReferences` -> `style_references` until 2026-06-19\n> - `elementReferences` -> `element_references` until 2026-06-19\n> - `videoReference` -> `video_reference` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Kling o1","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"styleReferences","to":"style_references","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"elementReferences","to":"element_references","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"videoReference","to":"video_reference","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"type":"number","minimum":3,"maximum":10,"default":5},"end_image":{"type":"string","format":"uri"},"style_references":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"tag":{"type":"string","pattern":"^[a-z][a-z0-9_-]+$","minLength":3,"maxLength":16}},"required":["url","tag"]}},"element_references":{"type":"array","items":{"type":"object","properties":{"images":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1,"maxItems":3},"tag":{"type":"string","pattern":"^[a-z][a-z0-9_-]+$","minLength":3,"maxLength":16}},"required":["images","tag"]}},"video_reference":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"tag":{"type":"string","pattern":"^[a-z][a-z0-9_-]+$","minLength":3,"maxLength":16}},"required":["url","tag"]}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A Victorian greenhouse where each pane frames a universe."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/minimax/hailuo":{"post":{"tags":["Video"],"description":"High-quality model with camera control.\n| Duration | Compute Units |\n|----------|---------------|\n| 5s | 246 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `expandPrompt` -> `expand_prompt` until 2026-06-19\n> - `cameraControl` -> `camera_control` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Hailuo","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"expandPrompt","to":"expand_prompt","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"cameraControl","to":"camera_control","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"expand_prompt":{"type":"boolean","default":true},"camera_control":{"type":"array","items":{"type":"string"}},"model":{"type":"string","enum":["video-01","S2V-01","T2V-01-Director","I2V-01-Director"],"default":"video-01"},"subjects":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"character"},"image":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1}},"required":["type","image"]},"maxItems":1}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Urban jungle, street races with magical beasts, echoing urban fantasy anime vibes."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/minimax/hailuo-02":{"post":{"tags":["Video"],"description":"Frontier model with dynamic motion.\n| Resolution | Duration | Compute Units |\n|------------|----------|---------------|\n| 512p | 6s | 57.3 |\n| 512p | 7s | 180 |\n| 512p | 8s | 206 |\n| 512p | 9s | 232 |\n| 512p | 10s | 85.9 |\n| 768p | 6s | 155 |\n| 768p | 7s | 180 |\n| 768p | 8s | 206 |\n| 768p | 9s | 232 |\n| 768p | 10s | 258 |\n| 1080p | 6s | 309 |\n| 1080p | 7s | 361 |\n| 1080p | 8s | 412 |\n| 1080p | 9s | 464 |\n| 1080p | 10s | 515 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `expandPrompt` -> `expand_prompt` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Hailuo 02","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"expandPrompt","to":"expand_prompt","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"expand_prompt":{"type":"boolean","default":true},"model":{"type":"string","const":"MiniMax-Hailuo-02","default":"MiniMax-Hailuo-02"},"end_image":{"type":"string","format":"uri"},"resolution":{"type":"string","enum":["512p","768p","1080p"],"default":"768p"},"duration":{"type":"number","minimum":6,"maximum":10,"default":6}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A Dutch town with windmills turning slowly beside tulip fields."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/minimax/hailuo-2.3":{"post":{"tags":["Video"],"description":"Frontier model with dynamic motion.\n| Resolution | Duration | Compute Units |\n|------------|----------|---------------|\n| 768p | 6s | 160 |\n| 768p | 10s | 321 |\n| 1080p | 6s | 281 |\n| 1080p | 10s | 281 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `expandPrompt` -> `expand_prompt` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Hailuo 2.3","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"expandPrompt","to":"expand_prompt","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"expand_prompt":{"type":"boolean","default":true},"model":{"type":"string","const":"MiniMax-Hailuo-2.3","default":"MiniMax-Hailuo-2.3"},"end_image":{"type":"string","format":"uri"},"resolution":{"type":"string","enum":["768p","1080p"],"default":"768p"},"duration":{"anyOf":[{"type":"number","const":6},{"type":"number","const":10}],"default":6}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Scottish highlands, with lone bagpipers playing among stone ruins."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/minimax/hailuo-2.3-fast":{"post":{"tags":["Video"],"description":"Cheapest medium-quality model.\n| Resolution | Duration | Compute Units |\n|------------|----------|---------------|\n| 768p | 6s | 109 |\n| 768p | 10s | 183 |\n| 1080p | 6s | 189 |\n| 1080p | 10s | 189 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `expandPrompt` -> `expand_prompt` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Hailuo 2.3 Fast","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"expandPrompt","to":"expand_prompt","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"expand_prompt":{"type":"boolean","default":true},"model":{"type":"string","const":"MiniMax-Hailuo-2.3-fast","default":"MiniMax-Hailuo-2.3-fast"},"end_image":{"type":"string","format":"uri"},"resolution":{"type":"string","enum":["768p","1080p"],"default":"768p"},"duration":{"anyOf":[{"type":"number","const":6},{"type":"number","const":10}],"default":6}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Salt flats in Bolivia, reflecting heavens on Earth."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/alibaba/wan-2.1":{"post":{"tags":["Video"],"description":"Fastest low-quality model with LoRA.\n| Duration | Compute Units | Average Completion Time |\n|----------|---------------|-------------------------|\n| - | ~270 | ~97 seconds |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `presetStyles` -> `styles` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Wan 2.1","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"presetStyles","to":"styles","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"width":{"type":"number"},"height":{"type":"number"},"end_image":{"type":["string","null"],"format":"uri"},"end_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strength":{"type":"number","minimum":-2,"maximum":2}},"required":["id","strength"]}},"frame_num":{"type":"number"}},"required":["prompt","width","height"],"additionalProperties":false},"example":{"prompt":"Steampunk-inspired harbor, airships docking amidst steam and cogs, resonating with steampunk anime.","width":1024,"height":1024}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/alibaba/wan-2.2":{"post":{"tags":["Video"],"description":"Fast, lower-quality model from Alibaba.\n| Duration | Compute Units | Average Completion Time |\n|----------|---------------|-------------------------|\n| - | ~287 | ~113 seconds |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `presetStyles` -> `styles` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Wan 2.2","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"presetStyles","to":"styles","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"guide_scale":{"type":"array","items":{"type":"number"},"default":[4,3.5]},"width":{"type":"number"},"height":{"type":"number"},"end_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strength":{"type":"number","minimum":-2,"maximum":2}},"required":["id","strength"]}},"frame_num":{"type":"number"}},"required":["prompt","width","height"],"additionalProperties":false},"example":{"prompt":"Snow-clad village, its tranquility disrupted by mech battles, in the style of mecha anime.","width":1024,"height":1024}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/alibaba/wan-2.5":{"post":{"tags":["Video"],"description":"Latest medium quality model from Alibaba.\n| Resolution | Duration | Compute Units |\n|------------|----------|---------------|\n| 480p | 5s | 143 |\n| 480p | 6s | 172 |\n| 480p | 7s | 200 |\n| 480p | 8s | 229 |\n| 480p | 9s | 258 |\n| 480p | 10s | 286 |\n| 720p | 5s | 286 |\n| 720p | 6s | 344 |\n| 720p | 7s | 401 |\n| 720p | 8s | 458 |\n| 720p | 9s | 515 |\n| 720p | 10s | 573 |\n| 1080p | 5s | 430 |\n| 1080p | 6s | 515 |\n| 1080p | 7s | 601 |\n| 1080p | 8s | 687 |\n| 1080p | 9s | 773 |\n| 1080p | 10s | 859 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `enablePromptExpansion` -> `enable_prompt_expansion` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Wan 2.5","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"enablePromptExpansion","to":"enable_prompt_expansion","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"1080p"},"enable_prompt_expansion":{"type":"boolean","default":true},"duration":{"type":"number","minimum":5,"maximum":10,"default":5},"seed":{"type":"number"},"audio_url":{"type":"string","format":"uri"},"generate_audio":{"type":"boolean","default":false}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Tudor houses in England with chimneys like clustered toadstools."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/google/veo-2":{"post":{"tags":["Video"],"description":"Expensive high-quality model from Google.\n| Duration | Compute Units |\n|----------|---------------|\n| 5s | 1432 |\n| 6s | 1718 |\n| 7s | 2005 |\n| 8s | 2291 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `image_url` -> `start_image` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Veo 2","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"image_url","to":"start_image","sunset_date":"2026-06-19","reason":"Veo 2 image-to-video requests now use start_image for the initial frame.","migration_url":"https://docs.krea.ai/developers/deprecations#veo-2-start-image"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"type":"number","minimum":5,"maximum":8,"default":5}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Lush orchard, fruit granting mystical abilities, akin to magic-infused anime settings."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/google/veo-3":{"post":{"tags":["Video"],"description":"Older version of Veo 3.1.\n| Resolution | Audio | Duration | Compute Units |\n|------------|-------|----------|---------------|\n| 720p | No | 5s | 573 |\n| 720p | No | 6s | 687 |\n| 720p | No | 7s | 802 |\n| 720p | No | 8s | 916 |\n| 720p | Yes | 5s | 1145 |\n| 720p | Yes | 6s | 1375 |\n| 720p | Yes | 7s | 1604 |\n| 720p | Yes | 8s | 1833 |\n| 1080p | No | 5s | 573 |\n| 1080p | No | 6s | 687 |\n| 1080p | No | 7s | 802 |\n| 1080p | No | 8s | 916 |\n| 1080p | Yes | 5s | 1145 |\n| 1080p | Yes | 6s | 1375 |\n| 1080p | Yes | 7s | 1604 |\n| 1080p | Yes | 8s | 1833 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Veo 3","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"type":"number","enum":[4,6,8],"default":8},"generate_audio":{"type":"boolean","default":false},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Cybernetic skyline with flying cars and holograms, reflecting a futuristic anime realm."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/google/veo-3-fast":{"post":{"tags":["Video"],"description":"Faster, affordable Veo 3 with audio.\n| Resolution | Audio | Duration | Compute Units |\n|------------|-------|----------|---------------|\n| 720p | No | 5s | 286 |\n| 720p | No | 6s | 344 |\n| 720p | No | 7s | 401 |\n| 720p | No | 8s | 458 |\n| 720p | Yes | 5s | 430 |\n| 720p | Yes | 6s | 515 |\n| 720p | Yes | 7s | 601 |\n| 720p | Yes | 8s | 687 |\n| 1080p | No | 5s | 286 |\n| 1080p | No | 6s | 344 |\n| 1080p | No | 7s | 401 |\n| 1080p | No | 8s | 458 |\n| 1080p | Yes | 5s | 430 |\n| 1080p | Yes | 6s | 515 |\n| 1080p | Yes | 7s | 601 |\n| 1080p | Yes | 8s | 687 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Veo 3 Fast","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"default":"16:9"},"duration":{"type":"number","enum":[4,6,8],"default":8},"generate_audio":{"type":"boolean","default":false},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Cottages in the Cotswolds, roofs curved like elder scrolls."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/google/veo-3.1":{"post":{"tags":["Video"],"description":"Best video model. Highest quality with audio.\n| Resolution | Audio | Duration | Compute Units |\n|------------|-------|----------|---------------|\n| 720p | No | 4s | 458 |\n| 720p | No | 6s | 687 |\n| 720p | No | 8s | 916 |\n| 720p | Yes | 4s | 916 |\n| 720p | Yes | 6s | 1375 |\n| 720p | Yes | 8s | 1833 |\n| 1080p | No | 4s | 458 |\n| 1080p | No | 6s | 687 |\n| 1080p | No | 8s | 916 |\n| 1080p | Yes | 4s | 916 |\n| 1080p | Yes | 6s | 1375 |\n| 1080p | Yes | 8s | 1833 |\n| 4K | No | 4s | 916 |\n| 4K | No | 6s | 1375 |\n| 4K | No | 8s | 1833 |\n| 4K | Yes | 4s | 1375 |\n| 4K | Yes | 6s | 2062 |\n| 4K | Yes | 8s | 2749 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n> - `referenceImages` -> `reference_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Veo 3.1","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"referenceImages","to":"reference_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"type":"number","enum":[4,6,8],"default":8},"generate_audio":{"type":"boolean","default":false},"resolution":{"type":"string","enum":["720p","1080p","4K"],"default":"720p"},"end_image":{"type":["string","null"],"format":"uri"},"end_video":{"type":["string","null"],"format":"uri"},"reference_images":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Otherworldly inn, guests from different dimensions, in a style reminiscent of interdimensional anime."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/google/veo-3.1-fast":{"post":{"tags":["Video"],"description":"Faster, affordable Veo 3.1 with audio.\n| Resolution | Audio | Duration | Compute Units |\n|------------|-------|----------|---------------|\n| 720p | No | 4s | 183 |\n| 720p | No | 6s | 275 |\n| 720p | No | 8s | 367 |\n| 720p | Yes | 4s | 229 |\n| 720p | Yes | 6s | 344 |\n| 720p | Yes | 8s | 458 |\n| 1080p | No | 4s | 229 |\n| 1080p | No | 6s | 344 |\n| 1080p | No | 8s | 458 |\n| 1080p | Yes | 4s | 275 |\n| 1080p | Yes | 6s | 412 |\n| 1080p | Yes | 8s | 550 |\n| 4K | No | 4s | 573 |\n| 4K | No | 6s | 859 |\n| 4K | No | 8s | 1145 |\n| 4K | Yes | 4s | 687 |\n| 4K | Yes | 6s | 1031 |\n| 4K | Yes | 8s | 1375 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n> - `referenceImages` -> `reference_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Veo 3.1 Fast","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"referenceImages","to":"reference_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"type":"number","enum":[4,6,8],"default":8},"generate_audio":{"type":"boolean","default":false},"resolution":{"type":"string","enum":["720p","1080p","4K"],"default":"720p"},"end_image":{"type":["string","null"],"format":"uri"},"end_video":{"type":["string","null"],"format":"uri"},"reference_images":{"type":"array","items":{"type":"string","format":"uri"}}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Bustling academy in a meteor, students harnessing star magic, resonating with cosmic anime themes."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/google/veo-3.1-lite":{"post":{"tags":["Video"],"description":"Faster, affordable Veo 3.1.\n| Resolution | Duration | Compute Units |\n|------------|----------|---------------|\n| 720p | 4s | 68.7 |\n| 720p | 6s | 103 |\n| 720p | 8s | 137 |\n| 1080p | 4s | 115 |\n| 1080p | 6s | 172 |\n| 1080p | 8s | 229 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Veo 3.1 Lite","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"type":"number","enum":[4,6,8],"default":8},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"},"end_image":{"type":["string","null"],"format":"uri"},"end_video":{"type":["string","null"],"format":"uri"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Moss-covered forest, with ancient trees and a floor lit by fireflies."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/bytedance/seedance-1.0-pro":{"post":{"tags":["Video"],"description":"Fast, high-quality model from ByteDance.\n| Resolution | Duration | Compute Units | Average Completion Time |\n|------------|----------|---------------|-------------------------|\n| 1080p | 5s | ~487 | ~78 seconds |\n| 720p | 5s | ~207 | ~57 seconds |\n| 1080p | 10s | ~947 | ~133 seconds |\n| 720p | 10s | ~389 | ~88 seconds |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `endVideo` -> `end_video` until 2026-06-19\n> - `referenceImages` -> `reference_images` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Seedance Pro","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endVideo","to":"end_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"referenceImages","to":"reference_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","21:9","9:21"],"default":"16:9"},"end_image":{"type":["string","null"],"format":"uri"},"end_video":{"type":["string","null"],"format":"uri"},"reference_images":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":4},"duration":{"type":"number","default":5},"resolution":{"type":"string","enum":["720p","1080p"],"default":"720p"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A lighthouse, its beam revealing stories in the mist."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/bytedance/seedance-1.0-pro-fast":{"post":{"tags":["Video"],"description":"Fast and cheap model. Up to 12 seconds.\n| Resolution | Duration | Compute Units | Average Completion Time |\n|------------|----------|---------------|-------------------------|\n| 1080p | 2s | ~79 | ~32 seconds |\n| 480p | 2s | ~16 | ~22 seconds |\n| 720p | 2s | ~34 | ~27 seconds |\n| 480p | 3s | ~23 | ~23 seconds |\n| 720p | 3s | ~50 | ~29 seconds |\n| 1080p | 4s | ~157 | ~44 seconds |\n| 480p | 4s | ~31 | ~28 seconds |\n| 720p | 4s | ~67 | ~35 seconds |\n| 1080p | 5s | ~196 | ~50 seconds |\n| 480p | 5s | ~39 | ~30 seconds |\n| 720p | 5s | ~84 | ~36 seconds |\n| 1080p | 6s | ~234 | ~57 seconds |\n| 480p | 6s | ~46 | ~32 seconds |\n| 720p | 6s | ~101 | ~41 seconds |\n| 720p | 7s | ~115 | ~42 seconds |\n| 1080p | 8s | ~312 | ~78 seconds |\n| 480p | 8s | ~61 | ~35 seconds |\n| 720p | 8s | ~135 | ~48 seconds |\n| 1080p | 10s | ~389 | ~78 seconds |\n| 480p | 10s | ~76 | ~44 seconds |\n| 720p | 10s | ~167 | ~56 seconds |\n| 1080p | 12s | ~466 | ~91 seconds |\n| 480p | 12s | ~92 | ~50 seconds |\n| 720p | 12s | ~200 | ~64 seconds |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Seedance Pro Fast","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","21:9","9:21"],"default":"16:9"},"duration":{"type":"number","minimum":2,"maximum":12,"default":5},"resolution":{"type":"string","enum":["480p","720p","1080p"],"default":"720p"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Hidden valley with petal-covered houses, fae folk festivities, channeling whimsical anime vibes."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/lightricks/ltx-video-2.3-22b":{"post":{"tags":["Video"],"description":"High-quality audio-video model from Lightricks.\n| LoRA | Duration | Compute Units |\n|------|----------|---------------|\n| No | 5s | 103 |\n| No | 10s | 205 |\n| No | 15s | 306 |\n| No | 20s | 408 |\n| Yes | 5s | 116 |\n| Yes | 10s | 231 |\n| Yes | 15s | 344 |\n| Yes | 20s | 459 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `generateAudio` -> `generate_audio` until 2026-06-19\n> - `endImage` -> `end_image` until 2026-06-19\n> - `presetStyles` -> `styles` until 2026-06-19\n> - `hasLora` -> `has_lora` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"LTX-2.3 22B","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"generateAudio","to":"generate_audio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"endImage","to":"end_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"presetStyles","to":"styles","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"hasLora","to":"has_lora","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"anyOf":[{"anyOf":[{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}]},{"type":"number","const":15}]},{"type":"number","const":20}],"default":5},"num_frames":{"type":"integer","minimum":9,"maximum":481},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"generate_audio":{"type":"boolean","default":true},"end_image":{"type":["string","null"],"format":"uri"},"styles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"strength":{"type":"number","minimum":-2,"maximum":2}},"required":["id","strength"]}},"has_lora":{"type":"boolean"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A hidden valley, with wildflowers carpeting the ground and cascading waterfalls."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/luma/ray-2":{"post":{"tags":["Video"],"description":"Older model with natural motion.\n| Duration | Compute Units |\n|----------|---------------|\n| 5s | 229 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Ray 2","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4","21:9","9:21"],"default":"16:9"},"loop":{"type":"boolean","default":false},"width":{"type":"number"},"height":{"type":"number"}},"required":["prompt","width","height"],"additionalProperties":false},"example":{"prompt":"Lush terraced farms, guarded by spirit animals, in a serene anime pastoral style.","width":1024,"height":1024}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/runway/gen-3":{"post":{"tags":["Video"],"description":"Old cinematic model, higher consistency.\n| Duration | Compute Units |\n|----------|---------------|\n| 5s | 143 |\n| 10s | 286 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Runway Gen-3","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["16:9","9:16"],"default":"16:9"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"seed":{"type":"number"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"A Van Gogh-tinged Provençal farmhouse under starry nights."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/runway/gen-4-video":{"post":{"tags":["Video"],"description":"Cinematic visuals, weaker structure.\n| Duration | Compute Units |\n|----------|---------------|\n| 5s | 143 |\n| 10s | 286 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Runway Gen-4","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["1280:720","720:1280"],"default":"1280:720"},"duration":{"anyOf":[{"type":"number","const":5},{"type":"number","const":10}],"default":5},"seed":{"type":"number"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Vibrant carnival in the heart of a volcano, fire dancers and ash beasts, in a fiery festival anime style."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/runway/gen-4.5":{"post":{"tags":["Video"],"description":"Frontier model with native text-to-video.\n| Duration | Compute Units |\n|----------|---------------|\n| 2s | 137 |\n| 3s | 206 |\n| 4s | 275 |\n| 5s | 344 |\n| 6s | 412 |\n| 7s | 481 |\n| 8s | 550 |\n| 9s | 619 |\n| 10s | 687 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Runway Gen-4.5","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string"},"start_image":{"type":"string","format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"aspect_ratio":{"type":"string","enum":["1280:720","720:1280","1104:832","832:1104","960:960","1584:672","672:1584"],"default":"1280:720"},"duration":{"type":"number","minimum":2,"maximum":10,"default":5},"seed":{"type":"number"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Terraced rice fields, painting verdant stairways to the heavens."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/xai/grok-video":{"post":{"tags":["Video"],"description":"Fast, high-quality video generation by xAI.\n| Resolution | Duration | Compute Units |\n|------------|----------|---------------|\n| 480p | 1s | 28.6 |\n| 480p | 2s | 57.3 |\n| 480p | 3s | 85.9 |\n| 480p | 4s | 115 |\n| 480p | 5s | 143 |\n| 480p | 6s | 172 |\n| 480p | 7s | 200 |\n| 480p | 8s | 229 |\n| 480p | 9s | 258 |\n| 480p | 10s | 286 |\n| 480p | 11s | 315 |\n| 480p | 12s | 344 |\n| 480p | 13s | 372 |\n| 480p | 14s | 401 |\n| 480p | 15s | 430 |\n| 720p | 1s | 40.1 |\n| 720p | 2s | 80.2 |\n| 720p | 3s | 120 |\n| 720p | 4s | 160 |\n| 720p | 5s | 200 |\n| 720p | 6s | 241 |\n| 720p | 7s | 281 |\n| 720p | 8s | 321 |\n| 720p | 9s | 361 |\n| 720p | 10s | 401 |\n| 720p | 11s | 441 |\n| 720p | 12s | 481 |\n| 720p | 13s | 521 |\n| 720p | 14s | 561 |\n| 720p | 15s | 601 |\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n> - `aspectRatio` -> `aspect_ratio` until 2026-06-19\n> - `referenceImages` -> `reference_images` until 2026-06-19\n> - `editVideo` -> `edit_video` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Grok Imagine","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"aspectRatio","to":"aspect_ratio","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"referenceImages","to":"reference_images","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"editVideo","to":"edit_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":4096},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"duration":{"type":"number","minimum":1,"maximum":15,"default":6},"resolution":{"type":"string","enum":["480p","720p"],"default":"720p"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","3:2","2:3"]},"reference_images":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":7},"edit_video":{"type":"string","format":"uri"}},"required":["prompt"],"additionalProperties":false},"example":{"prompt":"Eschers rendition of a Venetian canal house."}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/image/bytedance/seededit":{"post":{"tags":["Image"],"description":"New frontier model designed for image editing\n> **Deprecated request fields:**\n>\n> - `imageUrl` -> `image_url` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"SeedEdit","x-krea-deprecated-field-aliases":[{"from":"imageUrl","to":"image_url","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1},"seed":{"type":"number","default":1337},"image_url":{"type":"string","format":"uri"}},"required":["prompt","image_url"],"additionalProperties":false},"example":{"prompt":"Vast terracotta badlands, sculpted by wind and water over millennia.","image_url":"https://gen.krea.ai/images/0424f602-2999-4d0c-a46e-39cbf0ef384b.png"}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/generate/video/runway/aleph":{"post":{"tags":["Video"],"description":"Runway's Gen-4 Aleph model for advanced video-to-video transformation\n> **Deprecated request fields:**\n>\n> - `startImage` -> `start_image` until 2026-06-19\n> - `startVideo` -> `start_video` until 2026-06-19\n>\n> Deprecated fields are accepted for compatibility only and are not shown in the request schema.\n","summary":"Runway Aleph","x-krea-deprecated-field-aliases":[{"from":"startImage","to":"start_image","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"},{"from":"startVideo","to":"start_video","sunset_date":"2026-06-19","reason":"Public API request fields are moving to snake_case.","migration_url":"https://docs.krea.ai/developers/deprecations#public-api-snake-case-fields"}],"parameters":[{"name":"X-Webhook-URL","in":"header","required":false,"schema":{"type":"string","format":"uri"},"description":"URL to receive a POST request when the job completes. The webhook will receive the job data including results."}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":1000},"start_image":{"type":["string","null"],"format":"uri"},"start_video":{"type":["string","null"],"format":"uri"},"init_video":{"type":"string","format":"uri"},"init_image_url":{"type":"string","format":"uri"},"references":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"image"},"uri":{"type":"string","format":"uri"}},"required":["type","uri"]},"maxItems":1},"ratio":{"type":"string","enum":["1280:720","720:1280","1104:832","960:960","832:1104","1584:672","848:480","640:480"],"default":"1280:720"},"seed":{"type":"number","minimum":0,"maximum":4294967295}},"required":["prompt","init_video"],"additionalProperties":false},"example":{"prompt":"A coastal town where cobblestone streets mimic ocean waves.","init_video":"https://gen.krea.ai/images/0424f602-2999-4d0c-a46e-39cbf0ef384b.png"}}}},"responses":{"200":{"description":"The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["backlogged","queued","scheduled","processing","sampling","intermediate-complete","completed","failed","cancelled"]},"created_at":{"type":"string","format":"date-time"},"completed_at":{"type":"null"},"result":{"type":"null"}},"required":["job_id","status","created_at","completed_at","result"]}}}},"400":{"description":"The request body is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"You are not authenticated.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"402":{"description":"You have run out of credits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"You have reached the maximum number of concurrent jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","bearerFormat":"Bearer","type":"http"}}}}