{"openapi":"3.1.0","info":{"title":"MyType.video user API","version":"v1","description":"API and website share one wallet and account queue. Retry an ambiguous submission with the identical requestId and body: accepted requests return the original job; changed intent returns 409. Request identities are retained with generation records, with no shorter deduplication expiry. Results are available while retained by the account/service; no fixed minimum retention duration is guaranteed. Media capabilities include expiresAt and must be refreshed. Permissions and bans are rechecked on access. Customer upload budgets are shared between website and token access. Capabilities adds optional uploads limits. Rate-limited responses include Retry-After; coarse edge limits are approximate. Storage budgets cover uploaded images, not generated output media. Customer image quotas use binary MiB. Normal-user sharing is disabled. Retained videos have no automatic expiry under this policy; eligible extracted frames expire after seven days."},"servers":[{"url":"https://api.mytype.video/v1"},{"url":"/api/v1","description":"Previous address. Still served for now; move to https://api.mytype.video/v1."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Personal pvk_ token. Manage tokens through website sign-in."}},"schemas":{"FrameToFrameIntent":{"type":"object","additionalProperties":false,"required":["requestId","firstFrameAssetVersionId","lastFrameAssetVersionId","duration","seed"],"properties":{"requestId":{"type":"string","format":"uuid"},"firstFrameAssetVersionId":{"type":"string","description":"Owned image asset version for the opening frame."},"lastFrameAssetVersionId":{"type":"string","description":"Owned image asset version for the final frame. Reuse the opening image for idle motion."},"duration":{"type":"integer","enum":[3,5,7],"description":"Clip length in seconds. Output is 736 × 1280 (720p). 1 and 10 seconds are no longer offered."},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"motionPrompt":{"type":"string","maxLength":2000,"description":"Optional motion direction between the frames."},"audio":{"type":"string","maxLength":2000,"description":"Optional soundscape direction. Blank uses natural ambient sound and no dialogue."}}},"DirectGenerationIntent":{"oneOf":[{"type":"object","additionalProperties":false,"required":["mode","requestId","duration","seed","prompt","contentRating","style","firstFrameAssetVersionId"],"properties":{"mode":{"const":"fl2va"},"requestId":{"type":"string","format":"uuid"},"duration":{"type":"integer","enum":[3,5,7]},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"prompt":{"type":"string","minLength":1,"maxLength":12000,"pattern":"\\S","description":"Full prompt passed through as written. The renderer also enforces a 2,048-token limit."},"contentRating":{"type":"string","enum":["sfw","nsfw"],"description":"NSFW inputs require NSFW output."},"style":{"type":"string","description":"Rendering style. Use realism (photographic) or anime; these are the values the catalog and examples use. Other text up to 64 characters is accepted and stored with the job, but no other style is supported.","minLength":1,"maxLength":64,"pattern":"\\S"},"adultSubjectsVerified":{"type":"boolean","default":false,"description":"Required true for NSFW. Confirms fictional or consenting verified-adult subjects."},"firstFrameAssetVersionId":{"type":"string","description":"Owned image asset version for the opening frame."},"lastFrameAssetVersionId":{"type":"string","description":"Owned image asset version for the final frame. Reuse the opening image for idle motion."},"referenceAssetVersionId":{"type":"string","description":"Owned visual reference for 3-, 5- or 7-second FL2VA. Address it as <Picture 2> without a last frame, or <Picture 3> with a last frame."},"referenceAssetVersionIds":{"type":"array","maxItems":2,"items":{"type":"string"},"description":"Ordered owned or eligible admin-published references for 3-, 5- or 7-second FL2VA without a last frame. Address these as <Picture 2> and <Picture 3>."},"resolution":{"type":"string","enum":["736p"],"default":"736p","description":"Portrait video resolution. Direct video is 736p (736 × 1280) only; omit the field or set it to 736p. 544p is no longer offered."}},"allOf":[{"if":{"required":["referenceAssetVersionId"]},"then":{"properties":{"duration":{"enum":[3,5,7]}}}},{"if":{"required":["referenceAssetVersionIds"]},"then":{"not":{"anyOf":[{"required":["lastFrameAssetVersionId"]},{"required":["referenceAssetVersionId"]}]}}},{"if":{"required":["referenceAssetVersionIds"],"properties":{"referenceAssetVersionIds":{"minItems":1}}},"then":{"properties":{"duration":{"enum":[3,5,7]}}}}],"if":{"properties":{"contentRating":{"const":"nsfw"}}},"then":{"required":["adultSubjectsVerified"],"properties":{"adultSubjectsVerified":{"const":true}}}},{"type":"object","additionalProperties":false,"required":["mode","requestId","duration","seed","prompt","contentRating","style","referenceAssetVersionIds","motion"],"properties":{"mode":{"const":"ref2va"},"requestId":{"type":"string","format":"uuid"},"duration":{"type":"integer","enum":[3,5,7]},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"prompt":{"type":"string","minLength":1,"maxLength":12000,"pattern":"\\S","description":"Full prompt passed through as written. The renderer also enforces a 2,048-token limit."},"contentRating":{"type":"string","enum":["sfw","nsfw"],"description":"NSFW inputs require NSFW output."},"style":{"type":"string","description":"Rendering style. Use realism (photographic) or anime; these are the values the catalog and examples use. Other text up to 64 characters is accepted and stored with the job, but no other style is supported.","minLength":1,"maxLength":64,"pattern":"\\S"},"adultSubjectsVerified":{"type":"boolean","default":false,"description":"Required true for NSFW. Confirms fictional or consenting verified-adult subjects."},"referenceAssetVersionIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":3,"description":"Owned image asset versions in Picture 1 through Picture 3 order."},"motion":{"type":"string","enum":["idle","transition"]},"resolution":{"type":"string","enum":["736p"],"default":"736p","description":"Portrait video resolution. Direct video is 736p (736 × 1280) only; omit the field or set it to 736p. 544p is no longer offered."}},"if":{"properties":{"contentRating":{"const":"nsfw"}}},"then":{"required":["adultSubjectsVerified"],"properties":{"adultSubjectsVerified":{"const":true}}}}]},"DirectImageGenerationIntent":{"type":"object","additionalProperties":false,"required":["requestId","prompt","seed","contentRating","style"],"properties":{"requestId":{"type":"string","format":"uuid"},"prompt":{"type":"string","minLength":1,"maxLength":12000,"pattern":"\\S","description":"Direct image prompt, passed to the image worker as written."},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"contentRating":{"type":"string","enum":["sfw","nsfw"],"description":"NSFW inputs require NSFW output."},"style":{"type":"string","description":"Rendering style. Use realism (photographic) or anime; these are the values the catalog and examples use. Other text up to 64 characters is accepted and stored with the job, but no other style is supported.","minLength":1,"maxLength":64,"pattern":"\\S"},"adultSubjectsVerified":{"type":"boolean","default":false,"description":"Required true for NSFW. Confirms fictional or consenting verified-adult subjects."},"referenceAssetVersionIds":{"type":"array","maxItems":3,"items":{"type":"string","pattern":"^av_[a-z0-9_-]+$"},"description":"Optional ordered list of owned or eligible admin-published image versions. Use an empty list or omit the field for prompt-only generation."}}},"GenerationIntent":{"type":"object","additionalProperties":false,"required":["requestId","poseId","poseRevision","characterAssetVersionId","duration","seed","motion","context"],"properties":{"requestId":{"type":"string","format":"uuid"},"poseId":{"type":"string"},"poseRevision":{"type":"string","format":"date-time"},"characterAssetVersionId":{"type":"string"},"secondaryAssetVersionId":{"type":"string"},"duration":{"type":"integer","enum":[3,5,7],"description":"Clip length in seconds. Output is 736 × 1280 (720p). 1 and 10 seconds are no longer offered."},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"motion":{"type":"string","enum":["idle","transition"]},"reuseAssetVersionId":{"type":"string"},"context":{"$ref":"#/components/schemas/Context"}}},"ExtensionIntent":{"type":"object","additionalProperties":false,"required":["mode","requestId","sourceFrameAssetVersionId","duration","seed","prompt","audio"],"properties":{"mode":{"const":"extend"},"requestId":{"type":"string","format":"uuid"},"sourceFrameAssetVersionId":{"type":"string"},"duration":{"type":"integer","enum":[3,5]},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"prompt":{"type":"string"},"audio":{"type":"string"}}},"TargetPoseExtensionIntent":{"type":"object","additionalProperties":false,"required":["mode","requestId","sourceFrameAssetVersionId","duration","seed","targetPoseId","targetPoseRevision"],"properties":{"mode":{"const":"extend"},"requestId":{"type":"string","format":"uuid"},"sourceFrameAssetVersionId":{"type":"string"},"duration":{"type":"integer","enum":[3,5]},"seed":{"type":"integer","minimum":0,"maximum":2147483647},"targetPoseId":{"type":"string"},"targetPoseRevision":{"type":"string","format":"date-time"},"transitionInstructions":{"type":"string","maxLength":2000,"description":"Optional user instructions for the route from the starting image to the selected text- or image-guided destination pose. Inserted during the transition; extraMotion applies after arrival."},"extraMotion":{"type":"string","maxLength":2000},"audio":{"type":"string","maxLength":2000}}},"Context":{"type":"object","additionalProperties":false,"required":["motion","audio","background","style","props","attireMode","attirePrompt"],"properties":{"motion":{"type":"string"},"audio":{"type":"string"},"background":{"type":"string"},"style":{"type":"string"},"props":{"type":"string"},"attireMode":{"type":"string","enum":["original","replace","add"]},"attirePrompt":{"type":["string","null"]},"secondaryAttire":{"type":"object","additionalProperties":false,"required":["mode","prompt"],"properties":{"mode":{"type":"string","enum":["original","replace","add"]},"prompt":{"type":["string","null"]}}}}},"SessionViewV1":{"type":"object","properties":{"userId":{"type":"string"},"displayName":{"type":"string"},"email":{"type":"string"},"role":{"enum":["user","admin"]},"isAdmin":{"type":"boolean"},"generationTransport":{"enum":["mock","piper"]}},"required":["userId","displayName","email","role","isAdmin","generationTransport"],"additionalProperties":true},"PointLedgerEntryV1":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"available_delta":{"type":"number"},"held_delta":{"type":"number"},"created_at":{"type":"string"},"jobId":{"type":["string","null"]},"source":{"type":["string","null"]},"pointKind":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"lots":{"type":"array","items":{"type":"object","properties":{"lotId":{"type":"string"},"source":{"type":"string"},"pointKind":{"enum":["purchased","bonus"]},"grantedAt":{"type":"string"},"expiresAt":{"type":["string","null"]},"amount":{"type":"number"}},"required":["lotId","source","pointKind","grantedAt","expiresAt","amount"],"additionalProperties":true}},"availableDeltaUsd":{"type":"number","description":"US dollars at the account's price, rounded to 1/10,000 of a dollar. Points stay the internal unit."},"heldDeltaUsd":{"type":"number","description":"US dollars at the account's price, rounded to 1/10,000 of a dollar. Points stay the internal unit."}},"required":["id","kind","available_delta","held_delta","created_at"],"additionalProperties":true},"WalletViewV1":{"type":"object","properties":{"balance":{"type":"object","properties":{"available":{"type":"number"},"held":{"type":"number"},"purchased":{"type":"number"},"bonus":{"type":"number"}},"required":["available","held"],"additionalProperties":true},"pointsPerSecond":{"type":"number"},"enabled":{"type":"boolean"},"ledger":{"type":"array","items":{"$ref":"#/components/schemas/PointLedgerEntryV1"}},"nextCursor":{"type":["string","null"]},"expiring":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"expiresAt":{"type":"string"}},"required":["amount","expiresAt"],"additionalProperties":true}},"pendingRewards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"amount":{"type":"number"},"availableAt":{"type":"string"}},"required":["id","amount","availableAt"],"additionalProperties":true}},"pricingVersion":{"type":"string"},"purchasesEnabled":{"type":"boolean"},"onboarding":{"type":"object","properties":{"firstVideoCompleted":{"type":"boolean"}},"required":["firstVideoCompleted"],"additionalProperties":true},"orders":{"type":"array","items":{"type":"object"}},"packs":{"type":"array","items":{"type":"object"}},"tasks":{"type":"array","items":{"type":"object"}},"batches":{"type":"array","items":{"type":"object"}},"balanceUsd":{"type":["object","null"],"description":"The balance in US dollars at the account's price (business accounts: 1 USDC = 1 US dollar of balance).","properties":{"available":{"type":"number","description":"US dollars at the account's price, rounded to 1/10,000 of a dollar. Points stay the internal unit."},"held":{"type":"number","description":"US dollars at the account's price, rounded to 1/10,000 of a dollar. Points stay the internal unit."},"currency":{"enum":["USD"]}},"required":["available","held","currency"],"additionalProperties":true},"balanceByType":{"type":"object","description":"Available balance by kind: prepaid and trial (business accounts), purchased and bonus (website). usd uses the account's price.","properties":{"prepaid":{"type":"object","properties":{"points":{"type":"number"},"usd":{"type":"number"}},"required":["points","usd"],"additionalProperties":true},"trial":{"type":"object","properties":{"points":{"type":"number"},"usd":{"type":"number"}},"required":["points","usd"],"additionalProperties":true},"purchased":{"type":"object","properties":{"points":{"type":"number"},"usd":{"type":"number"}},"required":["points","usd"],"additionalProperties":true},"bonus":{"type":"object","properties":{"points":{"type":"number"},"usd":{"type":"number"}},"required":["points","usd"],"additionalProperties":true}},"required":["prepaid","trial","purchased","bonus"],"additionalProperties":true},"balanceByPool":{"type":"object","description":"Separate balances of one account: business points (USDC top-ups and their volume tier, trial credit) pay only for API and MCP jobs; consumer points pay only for website jobs. Neither pays for the other.","properties":{"business":{"type":"object","description":"Business balance, used by API and MCP jobs; usd at the account's business price.","properties":{"points":{"type":"number"},"usd":{"type":"number"},"usedBy":{"type":"array","items":{"type":"string"}}},"required":["points","usd","usedBy"],"additionalProperties":true},"consumer":{"type":"object","description":"Consumer balance, used by website jobs; usd at the standard website price.","properties":{"points":{"type":"number"},"usd":{"type":"number"},"usedBy":{"type":"array","items":{"type":"string"}}},"required":["points","usd","usedBy"],"additionalProperties":true}},"required":["business","consumer"],"additionalProperties":true},"account":{"type":"object","description":"Account type and price. type is business for prepaid business accounts at their negotiated rate, standard otherwise. pointsPerUsd converts the point fields to US dollars.","properties":{"type":{"enum":["business","standard"]},"pointsPerUsd":{"type":"number"},"currency":{"enum":["USD"]}},"required":["type","pointsPerUsd","currency"],"additionalProperties":true}},"required":["balance","pointsPerSecond","enabled","ledger","nextCursor"],"additionalProperties":true},"AssetViewV1":{"type":"object","properties":{"assetVersionId":{"type":"string"},"assetId":{"type":"string"},"title":{"type":["string","null"]},"assetType":{"enum":["image","video"]},"visibility":{"enum":["private","shared"]},"owned":{"type":"boolean"},"origin":{"description":"How the asset was created or added.","enum":["admin_upload","user_upload","video_frame","generated","imported"]},"canChangeVisibility":{"type":"boolean"},"contentRating":{"enum":["sfw","nsfw"]},"style":{"type":"string"},"preview":{"type":"object","properties":{"url":{"type":"string"},"expiresAt":{"type":["string","null"]}},"required":["url","expiresAt"],"additionalProperties":true},"downloadUrl":{"type":"string"},"posterUrl":{"type":["string","null"]},"width":{"type":["number","null"]},"height":{"type":["number","null"]},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"bytes":{"type":"integer"},"contentType":{"type":"string"},"sha256":{"type":"string"},"createdAt":{"type":"string"},"adminBan":{"type":"boolean"},"publiclyVisible":{"type":"boolean"},"generation":{"anyOf":[{"$ref":"#/components/schemas/GenerationItemViewV1"},{"type":"null"}]}},"required":["assetVersionId","assetId","title","assetType","visibility","owned","canChangeVisibility","contentRating","style","preview","downloadUrl","posterUrl","width","height"],"additionalProperties":true},"JobProgressV1":{"type":"object","properties":{"errorCode":{"type":"string","enum":["VIDEO_CONTENT_REJECTED","IMAGE_CONTENT_REJECTED"],"description":"The generated result failed the media content check. Result URLs are withheld and the reserved points are charged."},"phase":{"type":"string","description":"pending_dispatch while the accepted job waits to be handed to a GPU; after that the same value as the job status."},"percent":{"type":"number"},"inferenceStartedAt":{"type":["integer","null"],"description":"UTC ms when the GPU started. When the GPU agent reports none, the time of the first running callback (a few seconds early: it includes model loading)."},"revision":{"type":"integer"},"serverTime":{"type":"integer"}},"required":[],"additionalProperties":true},"JobViewV1":{"type":"object","properties":{"source":{"type":"object","description":"Where the job was submitted: on the website, with an API token, or through the MCP server with an API token. Jobs from before 2026-11-21 that used a token show kind api.","required":["kind","keyId"],"properties":{"kind":{"enum":["website","api","mcp"]},"keyId":{"type":["string","null"]}}},"jobId":{"type":"string"},"status":{"type":"string","description":"Job state. queued: accepted, waiting for a GPU. preparing: a GPU took the job and is loading inputs. running: generating. uploading: the result is being stored; keep polling. uncertain: the outcome is not confirmed yet and is being reconciled; keep polling. Terminal states: completed (outputs ready, reserved points charged), failed (reserved points released, unless progress.errorCode reports a content rejection) and cancelled (reserved points released). A terminal state does not change."},"progress":{"$ref":"#/components/schemas/JobProgressV1"},"items":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string"},"jobId":{"type":"string"},"status":{"type":"string","description":"State of this item, with the same values as the job status: queued, preparing, running, uploading, uncertain, completed, failed or cancelled."},"mode":{"type":"string"},"motion":{"type":"string"},"style":{"type":"string"},"duration":{"type":"number"},"seed":{"type":"number"},"fps":{"type":"number"},"frameCount":{"type":"number"},"contentRating":{"enum":["sfw","nsfw"]},"simulation":{"type":"boolean"},"reusable":{"type":"boolean"},"canChangeVisibility":{"type":"boolean"},"assetVersionId":{"type":["string","null"]},"visibility":{"type":["string","null"]},"adminBan":{"type":"boolean"},"publiclyVisible":{"type":"boolean"},"posterUrl":{"type":["string","null"]},"downloadUrl":{"description":"Signed link to the full-size result. It expires (see downloadExpiresAt); read the job again for a fresh link. Null until the item is completed.","type":["string","null"]},"downloadExpiresAt":{"description":"UTC ISO 8601 time when downloadUrl stops working: 5 minutes after this response for token (API) access. Null when there is no downloadUrl or the link does not expire.","type":["string","null"]},"context":{"$ref":"#/components/schemas/PublicContextViewV1"},"poseContext":{"anyOf":[{"type":"object","properties":{"poseId":{"type":"string"},"title":{"type":"string"},"displayName":{"type":"string"}},"required":["poseId","title","displayName"],"additionalProperties":true},{"type":"null"}]},"inputs":{"type":"array","items":{"type":"object","properties":{"assetVersionId":{"type":"string"},"title":{"type":["string","null"]},"role":{"type":"string"},"position":{"type":"integer"}},"required":["assetVersionId","title","role","position"],"additionalProperties":true}}},"required":["runId","mode","duration","seed","motion","contentRating","style","context","poseContext","inputs","reusable"],"additionalProperties":true}},"simulation":{"type":"boolean"},"queue":{"$ref":"#/components/schemas/JobQueueV1"}},"required":["jobId","status","progress"],"additionalProperties":true},"QueueViewV1":{"type":"object","properties":{"queued":{"type":"integer"},"executing":{"type":"integer"},"executionSlots":{"type":"integer"},"limits":{"type":"object","properties":{"queued":{"type":["integer","null"]},"executing":{"type":"integer"}},"required":["queued","executing"],"additionalProperties":true},"acceptingNewJobs":{"type":"boolean"}},"required":["queued","executing","executionSlots","limits","acceptingNewJobs"],"additionalProperties":true},"UserInputSlotViewV1":{"type":"object","properties":{"slot":{"type":"string"},"role":{"enum":["identity","attire","start_frame","end_frame"]},"required":{"type":"boolean"},"position":{"type":"integer"}},"required":["slot","role","required","position"],"additionalProperties":true},"PublicContextViewV1":{"type":"object","properties":{"motion":{"type":"string"},"audio":{"type":"string"},"background":{"type":"string"},"style":{"type":"string"},"props":{"type":"string"},"attireMode":{"enum":["original","replace","add"]},"attirePrompt":{"type":["string","null"]},"secondaryAttire":{"type":"object","properties":{"mode":{"enum":["original","replace","add"]},"prompt":{"type":["string","null"]}},"required":["mode","prompt"],"additionalProperties":true}},"required":[],"additionalProperties":true},"PublicPoseViewV1":{"type":"object","properties":{"poseId":{"type":"string"},"title":{"type":"string"},"displayName":{"type":"string"},"description":{"type":"string"},"primaryCategory":{"type":"string"},"revision":{"type":"string"},"contentLevel":{"type":"string"},"participantCount":{"type":"string"},"templateKind":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"postures":{"type":"array","items":{"type":"string"}},"cameraFacets":{"type":"array","items":{"type":"string"}},"framings":{"type":"array","items":{"type":"string"}},"bodyFocus":{"type":"array","items":{"type":"string"}},"contentRating":{"enum":["sfw","nsfw"]},"guidanceMode":{"enum":["text","image"]},"generationMode":{"enum":["ref2va","fl2va"]},"motionInputMode":{"enum":["replace"]},"inputSlots":{"type":"array","items":{"$ref":"#/components/schemas/UserInputSlotViewV1"}},"status":{"enum":["ready"]},"visibility":{"enum":["shared"]},"adminPick":{"type":"boolean"},"completedVideoCount":{"type":"integer"},"creativeDefaults":{"type":"object","properties":{"motion":{"type":"string"},"audio":{"type":"string"}},"required":["motion","audio"],"additionalProperties":true},"featuredOutput":{"anyOf":[{"$ref":"#/components/schemas/AssetViewV1"},{"type":"null"}]},"previewReferences":{"type":"array","items":{"type":"object","properties":{"position":{"type":"integer"},"role":{"enum":["identity","attire","start_frame","end_frame"]},"asset":{"$ref":"#/components/schemas/AssetViewV1"}},"required":["position","role","asset"],"additionalProperties":true}}},"required":["poseId","title","displayName","description","primaryCategory","revision","tags","contentRating","guidanceMode","generationMode","motionInputMode","inputSlots","status","visibility","adminPick","completedVideoCount","creativeDefaults","featuredOutput","previewReferences"],"additionalProperties":true},"PoseListViewV1":{"type":"object","properties":{"poses":{"type":"array","items":{"$ref":"#/components/schemas/PublicPoseViewV1"}},"nextCursor":{"type":["string","null"]}},"required":["poses"],"additionalProperties":true},"AssetListViewV1":{"type":"object","properties":{"assets":{"type":"array","items":{"$ref":"#/components/schemas/AssetViewV1"}},"nextCursor":{"type":["string","null"]}},"required":["assets","nextCursor"],"additionalProperties":true},"GenerationItemViewV1":{"type":"object","properties":{"runId":{"type":"string"},"jobId":{"type":"string"},"status":{"type":"string"},"mode":{"type":"string"},"motion":{"type":"string"},"style":{"type":"string"},"duration":{"type":"number"},"seed":{"type":"number"},"fps":{"type":"number"},"frameCount":{"type":"number"},"contentRating":{"enum":["sfw","nsfw"]},"simulation":{"type":"boolean"},"reusable":{"type":"boolean"},"canChangeVisibility":{"type":"boolean"},"assetVersionId":{"type":["string","null"]},"visibility":{"type":["string","null"]},"adminBan":{"type":"boolean"},"publiclyVisible":{"type":"boolean"},"posterUrl":{"type":["string","null"]},"downloadUrl":{"type":["string","null"]},"context":{"$ref":"#/components/schemas/PublicContextViewV1"},"poseContext":{"anyOf":[{"type":"object","properties":{"poseId":{"type":"string"},"title":{"type":"string"},"displayName":{"type":"string"}},"required":["poseId","title","displayName"],"additionalProperties":true},{"type":"null"}]},"inputs":{"type":"array","items":{"type":"object","properties":{"assetVersionId":{"type":"string"},"title":{"type":["string","null"]},"role":{"type":"string"},"position":{"type":"integer"}},"required":["assetVersionId","title","role","position"],"additionalProperties":true}}},"required":["runId","mode","duration","seed","motion","contentRating","style","context","poseContext","inputs","reusable"],"additionalProperties":true},"GenerationSummaryViewV1":{"type":"object","properties":{"source":{"type":"object","description":"Where the job was submitted: on the website, with an API token, or through the MCP server with an API token. Jobs from before 2026-11-21 that used a token show kind api.","required":["kind","keyId"],"properties":{"kind":{"enum":["website","api","mcp"]},"keyId":{"type":["string","null"]}}},"jobId":{"type":"string"},"status":{"type":"string"},"progress":{"$ref":"#/components/schemas/JobProgressV1"},"createdAt":{"type":"string"},"title":{"type":["string","null"]},"visibility":{"type":["string","null"]},"poseEntryId":{"type":["string","null"]},"queue":{"$ref":"#/components/schemas/JobQueueV1"}},"required":["jobId","status","progress","createdAt","title","visibility","poseEntryId"],"additionalProperties":true},"GenerationListViewV1":{"type":"object","properties":{"generations":{"type":"array","items":{"$ref":"#/components/schemas/GenerationSummaryViewV1"}},"nextCursor":{"type":["string","null"]}},"required":["generations","nextCursor"],"additionalProperties":true},"GenerationAcceptedViewV1":{"type":"object","properties":{"jobId":{"type":"string"},"status":{"enum":["accepted"]},"simulation":{"type":"boolean"}},"required":["jobId","status","simulation"],"additionalProperties":true},"QuoteViewV1":{"oneOf":[{"type":"object","properties":{"points":{"type":"number"},"pointsPerSecond":{"type":"number"}},"required":["points","pointsPerSecond"],"additionalProperties":true},{"type":"object","properties":{"jobId":{"type":"string"},"alreadyAccepted":{"enum":[true]}},"required":["jobId","alreadyAccepted"],"additionalProperties":true}]},"UploadReservationViewV1":{"type":"object","properties":{"uploadId":{"type":"string"},"assetId":{"type":"string"},"assetVersionId":{"type":"string"},"upload":{"type":"object","properties":{"url":{"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"expiresAt":{"type":"string"}},"required":["url","headers","expiresAt"],"additionalProperties":true}},"required":["uploadId","assetId","assetVersionId","upload"],"additionalProperties":true},"UploadCompletionViewV1":{"type":"object","properties":{"assetId":{"type":"string"},"assetVersionId":{"type":"string"},"status":{"enum":["processing","available"]},"visibility":{"enum":["private","shared"]}},"required":["assetId","assetVersionId","status"],"additionalProperties":true},"ReuseViewV1":{"type":"object","properties":{"poseId":{"type":"string"},"poseRevision":{"type":"string"},"character":{"anyOf":[{"$ref":"#/components/schemas/AssetViewV1"},{"type":"null"}]},"secondaryReference":{"anyOf":[{"$ref":"#/components/schemas/AssetViewV1"},{"type":"null"}]},"context":{"$ref":"#/components/schemas/PublicContextViewV1"},"duration":{"type":"number"},"seed":{"type":"number"},"motion":{"type":"string"},"reusedFromRunId":{"type":"string"},"attireRecovered":{"type":"boolean"}},"required":["poseId","poseRevision","character","secondaryReference","context","duration","seed","motion","reusedFromRunId","attireRecovered"],"additionalProperties":true},"CapabilitiesViewV1":{"type":"object","properties":{"version":{"type":"string"},"generation":{"type":"object","properties":{"modes":{"type":"array","items":{"type":"string"}},"durations":{"type":"array","items":{"type":"integer"}},"width":{"type":"integer"},"height":{"type":"integer"},"fps":{"type":"integer"},"maxItems":{"type":"integer"}},"required":["modes","durations","width","height","fps","maxItems"],"additionalProperties":true},"generationTransport":{"enum":["mock","piper"]},"pointsPerSecond":{"type":"number"},"limits":{"type":"object","properties":{"queuedPerAccount":{"type":"integer"},"executingPerAccount":{"type":"integer"},"queuedTotal":{"type":"integer"}},"required":["queuedPerAccount","executingPerAccount","queuedTotal"],"additionalProperties":true},"uploads":{"type":"object","properties":{"maxBytes":{"type":"integer"},"maxPixels":{"type":"integer"},"reservationSeconds":{"type":"integer"},"limits":{"type":"object","properties":{"pending":{"type":"integer"},"dailyReservations":{"type":"integer"},"dailyBytes":{"type":"integer"},"storedBytes":{"type":["integer","null"],"description":"Total uploaded-picture allowance, excluding eligible temporary last frames. Null only for administrator sessions."},"tier":{"type":"string","enum":["free","paid","admin"]}}},"temporaryFrameDays":{"type":"integer","const":7}}}},"required":["version","generation","generationTransport","pointsPerSecond","limits"],"additionalProperties":true},"JobQueueV1":{"type":"object","additionalProperties":false,"description":"Present only while the job is queued. A rough guide, not a promise.","properties":{"ahead":{"type":"integer","description":"Queued jobs that reach a GPU before this one."},"running":{"type":"integer","description":"Jobs on a GPU now."},"estimatedStartSeconds":{"type":["integer","null"],"description":"Seconds until this job likely starts, from the median slot time of the last 20 finished jobs on one GPU. Null without history."}},"required":["ahead","running","estimatedStartSeconds"]}}},"paths":{"/session":{"get":{"summary":"Read your account identity","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/capabilities":{"get":{"summary":"Read supported settings, points per second and limits","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"description":"Engine settings are not permission grants. Customers submit structured template or Extend intent. Limits describe configured normal-account policy; /queue reports the effective account queue cap (null for an administrator)."}},"/wallet":{"get":{"summary":"Read your balance (in points and US dollars), account type and activity","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/usage":{"get":{"summary":"Read your usage in US dollars by day and by API token","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","required":["currency","timezone","from","to","account","totals","days","sources","tokens","rows"],"properties":{"currency":{"type":"string","const":"USD"},"timezone":{"type":"string","const":"UTC"},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"account":{"type":"object","required":["type","pointsPerUsd"],"properties":{"type":{"type":"string","enum":["business","standard"]},"pointsPerUsd":{"type":"number"}}},"totals":{"type":"object","required":["jobs","failedJobs","points","amountUsd","heldPoints","heldUsd"],"properties":{"jobs":{"type":"integer","description":"Charged and running jobs."},"points":{"type":"integer","description":"Usage units of captured jobs."},"amountUsd":{"type":"number","description":"US dollars, rounded to $0.0001."},"heldPoints":{"type":"integer"},"heldUsd":{"type":"number"},"failedJobs":{"type":"integer","description":"Failed or cancelled jobs; they cost nothing."}}},"days":{"type":"array","description":"Every day of the range, oldest first, including days without usage.","items":{"type":"object","required":["date","failedJobs","jobs","points","amountUsd","heldPoints","heldUsd"],"properties":{"date":{"type":"string","format":"date"},"jobs":{"type":"integer","description":"Charged and running jobs."},"points":{"type":"integer","description":"Usage units of captured jobs."},"amountUsd":{"type":"number","description":"US dollars, rounded to $0.0001."},"heldPoints":{"type":"integer"},"heldUsd":{"type":"number"},"failedJobs":{"type":"integer","description":"Failed or cancelled jobs; they cost nothing."}}}},"sources":{"type":"array","description":"Website, REST API and MCP jobs, always in this order.","items":{"type":"object","required":["source","jobs","failedJobs","points","amountUsd","heldPoints","heldUsd"],"properties":{"source":{"enum":["website","api","mcp"]},"jobs":{"type":"integer","description":"Charged and running jobs."},"points":{"type":"integer","description":"Usage units of captured jobs."},"amountUsd":{"type":"number","description":"US dollars, rounded to $0.0001."},"heldPoints":{"type":"integer"},"heldUsd":{"type":"number"},"failedJobs":{"type":"integer","description":"Failed or cancelled jobs; they cost nothing."}}}},"tokens":{"type":"array","description":"One row per API token with usage or still active, plus keyId null for website jobs; highest spend first.","items":{"type":"object","required":["keyId","failedJobs","name","keyPrefix","status","jobs","points","amountUsd","heldPoints","heldUsd"],"properties":{"keyId":{"type":["string","null"]},"name":{"type":["string","null"]},"keyPrefix":{"type":["string","null"]},"status":{"type":"string","enum":["website","active","expired","revoked","unknown"]},"jobs":{"type":"integer","description":"Charged and running jobs."},"points":{"type":"integer","description":"Usage units of captured jobs."},"amountUsd":{"type":"number","description":"US dollars, rounded to $0.0001."},"heldPoints":{"type":"integer"},"heldUsd":{"type":"number"},"failedJobs":{"type":"integer","description":"Failed or cancelled jobs; they cost nothing."}}}},"rows":{"type":"array","description":"Day by token detail, for export.","items":{"type":"object","required":["date","failedJobs","source","keyId","jobs","points","amountUsd","heldPoints","heldUsd"],"properties":{"date":{"type":"string","format":"date"},"keyId":{"type":["string","null"]},"jobs":{"type":"integer","description":"Charged and running jobs."},"points":{"type":"integer","description":"Usage units of captured jobs."},"amountUsd":{"type":"number","description":"US dollars, rounded to $0.0001."},"heldPoints":{"type":"integer"},"heldUsd":{"type":"number"},"failedJobs":{"type":"integer","description":"Failed or cancelled jobs; they cost nothing."},"source":{"enum":["website","api","mcp"]}}}}}}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough points in the account wallet, or the token reached its monthly points limit (code SPEND_CAP_REACHED). Nothing is charged; the website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"description":"Jobs of the whole account (website and every API token) between two UTC dates, inclusive. Defaults to the last 30 days; at most 92 days per request. amountUsd is what captured jobs cost and heldUsd what running jobs currently hold; failed and cancelled jobs cost nothing and are only counted in failedJobs. Dollars use the account price in force now (business accounts: their business rate). Jobs without a token (keyId null) were submitted on the website.","parameters":[{"name":"from","in":"query","required":false,"description":"First UTC day, YYYY-MM-DD. Default: 29 days before `to`.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Last UTC day, YYYY-MM-DD. Default: today (UTC).","schema":{"type":"string","format":"date"}}]}},"/queue":{"get":{"summary":"Read your waiting/executing counts, limits and admission availability","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/poses":{"get":{"summary":"List accessible published templates","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoseListViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"description":"Published public fields only. Supports q, category, limit (1–48) and cursor. Supplying limit or cursor enables pagination and nextCursor; legacy unpaged calls retain the 200-row maximum. Detail lookup is independent of that cap."}},"/assets":{"get":{"summary":"List your media and accessible shared media","parameters":[{"name":"scope","in":"query","description":"Use owner for your assets or public for assets in the approved public catalog.","schema":{"type":"string","enum":["owner","public"]}},{"name":"origin","in":"query","description":"Filter by how the asset was created or added before pagination.","schema":{"type":"string","enum":["admin_upload","user_upload","video_frame","generated","imported"]}}],"security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetListViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"description":"Supports type, visibility, scope=owner, q, poseId, characterId, category, tag, collection=liked and cursor. Returns at most 24 entries per page; preserve filters when following nextCursor. Refresh expiring media URLs through asset detail."},"post":{"summary":"Reserve an image upload. PUT bytes to upload.url with upload.headers before upload.expiresAt; then request completion. Adult verification is required for NSFW uploads.","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"201":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadReservationViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["filename","contentType","bytes","sha256","contentRating","style","rightsAttested","title"],"properties":{"filename":{"type":"string"},"title":{"type":"string"},"contentType":{"type":"string","enum":["image/png","image/jpeg","image/webp"]},"bytes":{"type":"integer","minimum":1,"maximum":2097152},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"contentRating":{"type":"string","enum":["sfw","nsfw"]},"style":{"type":"string"},"rightsAttested":{"const":true},"adultSubjectsVerified":{"type":"boolean"},"visibility":{"type":"string","enum":["private","shared"]},"tags":{"type":"array","items":{"type":"string"}},"derivedFrom":{"type":"object"},"externalVideoSource":{"type":"object"}}}}}},"description":"Uploaded pictures share a 2 MiB allowance on the free tier and 50 MiB on the paid tier (any verified purchase or a storage grant). Business (prepaid) accounts have no stored-picture limit: GET /capabilities reports tier paid with storedBytes null. GET /capabilities shows the account's uploads.limits. Images are private on creation. Normal users cannot change visibility. One owned last-frame slot per completed credit-charged video is exempt from picture storage and expires after seven days; other uploads remain metered. Pending/daily/transfer budgets apply to all uploads. Client lineage does not constitute pixel verification. New regular uploads reserved while upload normalization is enabled accept up to 5 megapixels and store one WebP for preview and reference use. Valid WebPs at or below 1.5 megapixels and 200,000 bytes keep their submitted bytes. All other regular uploads are resized if above 1.5 megapixels and encoded at WebP quality 90. The reservation checksum refers to the submitted bytes. Declared extracted frames use the existing upload path."}},"/generations/image":{"post":{"summary":"Generate a portrait image from a direct prompt","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"202":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationAcceptedViewV1"}}}},"400":{"$ref":"#/paths/~1generations/post/responses/400"},"401":{"$ref":"#/paths/~1generations/post/responses/401"},"402":{"$ref":"#/paths/~1generations/post/responses/402"},"403":{"$ref":"#/paths/~1generations/post/responses/403"},"404":{"$ref":"#/paths/~1generations/post/responses/404"},"409":{"$ref":"#/paths/~1generations/post/responses/409"},"429":{"$ref":"#/paths/~1generations/post/responses/429"},"503":{"$ref":"#/paths/~1generations/post/responses/503"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectImageGenerationIntent"}}}},"description":"The direct image preset produces a 736 × 1280 PNG and a WebP preview. Supply up to three optional ordered image references.","operationId":"createDirectImageGeneration"}},"/generations/direct":{"post":{"summary":"Submit a direct-prompt portrait video job","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"202":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationAcceptedViewV1"}}}},"400":{"$ref":"#/paths/~1generations/post/responses/400"},"401":{"$ref":"#/paths/~1generations/post/responses/401"},"402":{"$ref":"#/paths/~1generations/post/responses/402"},"403":{"$ref":"#/paths/~1generations/post/responses/403"},"404":{"$ref":"#/paths/~1generations/post/responses/404"},"409":{"$ref":"#/paths/~1generations/post/responses/409"},"429":{"$ref":"#/paths/~1generations/post/responses/429"},"503":{"$ref":"#/paths/~1generations/post/responses/503"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectGenerationIntent"}}}},"description":"Requires an API token with the generate scope and available images you own or eligible admin-published images from the public catalog. Both customer and admin tokens are supported. FL2VA uses ordered first and last frames. Ref2VA accepts one to three ordered references. Output is 736 × 1280 at 3, 5 or 7 seconds."}},"/generations/frame-to-frame":{"post":{"summary":"Accept a first- and last-frame FL2VA job and reserve points","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"202":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationAcceptedViewV1"}}}},"400":{"$ref":"#/paths/~1generations/post/responses/400"},"401":{"$ref":"#/paths/~1generations/post/responses/401"},"402":{"$ref":"#/paths/~1generations/post/responses/402"},"403":{"$ref":"#/paths/~1generations/post/responses/403"},"404":{"$ref":"#/paths/~1generations/post/responses/404"},"409":{"$ref":"#/paths/~1generations/post/responses/409"},"429":{"$ref":"#/paths/~1generations/post/responses/429"},"503":{"$ref":"#/paths/~1generations/post/responses/503"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FrameToFrameIntent"}}}}}},"/generations":{"get":{"summary":"List your jobs","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationListViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"parameters":[{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"poseId","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}}]},"post":{"summary":"Accept a template or Extend job and reserve points atomically","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"202":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationAcceptedViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/GenerationIntent"},{"$ref":"#/components/schemas/ExtensionIntent"}]}}}}}},"/generations/extend-to-pose":{"post":{"summary":"Extend an owned source image to a current text- or image-guided pose; guidance is resolved internally","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"202":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationAcceptedViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged."},"401":{"description":"Authentication required."},"402":{"description":"Not enough points."},"403":{"description":"Access denied."},"404":{"description":"Source image or destination pose not found."},"409":{"description":"Request ID or destination pose revision conflict."},"429":{"description":"Rate or admission limit reached.","headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"Backend generation service unavailable."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TargetPoseExtensionIntent"}}}}}},"/generations/image/quote":{"post":{"summary":"Quote a direct portrait image generation","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"A fixed image quote or an already accepted job A price quote also has amountUsd (the cost in US dollars at the account's price), currency (USD) and accountType (business or standard). An API or MCP quote also has balance: business, the balance the job is paid from (website jobs use the separate consumer balance).","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["points"],"properties":{"points":{"type":"integer","minimum":1}}},{"type":"object","required":["jobId","alreadyAccepted"],"properties":{"jobId":{"type":"string"},"alreadyAccepted":{"const":true}}}]}}}},"400":{"$ref":"#/paths/~1quote/post/responses/400"},"401":{"$ref":"#/paths/~1quote/post/responses/401"},"402":{"$ref":"#/paths/~1quote/post/responses/402"},"403":{"$ref":"#/paths/~1quote/post/responses/403"},"404":{"$ref":"#/paths/~1quote/post/responses/404"},"409":{"$ref":"#/paths/~1quote/post/responses/409"},"429":{"$ref":"#/paths/~1quote/post/responses/429"},"503":{"$ref":"#/paths/~1quote/post/responses/503"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectImageGenerationIntent"}}}},"description":"The direct image preset produces a 736 × 1280 PNG and a WebP preview. Supply up to three optional ordered image references.","operationId":"quoteDirectImageGeneration"}},"/generations/direct/quote":{"post":{"summary":"Quote a direct-prompt portrait video job","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response. A price quote also has amountUsd (the cost in US dollars at the account's price), currency (USD) and accountType (business or standard). An API or MCP quote also has balance: business, the balance the job is paid from (website jobs use the separate consumer balance).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteViewV1"}}}},"400":{"$ref":"#/paths/~1quote/post/responses/400"},"401":{"$ref":"#/paths/~1quote/post/responses/401"},"402":{"$ref":"#/paths/~1quote/post/responses/402"},"403":{"$ref":"#/paths/~1quote/post/responses/403"},"404":{"$ref":"#/paths/~1quote/post/responses/404"},"409":{"$ref":"#/paths/~1quote/post/responses/409"},"429":{"$ref":"#/paths/~1quote/post/responses/429"},"503":{"$ref":"#/paths/~1quote/post/responses/503"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectGenerationIntent"}}}},"description":"Requires an API token with the read scope and available images you own or eligible admin-published images from the public catalog. Both customer and admin tokens are supported. FL2VA uses ordered first and last frames. Ref2VA accepts one to three ordered references. Output is 736 × 1280 at 3, 5 or 7 seconds."}},"/generations/frame-to-frame/quote":{"post":{"summary":"Quote a first- and last-frame FL2VA job","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response. A price quote also has amountUsd (the cost in US dollars at the account's price), currency (USD) and accountType (business or standard). An API or MCP quote also has balance: business, the balance the job is paid from (website jobs use the separate consumer balance).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteViewV1"}}}},"400":{"$ref":"#/paths/~1quote/post/responses/400"},"401":{"$ref":"#/paths/~1quote/post/responses/401"},"402":{"$ref":"#/paths/~1quote/post/responses/402"},"403":{"$ref":"#/paths/~1quote/post/responses/403"},"404":{"$ref":"#/paths/~1quote/post/responses/404"},"409":{"$ref":"#/paths/~1quote/post/responses/409"},"429":{"$ref":"#/paths/~1quote/post/responses/429"},"503":{"$ref":"#/paths/~1quote/post/responses/503"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FrameToFrameIntent"}}}}}},"/quote":{"post":{"summary":"Validate new intent and quote points without admitting a job or reserving points","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response. A price quote also has amountUsd (the cost in US dollars at the account's price), currency (USD) and accountType (business or standard). An API or MCP quote also has balance: business, the balance the job is paid from (website jobs use the separate consumer balance).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/GenerationIntent"},{"$ref":"#/components/schemas/ExtensionIntent"}]}}}}}},"/assets/{assetVersionId}":{"parameters":[{"name":"assetVersionId","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Read accessible media and refresh its signed URL","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/assets/{assetVersionId}/reuse":{"parameters":[{"name":"assetVersionId","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Read currently reusable template settings","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReuseViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/generations/{jobId}":{"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Read your job state and available outputs","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/assets/uploads/{uploadId}/complete":{"parameters":[{"name":"uploadId","in":"path","required":true,"schema":{"type":"string"}}],"post":{"summary":"Request image validation. Retry completion to get 202 while processing, 200 when available, or 400 UPLOAD_CONTENT_REJECTED after a failed content check.","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"200":{"description":"Image is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadCompletionViewV1"}}}},"202":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadCompletionViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/generations/{jobId}/cancel":{"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"post":{"summary":"Cancellation is disabled after durable backend acceptance.","security":[{"bearerAuth":[]}],"x-required-scope":"generate","responses":{"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"CANCELLATION_DISABLED. Accepted work and its funding reservation remain unchanged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"deprecated":true,"description":"Cancellation remains disabled. After ownership checks, returns HTTP 409 with code CANCELLATION_DISABLED. Accepted jobs retain the original 20-minute total deadline; failure/expiry releases reserved points through settlement."}},"/generations/events":{"post":{"summary":"Read committed revisions for up to 50 owned jobs; reconnect to obtain newer revisions.","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Bounded text/event-stream of committed job revisions.","content":{"text/event-stream":{"schema":{"type":"string"},"example":"event: ready\ndata: {}\n\nevent: job\ndata: {\"jobId\":\"<jobId>\",\"revision\":1}\n\n"}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jobIds"],"properties":{"jobIds":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50}}}}}}}},"/poses/{poseId}":{"get":{"summary":"Read one published pose with the same public fields as the catalog","security":[{"bearerAuth":[]}],"x-required-scope":"read","responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPoseViewV1"}}}},"400":{"description":"Invalid request: malformed JSON, unsupported fields or values. Nothing is created or charged.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Missing, malformed, revoked or expired token (code TOKEN_REQUIRED when no token is sent).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Not enough balance in the account (code INSUFFICIENT_BALANCE), or the token reached its monthly limit (code SPEND_CAP_REACHED). Nothing is charged; top up or raise the limit and send the same requestId again. The website keeps working for the same account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"The token lacks the required scope or the route is outside the public API (code SCOPE_REQUIRED), the request address is outside the token's optional IP allowlist (code IP_NOT_ALLOWED), or the account is banned or unverified.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"The resource does not exist or is not accessible to this account.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"The request conflicts with current state: the same requestId was reused with a different body, or an upload or asset is not in a usable state (see x-error-codes).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Request rate limit (code RATE_LIMITED) or waiting-job limit (codes ACCOUNT_QUEUE_FULL, QUEUE_FULL) reached. Nothing is created or charged; retry after the Retry-After seconds.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}},"headers":{"Retry-After":{"description":"Seconds before retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"New work is temporarily not admitted (codes GENERATION_PAUSED, PROTECTION_UNAVAILABLE). Nothing is charged; honor Retry-After when present.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"parameters":[{"name":"poseId","in":"path","required":true,"schema":{"type":"string","pattern":"^pose_[a-f0-9-]+$"}}]}}},"x-error-codes":{"TOKEN_REQUIRED":"401: supply a personal API token","SCOPE_REQUIRED":"403: missing scope or public route permission","SPEND_CAP_REACHED":"402: token monthly points cap; website remains usable","RATE_LIMITED":"429: edge, account or token request rate; honor Retry-After","ACCOUNT_QUEUE_FULL":"429: account waiting-job limit","QUEUE_FULL":"429: service waiting-job limit","GENERATION_PAUSED":"503: no new admissions; accepted retries remain idempotent","PROTECTION_UNAVAILABLE":"503: request protection is unavailable; honor Retry-After","UPLOAD_PENDING_LIMIT":"429: finish pending uploads before reserving more","UPLOAD_DAILY_LIMIT":"429: daily reservation count or bytes reached; resets at UTC midnight","UPLOAD_STORAGE_LIMIT":"409: account uploaded-image storage allowance reached","UPLOAD_TRANSFER_BUSY":"409: concurrent PUT or exhausted transfer retries","UPLOAD_EXPIRED":"409: upload expired or transfer incomplete; reserve a new upload if expired","UPLOAD_CONTENT_REJECTED":"400: image failed the media content check; upload a different image","UPLOAD_VALIDATION_UNAVAILABLE":"503: image screening could not complete after retries; start a new upload","PUBLICATION_ADMIN_ONLY":"403: customer sharing controls are disabled; publication requires administrator approval","FRAME_ALREADY_EXISTS":"409: a temporary last frame already occupies this generated-video slot"}}