{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Codzen API","description":"Generate video and images with every Codzen model through one asynchronous API.","colors":{"primary":"#F2541B","light":"#F2541B","dark":"#F2541B"},"logo":{"light":"https://mintcdn.com/codzen/AesJFc5DenfzYYMK/logo/light.png?fit=max\u0026auto=format\u0026n=AesJFc5DenfzYYMK\u0026q=85\u0026s=b3066730127fcdcdc4776e6a11061cff","dark":"https://mintcdn.com/codzen/AesJFc5DenfzYYMK/logo/dark.png?fit=max\u0026auto=format\u0026n=AesJFc5DenfzYYMK\u0026q=85\u0026s=545709dced5893e41aab7890c6f0b410","href":"https://codzen.ai"},"favicon":"https://mintcdn.com/codzen/AesJFc5DenfzYYMK/favicon.svg?fit=max\u0026auto=format\u0026n=AesJFc5DenfzYYMK\u0026q=85\u0026s=f41c9c6d24e9ad9a66fe305ae7cd90b0","api":{"playground":{"display":"simple"},"examples":{"languages":["curl","javascript","python"]}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"codzen","hasAudioNarration":false,"actualSubdomain":"codzen","customDomains":["docs.codzen.ai"],"gitSource":{"type":"github","owner":"codzen-ai","repo":"multimodal-gateway","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":"","_id":"6adf4ab7362b83303f21cbe1"},"chroma":{"latestBuiltDeploymentHistoryId":"6ac7588094d102775f8f89bd","collectionId":"756659ef-85c7-4c42-ab69-2340b6765817","liveDeploymentHistoryId":"6ac7588094d102775f8f89bd","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adf4ab7362b83303f21cbe7","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-a-generation","slug":"/api-reference/get-a-generation","pageMetadata":{"title":"Get a generation","description":"The generation's current state. A generation of another account is not found.","deprecated":null,"version":null,"openapi":"/openapi.json get /generations/{id}","href":"/api-reference/get-a-generation","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The generation’s current state. A generation of another account is not found.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a generation","description":"The generation's current state. A generation of another account is not found.","deprecated":null,"version":null,"openapi":"/openapi.json get /generations/{id}","href":"/api-reference/get-a-generation","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getGeneration","summary":"Get a generation","description":"The generation's current state. A generation of another account is not found.","parameters":["1be77c7f-9efa-4488-a72d-cd866a9db31b"],"responses":{"200":"e22a24cb-b864-4e62-ba85-6f7827880aad","401":"95ab633c-e3a2-4f2a-918e-c075ff44fb0b","403":"6f9432b3-c89a-47f6-b49c-69005ee81e70","404":"11193c87-1024-484d-9c1a-a69ae1d1adbc","429":"d1abb24b-4de2-4ec4-9057-9638317894ce","500":"fb551f23-fb91-457f-a868-fc559429cba4"},"method":"get","type":"path","servers":["2aa32099-f431-40c3-b7ab-3081a580a287"],"security":["6ff55638-f4e6-4879-91e0-fb0f2d4334f6"],"path":"/generations/{id}","baseUrlOptions":["https://codzen.ai/api/v1"],"title":"Get a generation","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1be77c7f-9efa-4488-a72d-cd866a9db31b":{"name":"id","in":"path","required":true,"description":"ID of the generation.","schema":{"type":"string","pattern":"^gen_","isRequired":true,"description":"ID of the generation.","uniqueKey":"","typeLabel":"string"}}},"responses":{"e22a24cb-b864-4e62-ba85-6f7827880aad":{"description":"The generation.","headers":{"x-request-id":{"description":"ID of the request; quote it when contacting support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^gen_","description":"ID of the generation.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"model":{"type":"string","description":"Slug of the model, as submitted.","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"status":{"type":"string","enum":["queued","processing","succeeded","failed"],"description":"`queued` → `processing` → `succeeded` or `failed`. New values may be added; treat an unknown value as not finished.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"input.additionalProperties","typeLabel":"any"},"description":"The input, normalized: input assets point at Codzen copies; other fields are as submitted.","isRequired":true,"uniqueKey":"input","typeLabel":"object"},"outputs":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["video","image","audio","3d"],"description":"Kind of media.","isRequired":true,"uniqueKey":"outputs.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","description":"Where to download the output; no API key is needed.","isRequired":true,"uniqueKey":"outputs.items.[INDEX].url","typeLabel":"string\u003curi>"}},"required":["type","url"],"additionalProperties":false,"description":"One delivered output.","uniqueKey":"outputs.items.[INDEX]","typeLabel":"object"},"description":"Delivered outputs; empty until the generation succeeds.","isRequired":true,"uniqueKey":"outputs","typeLabel":"object[]"},"cost":{"type":"object","properties":{"currency":{"type":"string","const":"USD","isRequired":true,"uniqueKey":"cost.currency","typeLabel":"string"},"estimated":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$","description":"The estimate, held from the balance at submission.","isRequired":true,"uniqueKey":"cost.estimated","typeLabel":"string"},"amount":{"oneOf":[{"type":"string","description":"The final cost: `null` until the generation finishes, `\"0.00\"` when it fails.","pattern":"^-?\\d+(\\.\\d+)?$","isRequired":true,"uniqueKey":"cost.amount.oneOf.0","typeLabel":"string"},{"type":"null","description":"The final cost: `null` until the generation finishes, `\"0.00\"` when it fails.","isRequired":true,"uniqueKey":"cost.amount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"cost.amount","typeLabel":"string | null"},"usage":{"type":"array","items":{"type":"object","properties":{"unit":{"type":"string","description":"Billing unit, as the model is priced, such as `output_second` or `million_tokens`.","isRequired":true,"uniqueKey":"cost.usage.items.[INDEX].unit","typeLabel":"string"},"quantity":{"type":"number","minimum":0,"description":"Billed quantity of the unit.","isRequired":true,"uniqueKey":"cost.usage.items.[INDEX].quantity","typeLabel":"number"},"unit_price":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$","description":"Price of one unit, in USD.","isRequired":true,"uniqueKey":"cost.usage.items.[INDEX].unit_price","typeLabel":"string"}},"required":["unit","quantity","unit_price"],"additionalProperties":false,"description":"One price row the generation was billed by.","uniqueKey":"cost.usage.items.[INDEX]","typeLabel":"object"},"description":"What the final cost was computed from; empty until known.","isRequired":true,"uniqueKey":"cost.usage","typeLabel":"object[]"}},"required":["currency","estimated","amount","usage"],"additionalProperties":false,"description":"What the generation costs.","isRequired":true,"uniqueKey":"cost","typeLabel":"object"},"error":{"oneOf":[{"type":"object","description":"Why the generation failed; `null` unless it failed.","required":["type","code","message","retryable"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","rate_limit_error","upstream_error","api_error"],"description":"Broad category of the error.","isRequired":true,"uniqueKey":"error.oneOf.0.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_request","content_rejected","invalid_api_key","insufficient_balance","api_key_disabled","account_suspended","model_not_found","generation_not_found","rate_limited","concurrency_limit","model_unavailable","upstream_failed","timeout","internal_error"],"description":"Stable error code; branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation; it may change at any time.","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether sending the same request again may succeed.","isRequired":true,"uniqueKey":"error.oneOf.0.retryable","typeLabel":"boolean"},"param":{"description":"The request field the error is about, such as `input.seed`.","type":"string","uniqueKey":"error.oneOf.0.param","typeLabel":"string"},"stage":{"description":"For `content_rejected`: whether the input or the output was rejected.","type":"string","enum":["input","output"],"uniqueKey":"error.oneOf.0.stage","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","description":"Why the generation failed; `null` unless it failed.","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"ISO 8601 time in UTC.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"started_at":{"oneOf":[{"type":"string","description":"When processing started; `null` while queued.","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","isRequired":true,"uniqueKey":"started_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"When processing started; `null` while queued.","isRequired":true,"uniqueKey":"started_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"started_at","typeLabel":"string\u003cdate-time> | null"},"completed_at":{"oneOf":[{"type":"string","description":"When the generation finished; `null` until then.","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","isRequired":true,"uniqueKey":"completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"When the generation finished; `null` until then.","isRequired":true,"uniqueKey":"completed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"completed_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","model","status","input","outputs","cost","error","created_at","started_at","completed_at"],"additionalProperties":false,"description":"One generation: a request to a model and its outputs.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","model":"\u003cstring>","status":"queued","input":{},"outputs":[{"type":"video","url":"\u003cstring>"}],"cost":{"currency":"USD","estimated":"\u003cstring>","amount":"\u003cstring>","usage":[{"unit":"\u003cstring>","quantity":1,"unit_price":"\u003cstring>"}]},"error":{"type":"invalid_request_error","code":"invalid_request","message":"\u003cstring>","retryable":true,"param":"\u003cstring>","stage":"input"},"created_at":"2023-11-07T05:31:56Z","started_at":"2023-11-07T05:31:56Z","completed_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"95ab633c-e3a2-4f2a-918e-c075ff44fb0b":{"description":"The API key is missing or invalid (`authentication_error`).","headers":{"x-request-id":{"description":"ID of the request; quote it when contacting support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","rate_limit_error","upstream_error","api_error"],"description":"Broad category of the error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_request","content_rejected","invalid_api_key","insufficient_balance","api_key_disabled","account_suspended","model_not_found","generation_not_found","rate_limited","concurrency_limit","model_unavailable","upstream_failed","timeout","internal_error"],"description":"Stable error code; branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation; it may change at any time.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether sending the same request again may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"param":{"description":"The request field the error is about, such as `input.seed`.","type":"string","uniqueKey":"error.param","typeLabel":"string"},"stage":{"description":"For `content_rejected`: whether the input or the output was rejected.","type":"string","enum":["input","output"],"uniqueKey":"error.stage","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","retryable"],"additionalProperties":false,"description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"ID of the request, also in the `x-request-id` header.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"description":"Body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"invalid_request","message":"\u003cstring>","retryable":true,"param":"\u003cstring>","stage":"input"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"6f9432b3-c89a-47f6-b49c-69005ee81e70":{"description":"The API key is disabled or the account is suspended (`permission_error`).","headers":{"x-request-id":{"description":"ID of the request; quote it when contacting support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","rate_limit_error","upstream_error","api_error"],"description":"Broad category of the error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_request","content_rejected","invalid_api_key","insufficient_balance","api_key_disabled","account_suspended","model_not_found","generation_not_found","rate_limited","concurrency_limit","model_unavailable","upstream_failed","timeout","internal_error"],"description":"Stable error code; branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation; it may change at any time.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether sending the same request again may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"param":{"description":"The request field the error is about, such as `input.seed`.","type":"string","uniqueKey":"error.param","typeLabel":"string"},"stage":{"description":"For `content_rejected`: whether the input or the output was rejected.","type":"string","enum":["input","output"],"uniqueKey":"error.stage","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","retryable"],"additionalProperties":false,"description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"ID of the request, also in the `x-request-id` header.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"description":"Body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"invalid_request","message":"\u003cstring>","retryable":true,"param":"\u003cstring>","stage":"input"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"11193c87-1024-484d-9c1a-a69ae1d1adbc":{"description":"The model or generation does not exist, or belongs to another account (`not_found_error`).","headers":{"x-request-id":{"description":"ID of the request; quote it when contacting support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","rate_limit_error","upstream_error","api_error"],"description":"Broad category of the error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_request","content_rejected","invalid_api_key","insufficient_balance","api_key_disabled","account_suspended","model_not_found","generation_not_found","rate_limited","concurrency_limit","model_unavailable","upstream_failed","timeout","internal_error"],"description":"Stable error code; branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation; it may change at any time.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether sending the same request again may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"param":{"description":"The request field the error is about, such as `input.seed`.","type":"string","uniqueKey":"error.param","typeLabel":"string"},"stage":{"description":"For `content_rejected`: whether the input or the output was rejected.","type":"string","enum":["input","output"],"uniqueKey":"error.stage","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","retryable"],"additionalProperties":false,"description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"ID of the request, also in the `x-request-id` header.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"description":"Body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"invalid_request","message":"\u003cstring>","retryable":true,"param":"\u003cstring>","stage":"input"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d1abb24b-4de2-4ec4-9057-9638317894ce":{"description":"Too many requests or concurrent generations (`rate_limit_error`). Retry after the `Retry-After` header.","headers":{"x-request-id":{"description":"ID of the request; quote it when contacting support.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","rate_limit_error","upstream_error","api_error"],"description":"Broad category of the error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_request","content_rejected","invalid_api_key","insufficient_balance","api_key_disabled","account_suspended","model_not_found","generation_not_found","rate_limited","concurrency_limit","model_unavailable","upstream_failed","timeout","internal_error"],"description":"Stable error code; branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation; it may change at any time.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether sending the same request again may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"param":{"description":"The request field the error is about, such as `input.seed`.","type":"string","uniqueKey":"error.param","typeLabel":"string"},"stage":{"description":"For `content_rejected`: whether the input or the output was rejected.","type":"string","enum":["input","output"],"uniqueKey":"error.stage","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","retryable"],"additionalProperties":false,"description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"ID of the request, also in the `x-request-id` header.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"description":"Body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"invalid_request","message":"\u003cstring>","retryable":true,"param":"\u003cstring>","stage":"input"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"fb551f23-fb91-457f-a868-fc559429cba4":{"description":"Something went wrong on our side (`api_error`). Retry later.","headers":{"x-request-id":{"description":"ID of the request; quote it when contacting support.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","billing_error","permission_error","not_found_error","rate_limit_error","upstream_error","api_error"],"description":"Broad category of the error.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_request","content_rejected","invalid_api_key","insufficient_balance","api_key_disabled","account_suspended","model_not_found","generation_not_found","rate_limited","concurrency_limit","model_unavailable","upstream_failed","timeout","internal_error"],"description":"Stable error code; branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation; it may change at any time.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryable":{"type":"boolean","description":"Whether sending the same request again may succeed.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"param":{"description":"The request field the error is about, such as `input.seed`.","type":"string","uniqueKey":"error.param","typeLabel":"string"},"stage":{"description":"For `content_rejected`: whether the input or the output was rejected.","type":"string","enum":["input","output"],"uniqueKey":"error.stage","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","retryable"],"additionalProperties":false,"description":"What went wrong.","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"request_id":{"type":"string","description":"ID of the request, also in the `x-request-id` header.","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"}},"required":["error","request_id"],"additionalProperties":false,"description":"Body of every error response.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","code":"invalid_request","message":"\u003cstring>","retryable":true,"param":"\u003cstring>","stage":"input"},"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6ff55638-f4e6-4879-91e0-fb0f2d4334f6":{"apiKey":{"type":"http","scheme":"bearer","description":"Your API key (`cz_…`), created in the console. Use it only on your server.","scopes":[],"schemeName":"apiKey"}}},"servers":{"2aa32099-f431-40c3-b7ab-3081a580a287":{"url":"https://codzen.ai/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your API key (`cz_…`), created in the console. Use it only on your server.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your API key (`cz_…`), created in the console. Use it only on your server.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"codzen","siteName":"Codzen API","title":"Get a generation - Codzen API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T12:42:35.575Z","originalFileLocation":"api-reference/get-a-generation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The generation\u0026#x27;s current state. A generation of another account is not found.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Codzen API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a generation - Codzen API\">\u003cmeta data-mint-head property=\"og:description\" content=\"The generation\u0026#x27;s current state. A generation of another account is not found.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Codzen API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.codzen.ai/api-reference/get-a-generation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://codzen.mintlify.app/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+a+generation\u0026amp;description=The+generation%27s+current+state.+A+generation+of+another+account+is+not+found.\u0026amp;theme=e284728bad8fe7cd7f57d6c9\u0026amp;signature=395ba23eded7e79832ce9a52e5a70bf4b65cebef559655afcbbaca96b42c78f8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a generation - Codzen API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The generation\u0026#x27;s current state. A generation of another account is not found.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://codzen.mintlify.app/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Get+a+generation\u0026amp;description=The+generation%27s+current+state.+A+generation+of+another+account+is+not+found.\u0026amp;theme=e284728bad8fe7cd7f57d6c9\u0026amp;signature=395ba23eded7e79832ce9a52e5a70bf4b65cebef559655afcbbaca96b42c78f8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/codzen/qXEmLmO-OuhPxDFN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Codzen API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F2541B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.codzen.ai/api-reference/get-a-generation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-a-generation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.codzen.ai/#organization\",\"name\":\"Codzen API\",\"url\":\"https://docs.codzen.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/codzen/AesJFc5DenfzYYMK/logo/light.png?fit=max\u0026auto=format\u0026n=AesJFc5DenfzYYMK\u0026q=85\u0026s=b3066730127fcdcdc4776e6a11061cff\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.codzen.ai#website\",\"name\":\"Codzen API\",\"url\":\"https://docs.codzen.ai\",\"publisher\":{\"@id\":\"https://docs.codzen.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.codzen.ai/api-reference/get-a-generation#webpage\",\"url\":\"https://docs.codzen.ai/api-reference/get-a-generation\",\"name\":\"Get a generation\",\"description\":\"The generation's current state. A generation of another account is not found.\",\"dateModified\":\"2026-10-26T12:42:35.575Z\",\"isPartOf\":{\"@id\":\"https://docs.codzen.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.codzen.ai/api-reference/get-a-generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.codzen.ai/api-reference/get-a-generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.codzen.ai/api-reference/create-a-generation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a generation\",\"item\":\"https://docs.codzen.ai/api-reference/get-a-generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.codzen.ai/api-reference/get-a-generation#apireference\",\"headline\":\"Get a generation\",\"name\":\"Get a generation\",\"description\":\"The generation's current state. A generation of another account is not found.\",\"url\":\"https://docs.codzen.ai/api-reference/get-a-generation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.codzen.ai/api-reference/get-a-generation#webpage\"},\"dateModified\":\"2026-10-26T12:42:35.575Z\",\"publisher\":{\"@id\":\"https://docs.codzen.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.codzen.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Codzen API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Codzen API","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"Quickstart","href":"/quickstart"}]},{"group":"Guides","pages":[{"title":"Authentication and rate limits","href":"/guides/authentication"},{"title":"Generation lifecycle","href":"/guides/generation-lifecycle"},{"title":"Webhooks and signatures","href":"/guides/webhooks"},{"title":"Errors","href":"/guides/errors"},{"title":"Billing","href":"/guides/billing"}]},{"group":"API reference","pages":[{"title":"Create a generation","description":"Submits a generation and returns it, `queued`. Poll `GET /generations/{id}` or pass `webhook_url` to learn when it finishes. The estimate is held from your balance until then.","deprecated":null,"version":null,"openapi":"/openapi.json post /generations","href":"/api-reference/create-a-generation"},{"title":"Get a generation","deprecated":null,"version":null,"openapi":"/openapi.json get /generations/{id}","href":"/api-reference/get-a-generation"},{"title":"List generations","description":"Your generations, newest first, one page at a time. While `has_more` is true, pass the last `id` of a page as `after` to get the next one.","deprecated":null,"version":null,"openapi":"/openapi.json get /generations","href":"/api-reference/list-generations"},{"title":"List models","deprecated":null,"version":null,"openapi":"/openapi.json get /models","href":"/api-reference/list-models"},{"title":"Get the balance","deprecated":null,"version":null,"openapi":"/openapi.json get /balance","href":"/api-reference/get-the-balance"},{"title":"Generation completed","version":null,"deprecated":null,"openapi":"/openapi.json webhook generation.completed","href":"/api-reference/generation-completed"}]},{"group":"Models","pages":[{"title":"Models","href":"/models"}]}]},"title":"Get a generation - Codzen API","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}