{"openapi":"3.1.0","info":{"title":"agent_service (api)","version":"0.1.0"},"paths":{"/v1/models":{"get":{"tags":["catalog"],"summary":"List models (OpenAI-compatible)","description":"Returns OpenAI-compatible model objects available to the caller.","operationId":"list_models_openai_compat_v1_models_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAIModelList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"catalog","title":"Models and capabilities","product_area":"Models and capabilities","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}}},"/v1/catalog/models":{"get":{"tags":["catalog"],"summary":"List catalog models","description":"Returns the same model list as `/v1/models`, namespaced under the beatra catalog.","operationId":"list_catalog_models_v1_catalog_models_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenAIModelList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"catalog","title":"Models and capabilities","product_area":"Models and capabilities","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":20}}},"/v1/catalog/capabilities":{"get":{"tags":["catalog"],"summary":"List capabilities","operationId":"list_capabilities_v1_catalog_capabilities_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"catalog","title":"Models and capabilities","product_area":"Models and capabilities","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":30}}},"/v1/catalog/capabilities/{capability}":{"get":{"tags":["catalog"],"summary":"Capability detail with typed media interface cards","operationId":"get_capability_v1_catalog_capabilities__capability__get","parameters":[{"name":"capability","in":"path","required":true,"schema":{"type":"string","title":"Capability"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CapabilityDetail"},{"$ref":"#/components/schemas/VideoCapabilityDetail"},{"$ref":"#/components/schemas/MusicCapabilityDetail"},{"$ref":"#/components/schemas/AudioCapabilityDetail"},{"$ref":"#/components/schemas/UnderstandingCapabilityDetail"},{"$ref":"#/components/schemas/VideoPromptEnhancementCapabilityDetail"}],"title":"Response Get Capability V1 Catalog Capabilities  Capability  Get"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"catalog","title":"Models and capabilities","product_area":"Models and capabilities","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":40}}},"/v1/catalog/models/{model}":{"get":{"tags":["catalog"],"summary":"Model detail with typed media interface cards","operationId":"get_model_v1_catalog_models__model__get","parameters":[{"name":"model","in":"path","required":true,"schema":{"type":"string","title":"Model"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ModelDetail"},{"$ref":"#/components/schemas/VideoModelDetail"},{"$ref":"#/components/schemas/MusicModelDetail"},{"$ref":"#/components/schemas/AudioModelDetail"},{"$ref":"#/components/schemas/UnderstandingModelDetail"}],"title":"Response Get Model V1 Catalog Models  Model  Get"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"catalog","title":"Models and capabilities","product_area":"Models and capabilities","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":50}}},"/v1/chat/completions":{"post":{"tags":["chat"],"summary":"Create chat completion (OpenAI-compatible)","description":"Creates a chat completion using an OpenAI-compatible request and response shape. Set `stream=true` to receive Server-Sent Events with `chat.completion.chunk` payloads. Use `model=\"auto\"` to let beatra choose a capable model, or pass a specific model id returned by `/v1/models`.","operationId":"chat_completions_v1_chat_completions_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}}},"responses":{"200":{"description":"Sync completion or streaming chat completion chunks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionResponse"}},"text/event-stream":{"schema":{"type":"string","description":"Server-Sent Events: `data: <ChatCompletionChunk>` events followed by `data: [DONE]`."}}}},"402":{"description":"Account balance too low","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"},"502":{"description":"Model request failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Model temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-beatra":{"visibility":"internal","group":"chat","title":"Text generation","product_area":"Text generation","mode":"sync","lifecycle":"ga","release_state":"ga","customer_facing":true,"docs_order":10}}},"/v1/images/generations":{"post":{"tags":["images"],"summary":"Generate one to four images from text","description":"Create an asynchronous image-generation task without source images. `auto` selects a live model that can satisfy the complete request; a concrete model is validated exactly as requested and is never substituted.","operationId":"images_generations_v1_images_generations_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextToImageRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"images","title":"Image generation","product_area":"Image generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}}},"/v1/images/image-to-image":{"post":{"tags":["images"],"summary":"Transform one to four ordered reference images","description":"Create an asynchronous task that uses one to four ordered images as references for a new result. `auto` selects a compatible live model; incompatible concrete-model requests are rejected without dropping references or changing controls.","operationId":"images_i2i_v1_images_image_to_image_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageToImageRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"images","title":"Image generation","product_area":"Image generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":20}}},"/v1/images/edits":{"post":{"tags":["images"],"summary":"Edit a base image with optional references and regions","description":"Create an asynchronous edit task where `images[0]` is the base image and later images are ordered references. Optional normalized regions target inputs by index. `auto` selects a compatible live model; a concrete model is never substituted.","operationId":"images_edits_v1_images_edits_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageEditRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"images","title":"Image generation","product_area":"Image generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":30}}},"/v1/images/responses":{"post":{"tags":["images"],"summary":"Image understanding (image_to_text)","operationId":"images_responses_v1_images_responses_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageToTextRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"images","title":"Image generation","product_area":"Image generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":40}}},"/v1/videos/prompts/enhance":{"post":{"tags":["videos"],"summary":"Enhance a video prompt from optional multimodal context","description":"Create an asynchronous text-only prompt-enhancement task. Successful tasks are charged after completion from actual input and output tokens; this call does not generate a video. The compatibility model field is ignored.","operationId":"videos_enhance_prompt_v1_videos_prompts_enhance_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoPromptEnhancementRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":5}}},"/v1/videos/text-to-video":{"post":{"tags":["videos"],"summary":"Generate video from text without source media","description":"Create an asynchronous video task from a text prompt, with optional driving audio for compatible models. The selected model must support every explicit control.","operationId":"videos_t2v_v1_videos_text_to_video_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextToVideoRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}}},"/v1/videos/image-to-video":{"post":{"tags":["videos"],"summary":"Animate one strict opening image","description":"Create an asynchronous video task whose input image is the required first frame, not a loose visual reference. The selected model must support every explicit control.","operationId":"videos_i2v_v1_videos_image_to_video_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageToVideoRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":20}}},"/v1/videos/reference-to-video":{"post":{"tags":["videos"],"summary":"Generate video from ordered multimodal references","description":"Create an asynchronous video task from ordered image, video, and audio references. Reference kinds, counts, durations, and controls are validated against the selected model.","operationId":"videos_r2v_v1_videos_reference_to_video_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferenceToVideoRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":30}}},"/v1/videos/frames-to-video":{"post":{"tags":["videos"],"summary":"Generate video toward a strict last frame","description":"Create an asynchronous video task constrained by a required last frame and an optional first frame. Use image-to-video when only the opening frame must be fixed.","operationId":"videos_f2v_v1_videos_frames_to_video_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FramesToVideoRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":40}}},"/v1/videos/edit":{"post":{"tags":["videos"],"summary":"Edit one source video with optional multimodal references","description":"Create an asynchronous instruction-based edit of one source video. Optional ordered image, video, and audio references are accepted when the selected model supports them.","operationId":"videos_edit_v1_videos_edit_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoEditRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":50}}},"/v1/videos/extend":{"post":{"tags":["videos"],"summary":"Extend one source video before or after its current content","description":"Create an asynchronous continuation immediately before or after one source video. `duration` is required and always means the final returned-video duration; it must exceed the trusted source duration.","operationId":"videos_extend_v1_videos_extend_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoExtendRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":60}}},"/v1/videos/compose":{"post":{"tags":["videos"],"summary":"Compose owned clips into one video","description":"Create an asynchronous task that joins the caller's own video clips into one MP4, with optional narration, ducked music, and burned-in subtitles.","operationId":"videos_compose_v1_videos_compose_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoComposeRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":80}}},"/v1/videos/responses":{"post":{"tags":["videos"],"summary":"Video understanding (video_to_text)","operationId":"videos_responses_v1_videos_responses_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoToTextRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"videos","title":"Video generation","product_area":"Video generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":70}}},"/v1/music/text-to-music":{"post":{"tags":["music"],"summary":"Generate music from a prompt and/or lyrics","operationId":"text_to_music_v1_music_text_to_music_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextToMusicRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"music","title":"Music generation","product_area":"Music generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}}},"/v1/music/reference-audio-to-music":{"post":{"tags":["music"],"summary":"Generate music from a reference audio","operationId":"ref_audio_to_music_v1_music_reference_audio_to_music_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferenceAudioToMusicRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"music","title":"Music generation","product_area":"Music generation","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":20}}},"/v1/audio/speech":{"post":{"tags":["audio"],"summary":"Text-to-speech","operationId":"text_to_speech_v1_audio_speech_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextToSpeechRequest"}}}},"responses":{"202":{"description":"Task accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"404":{"description":"Voice not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid request or voice/model mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-beatra":{"visibility":"public","group":"audio","title":"Audio and speech","product_area":"Audio and speech","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}}},"/v1/voices":{"get":{"tags":["voices"],"summary":"List available voices","operationId":"list_voices_v1_voices_get","parameters":[{"name":"language","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"BCP-47 / ISO-639-1 filter","title":"Language"},"description":"BCP-47 / ISO-639-1 filter"},{"name":"gender","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"preset | cloned","title":"Category"},"description":"preset | cloned"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Search in display names","title":"Q"},"description":"Search in display names"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"voices","title":"Audio and speech","product_area":"Audio and speech","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}},"post":{"tags":["voices"],"summary":"Clone a voice from an audio sample","operationId":"clone_voice_v1_voices_post","parameters":[{"name":"x-request-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Request-Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Idempotency-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceCloneRequest"}}}},"responses":{"202":{"description":"Clone task accepted; task output carries the new voice_id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"voices","title":"Audio and speech","product_area":"Audio and speech","mode":"async","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":20}}},"/v1/voices/{voice_id}":{"get":{"tags":["voices"],"summary":"Get a voice's detail","operationId":"get_voice_v1_voices__voice_id__get","parameters":[{"name":"voice_id","in":"path","required":true,"schema":{"type":"string","title":"Voice Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Voice"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"voices","title":"Audio and speech","product_area":"Audio and speech","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":30}},"delete":{"tags":["voices"],"summary":"Delete a cloned voice","operationId":"delete_voice_v1_voices__voice_id__delete","parameters":[{"name":"voice_id","in":"path","required":true,"schema":{"type":"string","title":"Voice Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Not found, or not a cloned voice you own","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"voices","title":"Audio and speech","product_area":"Audio and speech","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":40}}},"/v1/uploads":{"post":{"tags":["uploads"],"summary":"Single-shot upload (≤100MB)","operationId":"upload_v1_uploads_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_v1_uploads_post"}}}},"responses":{"201":{"description":"Upload accepted; artifact created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadResponse"}}}},"200":{"description":"Content already exists; returns existing artifact"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unprocessable Entity"}},"x-beatra":{"visibility":"public","group":"uploads","title":"Uploads","product_area":"Uploads","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}}},"/v1/tasks":{"get":{"tags":["tasks"],"summary":"List the caller's tasks","description":"Returns TaskSummary by default. Use `?expand=output,usage,billing,callback,input` or `?expand=all` to return full TaskEnvelope items.","operationId":"list_tasks_v1_tasks_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Status"}},{"name":"capability","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Capability"}},{"name":"created_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created After"}},{"name":"created_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created Before"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}},{"name":"expand","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated fields to include: output,usage,billing,callback,input,all","title":"Expand"},"description":"Comma-separated fields to include: output,usage,billing,callback,input,all"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__v1__schemas__tasks__TaskListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"tasks","title":"Async tasks","product_area":"Async tasks","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":10}}},"/v1/tasks/{task_id}":{"get":{"tags":["tasks"],"summary":"Get a task by id","operationId":"get_task_v1_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"tasks","title":"Async tasks","product_area":"Async tasks","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":20}}},"/v1/tasks/{task_id}/cancel":{"post":{"tags":["tasks"],"summary":"Cancel a task","operationId":"cancel_task_v1_tasks__task_id__cancel_post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskCancelRequest"},{"type":"null"}],"title":"Req"}}}},"responses":{"200":{"description":"Already terminal; returns final state (idempotent)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnvelope"}}}},"409":{"description":"Remote execution cannot be confirmed canceled; task continues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-beatra":{"visibility":"public","group":"tasks","title":"Async tasks","product_area":"Async tasks","mode":"sync","lifecycle":"preview","release_state":"preview","customer_facing":true,"docs_order":30}}},"/v1/health":{"get":{"tags":["health"],"summary":"Health","description":"Cheap self-check — does NOT depend on external stores.","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Health Get"}}}}},"x-beatra":{"visibility":"public","group":"health","title":"Diagnostics","product_area":"Diagnostics","mode":"sync","lifecycle":"ga","release_state":"ga","customer_facing":true,"docs_order":10}}},"/v1/readyz":{"get":{"tags":["health"],"summary":"Readyz","description":"Returns 200 only when ALL dependencies (mysql/mongo/redis) are reachable.","operationId":"readyz_v1_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-beatra":{"visibility":"internal","group":"health","title":"Diagnostics","product_area":"Diagnostics","mode":"sync","lifecycle":"internal","release_state":"internal","customer_facing":false,"docs_order":20}}},"/v1/livez":{"get":{"tags":["health"],"summary":"Livez","description":"Liveness — process is alive.","operationId":"livez_v1_livez_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Livez V1 Livez Get"}}}}},"x-beatra":{"visibility":"internal","group":"health","title":"Diagnostics","product_area":"Diagnostics","mode":"sync","lifecycle":"internal","release_state":"internal","customer_facing":false,"docs_order":30}}},"/webhooks/{provider_id}":{"post":{"tags":["webhooks"],"summary":"Receive","operationId":"receive_webhooks__provider_id__post","parameters":[{"name":"provider_id","in":"path","required":true,"schema":{"type":"string","title":"Provider Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/oauth/{provider}/start":{"get":{"tags":["account"],"summary":"Oauth Start","operationId":"oauth_start_account_oauth__provider__start_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"visitor_context_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":16,"maxLength":2048},{"type":"null"}],"title":"Visitor Context Token"}},{"name":"activation_return","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":16,"maxLength":2048},{"type":"null"}],"title":"Activation Return"}},{"name":"surface","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":16},{"type":"null"}],"title":"Surface"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthStartResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/oauth/google/id-token":{"post":{"tags":["account"],"summary":"Oauth Google Id Token","description":"Sign in on the H5 with the Google ID token an app shell signed in for natively.\n\nGoogle refuses its sign-in page inside an app's web view, so the iOS and Android\nshells sign in natively and hand the H5 the token (`backend/mobile/shared/shell.md`).","operationId":"oauth_google_id_token_account_oauth_google_id_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthIdTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthIdTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/oauth/apple/id-token":{"post":{"tags":["account"],"summary":"Oauth Apple Id Token","description":"Sign in on the H5 with the identity token the iOS shell got from Sign in with Apple.","operationId":"oauth_apple_id_token_account_oauth_apple_id_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthIdTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthIdTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/oauth/{provider}/callback":{"post":{"tags":["account"],"summary":"Oauth Callback","operationId":"oauth_callback_account_oauth__provider__callback_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthCallbackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthLoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/visitor-context":{"get":{"tags":["account"],"summary":"Visitor Context","operationId":"visitor_context_account_visitor_context_get","parameters":[{"name":"locale","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":16},{"type":"null"}],"title":"Locale"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisitorContextResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/country-options":{"get":{"tags":["account"],"summary":"Country Options","operationId":"country_options_account_country_options_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountryOptionsResponse"}}}}}}},"/account/profile":{"get":{"tags":["account"],"summary":"Profile","operationId":"profile_account_profile_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["account"],"summary":"Update Profile","operationId":"update_profile_account_profile_patch","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountProfileUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/profile/display-name":{"patch":{"tags":["account"],"summary":"Update Display Name","description":"Set the nickname, or clear it with null or blank: at most 10 characters with Chinese,\nJapanese or Korean in it, 20 without.","operationId":"update_display_name_account_profile_display_name_patch","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisplayNameUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/profile/avatar":{"put":{"tags":["account"],"summary":"Update Avatar","description":"Upload a new avatar (JPEG, PNG or WebP, at most 10 MiB); it is stored as a 256×256 WebP.","operationId":"update_avatar_account_profile_avatar_put","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_update_avatar_account_profile_avatar_put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["account"],"summary":"Delete Avatar","description":"Remove the avatar; the account shows its initial again.","operationId":"delete_avatar_account_profile_avatar_delete","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/delete":{"post":{"tags":["account"],"summary":"Delete Account","description":"Soft-delete the caller's account: retire the identity, keep the financial\nrecord. The console clears the session cookie after this returns.","operationId":"delete_account_account_delete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountDeletionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/auth/challenges":{"post":{"tags":["account"],"summary":"Create Auth Challenge","operationId":"create_auth_challenge_account_auth_challenges_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthChallengeCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthChallengeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/auth/challenges/{challenge_id}":{"get":{"tags":["account"],"summary":"Auth Challenge Status","operationId":"auth_challenge_status_account_auth_challenges__challenge_id__get","parameters":[{"name":"challenge_id","in":"path","required":true,"schema":{"type":"string","title":"Challenge Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthChallengeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/auth/challenges/{challenge_id}/verify":{"post":{"tags":["account"],"summary":"Verify Auth Challenge","operationId":"verify_auth_challenge_account_auth_challenges__challenge_id__verify_post","parameters":[{"name":"challenge_id","in":"path","required":true,"schema":{"type":"string","title":"Challenge Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthChallengeVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthChallengeVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/auth/wechat-miniprogram/grant":{"post":{"tags":["account"],"summary":"Grant Wechat Miniprogram Login","description":"Exchange a mini-program js_code for a one-time web-view ticket. No session cookie.","operationId":"grant_wechat_miniprogram_login_account_auth_wechat_miniprogram_grant_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatMiniProgramGrantRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatMiniProgramGrantResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/auth/wechat-miniprogram/redeem":{"post":{"tags":["account"],"summary":"Redeem Wechat Miniprogram Login","description":"Set the web-view session cookie. The ticket is not a session.","operationId":"redeem_wechat_miniprogram_login_account_auth_wechat_miniprogram_redeem_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatMiniProgramRedeemRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/session/logout":{"post":{"tags":["account"],"summary":"Logout Browser Session","description":"Clear the browser session cookie. Isolated from /v1 API keys.","operationId":"logout_browser_session_account_session_logout_post","responses":{"204":{"description":"Successful Response"}}}},"/account/session/handoff":{"post":{"tags":["account"],"summary":"Issue Session Handoff","description":"A one-time ticket for the other registrable domain. No cookie is set.","operationId":"issue_session_handoff_account_session_handoff_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionHandoffRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionHandoffResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/session/handoff/redeem":{"post":{"tags":["account"],"summary":"Redeem Session Handoff","description":"Mint a session cookie for this domain. The ticket is not a session.","operationId":"redeem_session_handoff_account_session_handoff_redeem_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionHandoffRedeemRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionHandoffRedeemResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/me":{"get":{"tags":["account"],"summary":"Me","operationId":"me_account_me_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/billing":{"get":{"tags":["account"],"summary":"Billing","operationId":"billing_account_billing_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/billing/overview":{"get":{"tags":["account"],"summary":"Billing Overview","operationId":"billing_overview_account_billing_overview_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingOverviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/billing/ledger":{"get":{"tags":["account"],"summary":"Billing Ledger","operationId":"billing_ledger_account_billing_ledger_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LedgerPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/billing/catalog":{"get":{"tags":["account"],"summary":"Billing Catalog","operationId":"billing_catalog_account_billing_catalog_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingCatalogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/connected-agents":{"get":{"tags":["account"],"summary":"Connected Agents","operationId":"connected_agents_account_connected_agents_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectedAgentsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/connected-agents/{installation_id}/connection":{"get":{"tags":["account"],"summary":"Connected Agent Connection","operationId":"connected_agent_connection_account_connected_agents__installation_id__connection_get","parameters":[{"name":"installation_id","in":"path","required":true,"schema":{"type":"string","title":"Installation Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectedAgentConnection"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/connected-agents/{installation_id}":{"patch":{"tags":["account"],"summary":"Rename Connected Agent","operationId":"rename_connected_agent_account_connected_agents__installation_id__patch","parameters":[{"name":"installation_id","in":"path","required":true,"schema":{"type":"string","title":"Installation Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectedAgentRenameRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectedAgentRenameResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["account"],"summary":"Dismiss Connected Agent","operationId":"dismiss_connected_agent_account_connected_agents__installation_id__delete","parameters":[{"name":"installation_id","in":"path","required":true,"schema":{"type":"string","title":"Installation Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/connected-agents/{installation_id}/revoke":{"post":{"tags":["account"],"summary":"Revoke Connected Agent","operationId":"revoke_connected_agent_account_connected_agents__installation_id__revoke_post","parameters":[{"name":"installation_id","in":"path","required":true,"schema":{"type":"string","title":"Installation Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectedAgentRevokeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders":{"get":{"tags":["account"],"summary":"Payment Orders","operationId":"payment_orders_account_payment_orders_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentOrdersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["account"],"summary":"Create Payment Order","operationId":"create_payment_order_account_payment_orders_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentOrderCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentOrderCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/{payment_order_id}/status":{"get":{"tags":["account"],"summary":"Payment Order Status","operationId":"payment_order_status_account_payment_orders__payment_order_id__status_get","parameters":[{"name":"payment_order_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentOrderStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/{payment_order_id}/receipt":{"get":{"tags":["account"],"summary":"Payment Order Receipt","operationId":"payment_order_receipt_account_payment_orders__payment_order_id__receipt_get","parameters":[{"name":"payment_order_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/invoiceable-orders":{"get":{"tags":["account"],"summary":"Invoiceable Orders","operationId":"invoiceable_orders_account_invoiceable_orders_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceableOrdersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/invoices":{"get":{"tags":["account"],"summary":"List Invoices","operationId":"list_invoices_account_invoices_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRequestsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["account"],"summary":"Create Invoice","operationId":"create_invoice_account_invoices_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRequestCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRequestItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/offers/free-video":{"get":{"tags":["account"],"summary":"Read Free Video Offer","operationId":"read_free_video_offer_account_offers_free_video_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeVideoOfferResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/offers/free-video/claim":{"post":{"tags":["account"],"summary":"Claim Free Video Offer","description":"Take the free first video.\n\nDeprecated since 2026-09-23: the first in-scope image_to_video or\ntext_to_video request spends the free video automatically. Kept only for\nconsoles built before that; remove once none are deployed.\n\nNo request body and no idempotency key: the tenant is the key, and\n`uq_free_video_entitlements_tenant` is what enforces once-ever. Clicking\ntwice is a read, and clicking on an already-spent offer reports that state\nrather than raising — \"you already used this\" is a sentence the page says,\nnot a 409 the caller has to interpret.","operationId":"claim_free_video_offer_account_offers_free_video_claim_post","deprecated":true,"parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeVideoOfferResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/invoices/{invoice_request_id}/cancel":{"post":{"tags":["account"],"summary":"Cancel Invoice","operationId":"cancel_invoice_account_invoices__invoice_request_id__cancel_post","parameters":[{"name":"invoice_request_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Request Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceRequestItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/invoices/{invoice_request_id}/file":{"get":{"tags":["account"],"summary":"Invoice File","operationId":"invoice_file_account_invoices__invoice_request_id__file_get","parameters":[{"name":"invoice_request_id","in":"path","required":true,"schema":{"type":"string","title":"Invoice Request Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/subscriptions":{"get":{"tags":["account"],"summary":"Subscriptions","operationId":"subscriptions_account_subscriptions_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSubscriptionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/subscriptions/{subscription_id}/cancel":{"post":{"tags":["account"],"summary":"Cancel Subscription","operationId":"cancel_subscription_account_subscriptions__subscription_id__cancel_post","parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","title":"Subscription Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSubscriptionItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/{payment_order_id}/payer":{"post":{"tags":["account"],"summary":"Complete Payment Order Payer","description":"Finish a parked jsapi order with WeChat's silent-authorize code+state (older H5 pages).","operationId":"complete_payment_order_payer_account_payment_orders__payment_order_id__payer_post","parameters":[{"name":"payment_order_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentOrderPayerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentOrderPayerResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/wechat-payer/start":{"post":{"tags":["account"],"summary":"Start Wechat Payer","description":"One silent WeChat authorize that names this browser's payer.\n\nIt comes back to the pay it was making (``pay`` and ``pi`` on the top-up\nscreen); no payment order exists yet.","operationId":"start_wechat_payer_account_wechat_payer_start_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatPayerStartRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatPayerStartResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/wechat-payer":{"post":{"tags":["account"],"summary":"Complete Wechat Payer","description":"Exchange WeChat's silent-authorize code; this browser now has a payer.","operationId":"complete_wechat_payer_account_wechat_payer_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatPayerCompleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatPayerCompleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/{payment_order_id}/mock-complete":{"post":{"tags":["account"],"summary":"Mock Complete Payment Order","operationId":"mock_complete_payment_order_account_payment_orders__payment_order_id__mock_complete_post","parameters":[{"name":"payment_order_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentOrderMockCompleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/work-shares":{"post":{"tags":["account"],"summary":"Create Work Share","operationId":"create_work_share_account_work_shares_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkShareCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkShareCreatedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/work-shares/artifact/{artifact_id}":{"get":{"tags":["account"],"summary":"Work Share State","description":"Whether the owner's work has an open link: its page says so, and offers to close it.","operationId":"work_share_state_account_work_shares_artifact__artifact_id__get","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkShareStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["account"],"summary":"Revoke Work Share","operationId":"revoke_work_share_account_work_shares_artifact__artifact_id__delete","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/work-shares/{share_id}":{"get":{"tags":["account"],"summary":"Open Work Share","description":"Public. The link is the capability. A closed or unknown link is a 404.","operationId":"open_work_share_account_work_shares__share_id__get","parameters":[{"name":"share_id","in":"path","required":true,"schema":{"type":"string","title":"Share Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkSharePageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/wechat/js-sdk":{"post":{"tags":["account"],"summary":"Wechat Js Sdk Config","description":"Public. The 公众号 signature for one H5 address, so WeChat's ··· card shows that page.\n\nOnly h5.beatra.cn (the 公众号's JS接口安全域名) is signed, only for the page\nitself, a few times a minute per visitor. When the gateway cannot sign (no\n公众号 setup, WeChat refusing) the answer is `enabled: false` and the page\nkeeps WeChat's own card: a missing card is not a server error.","operationId":"wechat_js_sdk_config_account_wechat_js_sdk_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatJsSdkConfigRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WechatJsSdkConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/assets":{"get":{"tags":["account"],"summary":"Assets","operationId":"assets_account_assets_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"media_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Media Type"}},{"name":"origin","in":"query","required":false,"schema":{"anyOf":[{"enum":["generated","uploaded"],"type":"string"},{"type":"null"}],"title":"Origin"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/capabilities":{"get":{"tags":["account"],"summary":"Capabilities","description":"What Beatra can actually do for this customer, projected from live state.\n\nPurely derived — see `app/services/accounts/capabilities.py`. The console\nreads this instead of hardcoding a capability catalog.","operationId":"capabilities_account_capabilities_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCapabilitiesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/api-keys":{"post":{"tags":["account"],"summary":"Create Key","operationId":"create_key_account_api_keys_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["account"],"summary":"List Keys","operationId":"list_keys_account_api_keys_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/api-keys/{api_key_id}/revoke":{"post":{"tags":["account"],"summary":"Revoke Key","operationId":"revoke_key_account_api_keys__api_key_id__revoke_post","parameters":[{"name":"api_key_id","in":"path","required":true,"schema":{"type":"string","title":"Api Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/callback-signing-keys":{"post":{"tags":["account"],"summary":"Create Callback Signing Key","operationId":"create_callback_signing_key_account_callback_signing_keys_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCallbackSigningKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedCallbackSigningKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["account"],"summary":"List Callback Signing Keys","operationId":"list_callback_signing_keys_account_callback_signing_keys_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackSigningKeyListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/callback-signing-keys/{signing_key_id}/rotate":{"post":{"tags":["account"],"summary":"Rotate Callback Signing Key","operationId":"rotate_callback_signing_key_account_callback_signing_keys__signing_key_id__rotate_post","parameters":[{"name":"signing_key_id","in":"path","required":true,"schema":{"type":"string","title":"Signing Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedCallbackSigningKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/callback-signing-keys/{signing_key_id}/retire":{"post":{"tags":["account"],"summary":"Retire Callback Signing Key","operationId":"retire_callback_signing_key_account_callback_signing_keys__signing_key_id__retire_post","parameters":[{"name":"signing_key_id","in":"path","required":true,"schema":{"type":"string","title":"Signing Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetireCallbackSigningKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/usage":{"get":{"tags":["account"],"summary":"Get Usage","operationId":"get_usage_account_usage_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"group_by","in":"query","required":false,"schema":{"$ref":"#/components/schemas/GroupBy","default":"capability_model"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageWindow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/tasks":{"get":{"tags":["account"],"summary":"List Tasks","operationId":"list_tasks_account_tasks_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/TaskStatusEnum"},{"type":"null"}],"title":"Status"}},{"name":"capability","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Capability"}},{"name":"output_kind","in":"query","required":false,"schema":{"anyOf":[{"const":"asset","type":"string"},{"type":"null"}],"title":"Output Kind"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"exclude_first_party","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Exclude First Party"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/app__api__account__schemas__TaskListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/tasks/{task_id}":{"get":{"tags":["account"],"summary":"Get Task","operationId":"get_task_account_tasks__task_id__get","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/tasks/{task_id}/library-entry":{"delete":{"tags":["account"],"summary":"Delete Task Library Entry","operationId":"delete_task_library_entry_account_tasks__task_id__library_entry_delete","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskLibraryDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/assets/{artifact_id}/title":{"patch":{"tags":["account"],"summary":"Update Asset Title","description":"Rename one of the customer's generated works; a null or blank title clears the rename.","operationId":"update_asset_title_account_assets__artifact_id__title_patch","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTitleUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTitleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/assets/{artifact_id}/library-entry":{"delete":{"tags":["account"],"summary":"Delete Asset Library Entry","description":"Take one of the customer's uploads or generated works out of their library (a soft hide; the file stays).\n\nA generated work leaves on its own (a song comes in two; keeping one is fine), and its\nmake leaves with its last work. A whole make can still leave through\n`/tasks/{task_id}/library-entry`.","operationId":"delete_asset_library_entry_account_assets__artifact_id__library_entry_delete","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetLibraryDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/callbacks":{"get":{"tags":["account"],"summary":"List Callbacks","operationId":"list_callbacks_account_callbacks_get","parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/CallbackStatusEnum"},{"type":"null"}],"title":"Status"}},{"name":"task_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":64},{"type":"null"}],"title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CallbackListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/model-roster":{"get":{"tags":["account"],"summary":"Model Roster","operationId":"model_roster_account_model_roster_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelRosterResponse"}}}}}}},"/account/feedback":{"get":{"tags":["account-feedback"],"summary":"Get Feedback","operationId":"get_feedback_account_feedback_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackThreadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/feedback/messages":{"post":{"tags":["account-feedback"],"summary":"Send Feedback Message","operationId":"send_feedback_message_account_feedback_messages_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_send_feedback_message_account_feedback_messages_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackMessageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/feedback/read":{"post":{"tags":["account-feedback"],"summary":"Mark Feedback Read","operationId":"mark_feedback_read_account_feedback_read_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackReadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackReadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/feedback/messages/{message_id}/screenshot":{"get":{"tags":["account-feedback"],"summary":"Get Feedback Screenshot","operationId":"get_feedback_screenshot_account_feedback_messages__message_id__screenshot_get","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","title":"Message Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/wechat-virtual":{"post":{"tags":["account"],"summary":"Create Virtual Payment","operationId":"create_virtual_payment_account_payment_orders_wechat_virtual_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VirtualPayCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Create Virtual Payment Account Payment Orders Wechat Virtual Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/wechat-virtual/sign":{"post":{"tags":["account"],"summary":"Sign Virtual Payment","operationId":"sign_virtual_payment_account_payment_orders_wechat_virtual_sign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VirtualPaySignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Sign Virtual Payment Account Payment Orders Wechat Virtual Sign Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/wechat-virtual/cashier-result":{"post":{"tags":["account"],"summary":"Note Virtual Cashier Result","description":"The native cashier's word. A token from sign is the only credential, and this does not grant credits.","operationId":"note_virtual_cashier_result_account_payment_orders_wechat_virtual_cashier_result_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VirtualCashierResultRequest"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["account"],"summary":"Read Virtual Cashier Result","operationId":"read_virtual_cashier_result_account_payment_orders_wechat_virtual_cashier_result_get","parameters":[{"name":"payment_order_id","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":64,"title":"Payment Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Read Virtual Cashier Result Account Payment Orders Wechat Virtual Cashier Result Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/voices":{"get":{"tags":["account"],"summary":"List Voices","operationId":"list_voices_account_voices_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/voices/{voice_id}":{"patch":{"tags":["account"],"summary":"Rename Voice","operationId":"rename_voice_account_voices__voice_id__patch","parameters":[{"name":"voice_id","in":"path","required":true,"schema":{"type":"string","title":"Voice Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceRenameRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceRenameResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["account"],"summary":"Delete Voice","operationId":"delete_voice_account_voices__voice_id__delete","parameters":[{"name":"voice_id","in":"path","required":true,"schema":{"type":"string","title":"Voice Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/voices/{voice_id}/preview":{"post":{"tags":["account"],"summary":"Voice Preview","operationId":"voice_preview_account_voices__voice_id__preview_post","parameters":[{"name":"voice_id","in":"path","required":true,"schema":{"type":"string","title":"Voice Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoicePreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/presenter-defaults":{"put":{"tags":["account"],"summary":"Put Defaults","operationId":"put_defaults_account_presenter_defaults_put","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefaultsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefaultsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/presenter-avatars":{"get":{"tags":["account"],"summary":"List Avatars","operationId":"list_avatars_account_presenter_avatars_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["account"],"summary":"Create Avatar","operationId":"create_avatar_account_presenter_avatars_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/presenter-avatars/candidates":{"get":{"tags":["account"],"summary":"Avatar Candidates","operationId":"avatar_candidates_account_presenter_avatars_candidates_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/presenter-avatars/{avatar_id}":{"patch":{"tags":["account"],"summary":"Patch Avatar","operationId":"patch_avatar_account_presenter_avatars__avatar_id__patch","parameters":[{"name":"avatar_id","in":"path","required":true,"schema":{"type":"string","title":"Avatar Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarPatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["account"],"summary":"Delete Avatar","operationId":"delete_avatar_account_presenter_avatars__avatar_id__delete","parameters":[{"name":"avatar_id","in":"path","required":true,"schema":{"type":"string","title":"Avatar Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/uploads/images":{"post":{"tags":["account"],"summary":"Upload Image","description":"A JPEG, PNG or WebP of at most 10 MiB, stored as an upload like the Agent's.","operationId":"upload_image_account_uploads_images_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_image_account_uploads_images_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/wechat-miniapp":{"post":{"tags":["account"],"summary":"Create Miniapp Payment","operationId":"create_miniapp_payment_account_payment_orders_wechat_miniapp_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MiniappPayCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Create Miniapp Payment Account Payment Orders Wechat Miniapp Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/wechat-miniapp/opened":{"post":{"tags":["account"],"summary":"Mark Miniapp Pay Opened","description":"The new native page reached onLoad. The web-view's navigate success is not this.","operationId":"mark_miniapp_pay_opened_account_payment_orders_wechat_miniapp_opened_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MiniappPayTicketRequest"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["account"],"summary":"Miniapp Pay Opened","operationId":"miniapp_pay_opened_account_payment_orders_wechat_miniapp_opened_get","parameters":[{"name":"payment_order_id","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":64,"title":"Payment Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Miniapp Pay Opened Account Payment Orders Wechat Miniapp Opened Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/wechat-miniapp/sign":{"post":{"tags":["account"],"summary":"Sign Miniapp Payment","operationId":"sign_miniapp_payment_account_payment_orders_wechat_miniapp_sign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MiniappPaySignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Sign Miniapp Payment Account Payment Orders Wechat Miniapp Sign Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/account/payment-orders/wechat-miniapp/cashier-result":{"post":{"tags":["account"],"summary":"Note Miniapp Cashier Result","operationId":"note_miniapp_cashier_result_account_payment_orders_wechat_miniapp_cashier_result_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MiniappCashierResultRequest"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["account"],"summary":"Read Miniapp Cashier Result","operationId":"read_miniapp_cashier_result_account_payment_orders_wechat_miniapp_cashier_result_get","parameters":[{"name":"payment_order_id","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":64,"title":"Payment Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Read Miniapp Cashier Result Account Payment Orders Wechat Miniapp Cashier Result Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/payments/webhooks/stripe":{"post":{"summary":"Stripe Webhook","operationId":"stripe_webhook_payments_webhooks_stripe_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Stripe Webhook Payments Webhooks Stripe Post"}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"tags":["mcp-device-authorization"],"summary":"Device Authorization Server Metadata","operationId":"device_authorization_server_metadata__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Device Authorization Server Metadata  Well Known Oauth Authorization Server Get"}}}}}}},"/oauth/device_authorization":{"post":{"tags":["mcp-device-authorization"],"summary":"Oauth Device Authorization","operationId":"oauth_device_authorization_oauth_device_authorization_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/token":{"post":{"tags":["mcp-device-authorization"],"summary":"Oauth Device Token","operationId":"oauth_device_token_oauth_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/device/revoke":{"post":{"tags":["mcp-device-authorization"],"summary":"Oauth Device Self Revoke","description":"Device-side uninstall: a Device Token revokes its own connection.\n\nAuthenticated by the token itself — a token can only ever revoke the\nconnection it belongs to, so there is nothing else to authorize. The\nresponse never carries identifiers; the caller already knows who it is.","operationId":"oauth_device_self_revoke_oauth_device_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/device":{"get":{"tags":["mcp-device-authorization"],"summary":"Device Entry","operationId":"device_entry_device_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/device/lookup":{"post":{"tags":["mcp-device-authorization"],"summary":"Device Lookup","operationId":"device_lookup_device_lookup_post","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/device/activate/{device_authorization_id}":{"get":{"tags":["mcp-device-authorization"],"summary":"Device Activation","operationId":"device_activation_device_activate__device_authorization_id__get","parameters":[{"name":"device_authorization_id","in":"path","required":true,"schema":{"type":"string","title":"Device Authorization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/device/activate/{device_authorization_id}/decision":{"post":{"tags":["mcp-device-authorization"],"summary":"Device Activation Decision","operationId":"device_activation_decision_device_activate__device_authorization_id__decision_post","parameters":[{"name":"device_authorization_id","in":"path","required":true,"schema":{"type":"string","title":"Device Authorization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AccountCapabilitiesResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AccountCapabilityItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"AccountCapabilitiesResponse"},"AccountCapabilityItem":{"properties":{"capability":{"type":"string","title":"Capability"},"release_state":{"$ref":"#/components/schemas/CapabilityReleaseStateEnum"},"reachable_via":{"items":{"$ref":"#/components/schemas/CapabilitySurfaceEnum"},"type":"array","title":"Reachable Via"},"rest_path":{"type":"string","title":"Rest Path"},"mcp_tools":{"items":{"type":"string"},"type":"array","title":"Mcp Tools"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"image_interfaces":{"items":{"$ref":"#/components/schemas/ImageInterfaceCard"},"type":"array","title":"Image Interfaces"},"audio_interfaces":{"items":{"$ref":"#/components/schemas/AudioModelCard"},"type":"array","title":"Audio Interfaces"},"understanding_interfaces":{"items":{"$ref":"#/components/schemas/UnderstandingModelCard"},"type":"array","title":"Understanding Interfaces"},"max_output_images":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Max Output Images"},"max_canvas_pixels":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Canvas Pixels"},"starting_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Starting Credits"}},"type":"object","required":["capability","release_state","rest_path"],"title":"AccountCapabilityItem","description":"What Beatra can actually do for this customer, right now.\n\nEvery field is projected from live backend state (the domain capability\ncatalog, the `/v1` route release-state declarations, the capability adapter\nregistry, the MCP tool registry, and the model/route catalog). Nothing here\nis a hand-maintained claim.\n\n`reachable_via` is the authoritative usability field. `rest_path` and\n`mcp_tools` describe *where* a capability lives (or will live) and are\npopulated even when it is not callable — an empty `reachable_via` means \"do\nnot call this\", regardless of the paths listed alongside it."},"AccountDeletionResponse":{"properties":{"status":{"type":"string","const":"deleted","title":"Status"}},"type":"object","required":["status"],"title":"AccountDeletionResponse"},"AccountPersonaResponse":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"type":"object","title":"AccountPersonaResponse","description":"The customer's nickname and avatar, as they now stand."},"AccountProfileResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"user_id":{"type":"string","title":"User Id"},"country_code":{"type":"string","title":"Country Code"},"country_source":{"type":"string","title":"Country Source"},"preferred_locale":{"type":"string","title":"Preferred Locale"},"locale_source":{"type":"string","title":"Locale Source"},"country_policy_key":{"type":"string","title":"Country Policy Key"},"country_policy_version":{"type":"integer","title":"Country Policy Version"},"login_methods":{"$ref":"#/components/schemas/LoginMethodsResponse"},"identities":{"items":{"$ref":"#/components/schemas/LoginIdentityResponse"},"type":"array","title":"Identities"},"currency":{"type":"string","title":"Currency"},"commercial_catalog_key":{"type":"string","title":"Commercial Catalog Key"},"invoice_title_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Title Name"},"invoice_tax_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Tax Id"},"invoice_recipient_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Recipient Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"type":"object","required":["tenant_id","user_id","country_code","country_source","preferred_locale","locale_source","country_policy_key","country_policy_version","login_methods","currency","commercial_catalog_key"],"title":"AccountProfileResponse"},"AccountProfileUpdateRequest":{"properties":{"country_code":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"Country Code"},"preferred_locale":{"anyOf":[{"type":"string","maxLength":16,"minLength":2},{"type":"null"}],"title":"Preferred Locale"},"invoice_title_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Invoice Title Name"},"invoice_tax_id":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Invoice Tax Id"},"invoice_recipient_email":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Invoice Recipient Email"}},"type":"object","title":"AccountProfileUpdateRequest"},"AccountSubscriptionItem":{"properties":{"subscription_id":{"type":"string","title":"Subscription Id"},"status":{"type":"string","title":"Status"},"product_id":{"type":"string","title":"Product Id"},"term_id":{"type":"string","title":"Term Id"},"offer_id":{"type":"string","title":"Offer Id"},"provider":{"type":"string","title":"Provider"},"billing_interval":{"type":"string","title":"Billing Interval"},"current_period_start":{"type":"string","format":"date-time","title":"Current Period Start"},"current_period_end":{"type":"string","format":"date-time","title":"Current Period End"},"cancel_at_period_end":{"type":"boolean","title":"Cancel At Period End"},"canceled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Canceled At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["subscription_id","status","product_id","term_id","offer_id","provider","billing_interval","current_period_start","current_period_end","cancel_at_period_end","created_at","updated_at"],"title":"AccountSubscriptionItem"},"AccountSubscriptionsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AccountSubscriptionItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"AccountSubscriptionsResponse"},"ActivePassItem":{"properties":{"term":{"type":"string","title":"Term"},"plan_level":{"type":"string","title":"Plan Level"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"auto_renew":{"type":"boolean","title":"Auto Renew"}},"type":"object","required":["term","plan_level","expires_at","auto_renew"],"title":"ActivePassItem","description":"The plan pass the account currently holds, if any.\n\nValidity is decided by the clock, not the balance: a customer who has spent\nevery credit still holds the pass they paid for until it lapses. Tying the\nidentity to `remaining_credits > 0` would make spending feel like losing\nsomething, which is exactly the wrong incentive on a prepaid product."},"AssetItem":{"properties":{"artifact_id":{"type":"string","title":"Artifact Id"},"source_type":{"type":"string","title":"Source Type"},"capability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability"},"media_type":{"type":"string","title":"Media Type"},"mime_type":{"type":"string","title":"Mime Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"cdn_url":{"type":"string","title":"Cdn Url"},"created_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created Task Id"},"status":{"type":"string","title":"Status"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"thumbnail":{"anyOf":[{"$ref":"#/components/schemas/AssetThumbnailItem"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"title_source":{"anyOf":[{"type":"string","enum":["user","auto"]},{"type":"null"}],"title":"Title Source"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["artifact_id","source_type","media_type","mime_type","size_bytes","cdn_url","status","created_at","updated_at"],"title":"AssetItem"},"AssetLibraryDeleteResponse":{"properties":{"artifact_id":{"type":"string","title":"Artifact Id"},"status":{"type":"string","const":"removed","title":"Status","default":"removed"},"task_removed":{"type":"boolean","title":"Task Removed","default":false}},"type":"object","required":["artifact_id"],"title":"AssetLibraryDeleteResponse","description":"An upload or one generated work taken out of the library: the file and its URL stay."},"AssetListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AssetItem"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"AssetListResponse"},"AssetThumbnailItem":{"properties":{"status":{"type":"string","enum":["pending","processing","ready","failed"],"title":"Status"},"cdn_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cdn Url"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"type":"object","required":["status"],"title":"AssetThumbnailItem"},"AssetTitleResponse":{"properties":{"artifact_id":{"type":"string","title":"Artifact Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"title_source":{"anyOf":[{"type":"string","enum":["user","auto"]},{"type":"null"}],"title":"Title Source"}},"type":"object","required":["artifact_id"],"title":"AssetTitleResponse"},"AssetTitleUpdateRequest":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"title":"Title"}},"additionalProperties":false,"type":"object","required":["title"],"title":"AssetTitleUpdateRequest","description":"A customer's title for one of their works; null or blank clears it (the auto title shows again)."},"AssistantAudio":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data"},"expires_at":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires At"},"transcript":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transcript"}},"type":"object","title":"AssistantAudio"},"AssistantMessage":{"properties":{"role":{"type":"string","const":"assistant","title":"Role"},"content":{"anyOf":[{"type":"string"},{"items":{"$ref":"#/components/schemas/TextContentPart"},"type":"array"},{"type":"null"}],"title":"Content"},"refusal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refusal"},"reasoning_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning Content","description":"Chain-of-thought from thinking models (DeepSeek-Reasoner / GLM-Z1 / Kimi K2-thinking / Hunyuan-T1 / Doubao-thinking / OpenAI o-series). Normalized by beatra. Clients should NOT echo back next turn."},"tool_calls":{"anyOf":[{"items":{"$ref":"#/components/schemas/ToolCall"},"type":"array"},{"type":"null"}],"title":"Tool Calls"},"audio":{"anyOf":[{"$ref":"#/components/schemas/AssistantAudio"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["role"],"title":"AssistantMessage"},"AudioAutoSelectionCard":{"properties":{"request_dependent":{"type":"boolean","title":"Request Dependent"},"selection_inputs":{"items":{"type":"string","const":"voice"},"type":"array","title":"Selection Inputs"},"default_for_omitted_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default For Omitted Request"},"candidate_order":{"items":{"type":"string"},"type":"array","title":"Candidate Order"},"persisted_selection_field":{"type":"string","const":"resolved_model","title":"Persisted Selection Field","default":"resolved_model"}},"additionalProperties":false,"type":"object","required":["request_dependent","selection_inputs","default_for_omitted_request","candidate_order"],"title":"AudioAutoSelectionCard"},"AudioCapabilityDetail":{"properties":{"capability":{"type":"string","enum":["text_to_speech","voice_clone"],"title":"Capability"},"endpoint":{"type":"string","title":"Endpoint"},"input_modality":{"type":"string","title":"Input Modality"},"output_modality":{"type":"string","enum":["audio","voice"],"title":"Output Modality"},"execution_mode":{"type":"string","const":"async","title":"Execution Mode","default":"async"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"auto":{"$ref":"#/components/schemas/AudioAutoSelectionCard"},"models":{"items":{"$ref":"#/components/schemas/AudioModelCard"},"type":"array","title":"Models"}},"additionalProperties":false,"type":"object","required":["capability","endpoint","input_modality","output_modality","description","status","auto","models"],"title":"AudioCapabilityDetail"},"AudioModelCard":{"properties":{"schema_version":{"type":"string","const":"audio-interface.v1","title":"Schema Version","default":"audio-interface.v1"},"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"capability":{"type":"string","enum":["text_to_speech","voice_clone"],"title":"Capability"},"status":{"type":"string","const":"available","title":"Status","default":"available"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls"},"constraints":{"anyOf":[{"$ref":"#/components/schemas/SpeechConstraintsCard"},{"$ref":"#/components/schemas/VoiceCloneConstraintsCard"}],"title":"Constraints"},"pricing":{"$ref":"#/components/schemas/AudioPricingCard"}},"additionalProperties":false,"type":"object","required":["model","display_name","capability","controls","constraints","pricing"],"title":"AudioModelCard"},"AudioModelDetail":{"properties":{"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"interfaces":{"items":{"$ref":"#/components/schemas/AudioModelCard"},"type":"array","title":"Interfaces"}},"additionalProperties":false,"type":"object","required":["model","display_name","description","status","interfaces"],"title":"AudioModelDetail"},"AudioNumberRange":{"properties":{"minimum":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Minimum"},"maximum":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Maximum"},"exclusive_minimum":{"type":"boolean","title":"Exclusive Minimum","default":false}},"additionalProperties":false,"type":"object","required":["minimum","maximum"],"title":"AudioNumberRange"},"AudioOutputConfig":{"properties":{"voice":{"type":"string","title":"Voice"},"format":{"type":"string","enum":["wav","mp3","flac","opus","pcm16"],"title":"Format"}},"type":"object","required":["voice","format"],"title":"AudioOutputConfig"},"AudioPricingCard":{"properties":{"meter":{"type":"string","enum":["character","task"],"title":"Meter"},"unit":{"type":"string","enum":["character","task"],"title":"Unit"},"unit_price_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unit Price Credits"},"scale":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Scale"},"billing_basis":{"type":"string","enum":["beatra_weighted_characters","successful_activated_voice"],"title":"Billing Basis"},"estimate_formula":{"type":"string","const":"(unit_price_credits * billable_quantity) / scale","title":"Estimate Formula","default":"(unit_price_credits * billable_quantity) / scale"}},"additionalProperties":false,"type":"object","required":["meter","unit","unit_price_credits","scale","billing_basis"],"title":"AudioPricingCard"},"AuthChallengeCreateRequest":{"properties":{"method":{"$ref":"#/components/schemas/LoginMethodEnum"},"subject":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Subject"},"visitor_context_token":{"anyOf":[{"type":"string","maxLength":2048,"minLength":16},{"type":"null"}],"title":"Visitor Context Token"},"country_code":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"Country Code"},"preferred_locale":{"anyOf":[{"type":"string","maxLength":16,"minLength":2},{"type":"null"}],"title":"Preferred Locale"},"activation_return":{"anyOf":[{"type":"string","maxLength":2048,"minLength":16},{"type":"null"}],"title":"Activation Return"}},"type":"object","required":["method"],"title":"AuthChallengeCreateRequest"},"AuthChallengeResponse":{"properties":{"challenge_id":{"type":"string","title":"Challenge Id"},"method":{"$ref":"#/components/schemas/LoginMethodEnum"},"status":{"type":"string","enum":["pending","authenticated","consumed","expired"],"title":"Status"},"mode":{"$ref":"#/components/schemas/ChallengeModeEnum"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"country_code":{"type":"string","title":"Country Code"},"locale":{"type":"string","title":"Locale"},"login_methods":{"$ref":"#/components/schemas/LoginMethodsResponse"},"verification_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Hint"},"mock_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mock Code"},"qr_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qr Url"},"completion_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completion Token"}},"type":"object","required":["challenge_id","method","status","mode","expires_at","country_code","locale","login_methods"],"title":"AuthChallengeResponse"},"AuthChallengeVerifyRequest":{"properties":{"code":{"type":"string","maxLength":64,"minLength":1,"title":"Code"},"wechat_code":{"anyOf":[{"type":"string","maxLength":256,"minLength":1},{"type":"null"}],"title":"Wechat Code"},"wechat_state":{"anyOf":[{"type":"string","maxLength":256,"minLength":1},{"type":"null"}],"title":"Wechat State"}},"type":"object","required":["code"],"title":"AuthChallengeVerifyRequest"},"AuthChallengeVerifyResponse":{"properties":{"token":{"type":"string","title":"Token"},"token_type":{"type":"string","const":"bearer","title":"Token Type","default":"bearer"},"tenant_id":{"type":"string","title":"Tenant Id"},"activation_return":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Return"}},"type":"object","required":["token","tenant_id"],"title":"AuthChallengeVerifyResponse"},"AvatarCreateRequest":{"properties":{"artifact_id":{"type":"string","maxLength":64,"minLength":1,"title":"Artifact Id"},"display_name":{"type":"string","maxLength":200,"minLength":1,"title":"Display Name"},"purpose":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Purpose"},"voice_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Voice Id"},"make_default":{"type":"boolean","title":"Make Default","default":false},"consent_attested":{"type":"boolean","const":true,"title":"Consent Attested"},"consent_subject":{"type":"string","enum":["self","authorized_other"],"title":"Consent Subject"}},"additionalProperties":false,"type":"object","required":["artifact_id","display_name","consent_attested","consent_subject"],"title":"AvatarCreateRequest"},"AvatarItem":{"properties":{"avatar_id":{"type":"string","title":"Avatar Id"},"display_name":{"type":"string","title":"Display Name"},"purpose":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"},"image":{"$ref":"#/components/schemas/ImageItem"},"voice":{"anyOf":[{"$ref":"#/components/schemas/AvatarVoice"},{"type":"null"}]},"is_default":{"type":"boolean","title":"Is Default"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["avatar_id","display_name","purpose","image","voice","is_default","created_at"],"title":"AvatarItem"},"AvatarListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AvatarItem"},"type":"array","title":"Items"},"default_avatar_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Avatar Id"}},"type":"object","required":["items","default_avatar_id"],"title":"AvatarListResponse"},"AvatarPatchRequest":{"properties":{"display_name":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Display Name"},"purpose":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Purpose"},"voice_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Voice Id"}},"additionalProperties":false,"type":"object","title":"AvatarPatchRequest","description":"Leave a field out to keep it; null clears the use or the paired voice."},"AvatarVoice":{"properties":{"voice_id":{"type":"string","title":"Voice Id"},"display_name":{"type":"string","title":"Display Name"}},"type":"object","required":["voice_id","display_name"],"title":"AvatarVoice"},"BillingCatalogOffer":{"properties":{"offer_id":{"type":"string","title":"Offer Id"},"product_id":{"type":"string","title":"Product Id"},"term_id":{"type":"string","title":"Term Id"},"purchase_mode":{"type":"string","enum":["one_time","subscription"],"title":"Purchase Mode"},"billing_interval":{"type":"string","enum":["monthly","quarterly","yearly","none"],"title":"Billing Interval"},"currency":{"type":"string","title":"Currency"},"fiat_amount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Fiat Amount"},"list_fiat_amount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"List Fiat Amount"},"credits_granted":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Credits Granted"},"validity_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Validity Days"},"payment_method_id":{"type":"string","title":"Payment Method Id"},"provider":{"type":"string","title":"Provider"},"is_recommended":{"type":"boolean","title":"Is Recommended","default":false},"sort_order":{"type":"integer","title":"Sort Order"}},"type":"object","required":["offer_id","product_id","term_id","purchase_mode","billing_interval","currency","fiat_amount","list_fiat_amount","credits_granted","payment_method_id","provider","sort_order"],"title":"BillingCatalogOffer"},"BillingCatalogPaymentMethod":{"properties":{"payment_method_id":{"type":"string","title":"Payment Method Id"},"provider":{"type":"string","title":"Provider"}},"type":"object","required":["payment_method_id","provider"],"title":"BillingCatalogPaymentMethod"},"BillingCatalogPlan":{"properties":{"product_id":{"type":"string","title":"Product Id"},"product_code":{"type":"string","title":"Product Code"},"plan_level":{"type":"string","title":"Plan Level"},"title_key":{"type":"string","title":"Title Key"},"description_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Key"},"sort_order":{"type":"integer","title":"Sort Order"},"concurrent_task_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Concurrent Task Limit"},"offers":{"items":{"$ref":"#/components/schemas/BillingCatalogOffer"},"type":"array","title":"Offers"}},"type":"object","required":["product_id","product_code","plan_level","title_key","sort_order","offers"],"title":"BillingCatalogPlan"},"BillingCatalogResponse":{"properties":{"country_code":{"type":"string","title":"Country Code"},"country_policy_key":{"type":"string","title":"Country Policy Key"},"country_policy_version":{"type":"integer","title":"Country Policy Version"},"currency":{"type":"string","title":"Currency"},"checkout_mode":{"type":"string","enum":["mock_provider","provider_checkout","provider_unavailable"],"title":"Checkout Mode"},"checkout_channels":{"items":{"type":"string"},"type":"array","title":"Checkout Channels","default":[]},"miniapp_pay":{"anyOf":[{"type":"string","enum":["jsapi","virtual"]},{"type":"null"}],"title":"Miniapp Pay"},"payment_methods":{"items":{"$ref":"#/components/schemas/BillingCatalogPaymentMethod"},"type":"array","title":"Payment Methods"},"plans":{"items":{"$ref":"#/components/schemas/BillingCatalogPlan"},"type":"array","title":"Plans"},"extra_credit_packs":{"items":{"$ref":"#/components/schemas/BillingCatalogOffer"},"type":"array","title":"Extra Credit Packs"}},"type":"object","required":["country_code","country_policy_key","country_policy_version","currency","checkout_mode","payment_methods","plans","extra_credit_packs"],"title":"BillingCatalogResponse"},"BillingOverviewResponse":{"properties":{"balance_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Balance Credits"},"expiring_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Expiring Credits"},"non_expiring_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Non Expiring Credits"},"next_expiry_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Expiry At"},"next_expiry_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Next Expiry Credits","default":"0"},"active_pass":{"anyOf":[{"$ref":"#/components/schemas/ActivePassItem"},{"type":"null"}]},"active_subscription":{"anyOf":[{"$ref":"#/components/schemas/AccountSubscriptionItem"},{"type":"null"}]},"recent_grants":{"items":{"$ref":"#/components/schemas/CreditGrantSummaryItem"},"type":"array","title":"Recent Grants"},"ledger":{"items":{"$ref":"#/components/schemas/LedgerEntry"},"type":"array","title":"Ledger"}},"type":"object","required":["balance_credits","expiring_credits","non_expiring_credits","recent_grants","ledger"],"title":"BillingOverviewResponse"},"BillingResponse":{"properties":{"balance_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Balance Credits"},"ledger":{"items":{"$ref":"#/components/schemas/LedgerEntry"},"type":"array","title":"Ledger"}},"type":"object","required":["balance_credits","ledger"],"title":"BillingResponse"},"Body_send_feedback_message_account_feedback_messages_post":{"properties":{"client_message_id":{"type":"string","maxLength":128,"minLength":1,"title":"Client Message Id"},"body":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Body"},"screenshot":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Screenshot"}},"type":"object","required":["client_message_id"],"title":"Body_send_feedback_message_account_feedback_messages_post"},"Body_update_avatar_account_profile_avatar_put":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_update_avatar_account_profile_avatar_put"},"Body_upload_image_account_uploads_images_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_image_account_uploads_images_post"},"Body_upload_v1_uploads_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"purpose":{"type":"string","enum":["media_input","reference_audio","voice_clone_source"],"title":"Purpose","default":"media_input"},"media_type":{"anyOf":[{"type":"string","enum":["image","video","audio"]},{"type":"null"}],"title":"Media Type"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["file"],"title":"Body_upload_v1_uploads_post"},"CallbackItem":{"properties":{"callback_id":{"type":"string","title":"Callback Id"},"task_id":{"type":"string","title":"Task Id"},"capability":{"type":"string","title":"Capability"},"event_type":{"type":"string","title":"Event Type"},"url":{"type":"string","title":"Url"},"status":{"$ref":"#/components/schemas/CallbackStatusEnum"},"attempt_count":{"type":"integer","title":"Attempt Count"},"last_status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Status Code"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"next_action_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Action At"},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Delivered At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["callback_id","task_id","capability","event_type","url","status","attempt_count","created_at"],"title":"CallbackItem"},"CallbackListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CallbackItem"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"CallbackListResponse"},"CallbackSigningKeyItem":{"properties":{"signing_key_id":{"type":"string","title":"Signing Key Id"},"name":{"type":"string","title":"Name"},"secret_prefix":{"type":"string","title":"Secret Prefix"},"status":{"type":"string","enum":["active","retired"],"title":"Status"},"replaces_signing_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replaces Signing Key Id"},"retired_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Retired At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["signing_key_id","name","secret_prefix","status","created_at","updated_at"],"title":"CallbackSigningKeyItem"},"CallbackSigningKeyListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CallbackSigningKeyItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"CallbackSigningKeyListResponse"},"CallbackStatusEnum":{"type":"string","enum":["pending","dispatching","delivered","retrying","failed"],"title":"CallbackStatusEnum"},"CandidateListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ImageItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"CandidateListResponse"},"CapabilityDetail":{"properties":{"capability":{"type":"string","enum":["text_to_image","image_to_image","image_edit"],"title":"Capability"},"endpoint":{"type":"string","title":"Endpoint"},"input_modality":{"type":"string","title":"Input Modality"},"output_modality":{"type":"string","const":"image","title":"Output Modality","default":"image"},"execution_mode":{"type":"string","const":"async","title":"Execution Mode","default":"async"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status","default":"available"},"auto":{"$ref":"#/components/schemas/ImageAutoSelectionCard"},"models":{"items":{"$ref":"#/components/schemas/ImageInterfaceCard"},"type":"array","title":"Models"},"max_output_images":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":1.0},{"type":"null"}],"title":"Max Output Images"},"max_canvas_pixels":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Canvas Pixels"},"starting_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Starting Credits"}},"additionalProperties":false,"type":"object","required":["capability","endpoint","input_modality","description","auto","models"],"title":"CapabilityDetail"},"CapabilityList":{"properties":{"object":{"type":"string","const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/CapabilityListItem"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"CapabilityList"},"CapabilityListItem":{"properties":{"capability":{"type":"string","title":"Capability"},"endpoint":{"type":"string","title":"Endpoint"},"input_modality":{"type":"string","title":"Input Modality"},"output_modality":{"type":"string","title":"Output Modality"},"execution_mode":{"type":"string","title":"Execution Mode"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"model_count":{"type":"integer","title":"Model Count"}},"type":"object","required":["capability","endpoint","input_modality","output_modality","execution_mode","model_count"],"title":"CapabilityListItem"},"CapabilityReleaseStateEnum":{"type":"string","enum":["ga","beta","preview","planned"],"title":"CapabilityReleaseStateEnum","description":"The only release states `/account/capabilities` can emit.\n\n`app.api.contract.ReleaseState` also has `stub` and `internal`. Both are\nstructurally excluded from this projection — a stub 501s and an internal\nroute is not a customer surface — so they are absent from this enum on\npurpose. The console can trust every state it sees here."},"CapabilitySurfaceEnum":{"type":"string","enum":["mcp","rest"],"title":"CapabilitySurfaceEnum"},"ChallengeModeEnum":{"type":"string","enum":["real","mock","fallback"],"title":"ChallengeModeEnum"},"ChatChoice":{"properties":{"index":{"type":"integer","title":"Index"},"message":{"$ref":"#/components/schemas/AssistantMessage"},"finish_reason":{"anyOf":[{"type":"string","enum":["stop","length","tool_calls","content_filter","function_call"]},{"type":"null"}],"title":"Finish Reason"},"logprobs":{"anyOf":[{"$ref":"#/components/schemas/Logprobs"},{"type":"null"}]}},"type":"object","required":["index","message","finish_reason"],"title":"ChatChoice"},"ChatCompletionRequest":{"properties":{"model":{"type":"string","title":"Model","description":"Model name (e.g. 'gpt-4o-mini', 'qwen-max', 'auto')"},"messages":{"items":{"oneOf":[{"$ref":"#/components/schemas/SystemMessage"},{"$ref":"#/components/schemas/UserMessage"},{"$ref":"#/components/schemas/AssistantMessage"},{"$ref":"#/components/schemas/ToolMessage"}],"discriminator":{"propertyName":"role","mapping":{"assistant":"#/components/schemas/AssistantMessage","developer":"#/components/schemas/SystemMessage","system":"#/components/schemas/SystemMessage","tool":"#/components/schemas/ToolMessage","user":"#/components/schemas/UserMessage"}}},"type":"array","title":"Messages"},"temperature":{"anyOf":[{"type":"number","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Temperature"},"top_p":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Top P"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","description":"Legacy; reasoning models reject this. beatra maps to max_completion_tokens."},"max_completion_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Completion Tokens"},"n":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":1.0},{"type":"null"}],"title":"N"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"stop":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop"},"stream":{"type":"boolean","title":"Stream","default":false},"stream_options":{"anyOf":[{"$ref":"#/components/schemas/StreamOptions"},{"type":"null"}]},"frequency_penalty":{"anyOf":[{"type":"number","maximum":2.0,"minimum":-2.0},{"type":"null"}],"title":"Frequency Penalty"},"presence_penalty":{"anyOf":[{"type":"number","maximum":2.0,"minimum":-2.0},{"type":"null"}],"title":"Presence Penalty"},"logit_bias":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Logit Bias"},"logprobs":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Logprobs"},"top_logprobs":{"anyOf":[{"type":"integer","maximum":20.0,"minimum":0.0},{"type":"null"}],"title":"Top Logprobs"},"tools":{"anyOf":[{"items":{"$ref":"#/components/schemas/Tool"},"type":"array"},{"type":"null"}],"title":"Tools"},"tool_choice":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/NamedFunctionChoice"},{"type":"null"}],"title":"Tool Choice"},"parallel_tool_calls":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Parallel Tool Calls"},"response_format":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/ResponseFormatText"},{"$ref":"#/components/schemas/ResponseFormatJsonObject"},{"$ref":"#/components/schemas/ResponseFormatJsonSchema"}],"discriminator":{"propertyName":"type","mapping":{"json_object":"#/components/schemas/ResponseFormatJsonObject","json_schema":"#/components/schemas/ResponseFormatJsonSchema","text":"#/components/schemas/ResponseFormatText"}}},{"type":"null"}],"title":"Response Format"},"reasoning":{"anyOf":[{"type":"boolean"},{"$ref":"#/components/schemas/ReasoningConfig"},{"type":"null"}],"title":"Reasoning"},"reasoning_effort":{"anyOf":[{"type":"string","enum":["minimal","low","medium","high","max","xhigh"]},{"type":"null"}],"title":"Reasoning Effort"},"audio":{"anyOf":[{"$ref":"#/components/schemas/AudioOutputConfig"},{"type":"null"}]},"modalities":{"anyOf":[{"items":{"type":"string","enum":["text","audio"]},"type":"array"},{"type":"null"}],"title":"Modalities"},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata"},"store":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Store"},"service_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Tier"},"safety_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safety Identifier"},"prompt_cache_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Cache Key"},"user":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User","description":"Deprecated; use safety_identifier"}},"additionalProperties":false,"type":"object","required":["model","messages"],"title":"ChatCompletionRequest","description":"Request body for POST /v1/chat/completions.\n\nOpenAI-compatible request with an explicit, typed field surface. Raw\nupstream passthrough is intentionally forbidden because it can override\nthe routed model, messages, streaming mode, or operator service tier."},"ChatCompletionResponse":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","const":"chat.completion","title":"Object","default":"chat.completion"},"created":{"type":"integer","title":"Created"},"model":{"type":"string","title":"Model","description":"Resolved model snapshot (OpenAI convention)"},"system_fingerprint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Fingerprint"},"service_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Tier"},"choices":{"items":{"$ref":"#/components/schemas/ChatChoice"},"type":"array","title":"Choices"},"usage":{"$ref":"#/components/schemas/ChatUsage"}},"type":"object","required":["id","created","model","choices","usage"],"title":"ChatCompletionResponse","description":"Standard OpenAI ChatCompletion response plus usage.credits."},"ChatUsage":{"properties":{"prompt_tokens":{"type":"integer","title":"Prompt Tokens"},"completion_tokens":{"type":"integer","title":"Completion Tokens"},"total_tokens":{"type":"integer","title":"Total Tokens"},"cache_creation_input_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cache Creation Input Tokens"},"cache_read_input_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cache Read Input Tokens"},"reasoning_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reasoning Tokens"},"prompt_tokens_details":{"anyOf":[{"$ref":"#/components/schemas/PromptTokensDetails"},{"type":"null"}]},"completion_tokens_details":{"anyOf":[{"$ref":"#/components/schemas/CompletionTokensDetails"},{"type":"null"}]},"credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Credits","description":"Credits charged for this call. Populated by PR-2."}},"type":"object","required":["prompt_tokens","completion_tokens","total_tokens"],"title":"ChatUsage"},"CompletionTokensDetails":{"properties":{"reasoning_tokens":{"type":"integer","title":"Reasoning Tokens","default":0},"audio_tokens":{"type":"integer","title":"Audio Tokens","default":0},"accepted_prediction_tokens":{"type":"integer","title":"Accepted Prediction Tokens","default":0},"rejected_prediction_tokens":{"type":"integer","title":"Rejected Prediction Tokens","default":0}},"type":"object","title":"CompletionTokensDetails"},"ComposeClip":{"properties":{"source":{"$ref":"#/components/schemas/MediaInputArtifact"},"start":{"type":"number","minimum":0.0,"title":"Start","description":"Trim start, seconds.","default":0},"end":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"End","description":"Trim end, seconds; omit for the clip's end."},"keep_audio":{"type":"boolean","title":"Keep Audio","description":"Keep this clip's own sound, trimmed with the clip. Off by default: the clip is muted.","default":false}},"additionalProperties":false,"type":"object","required":["source"],"title":"ComposeClip"},"ComposeMusic":{"properties":{"source":{"$ref":"#/components/schemas/MediaInputArtifact"},"volume":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Volume","default":0.25}},"additionalProperties":false,"type":"object","required":["source"],"title":"ComposeMusic"},"ComposeSubtitle":{"properties":{"start":{"type":"number","minimum":0.0,"title":"Start"},"end":{"type":"number","exclusiveMinimum":0.0,"title":"End"},"text":{"type":"string","maxLength":80,"minLength":1,"title":"Text"}},"additionalProperties":false,"type":"object","required":["start","end","text"],"title":"ComposeSubtitle"},"ConnectedAgentConnection":{"properties":{"installation_id":{"type":"string","title":"Installation Id"},"status":{"type":"string","enum":["connecting","connected","expired","revoked","disconnected"],"title":"Status"},"connection_phase":{"anyOf":[{"type":"string","enum":["connecting","waiting"]},{"type":"null"}],"title":"Connection Phase"}},"type":"object","required":["installation_id","status"],"title":"ConnectedAgentConnection","description":"One device's live connection reading, polled right after Allow."},"ConnectedAgentItem":{"properties":{"installation_id":{"type":"string","title":"Installation Id"},"platform":{"type":"string","title":"Platform"},"client_name":{"type":"string","title":"Client Name"},"device_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Name"},"platforms":{"items":{"type":"string"},"type":"array","title":"Platforms"},"external_installation_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Installation Ref"},"status":{"type":"string","enum":["connecting","connected","expired","revoked","disconnected"],"title":"Status"},"connection_phase":{"anyOf":[{"type":"string","enum":["connecting","waiting"]},{"type":"null"}],"title":"Connection Phase"},"installation_status":{"type":"string","title":"Installation Status"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"credential_count":{"type":"integer","title":"Credential Count"},"active_credential_count":{"type":"integer","title":"Active Credential Count"},"credential_status":{"anyOf":[{"type":"string","enum":["issued","active","expired","revoked","superseded"]},{"type":"null"}],"title":"Credential Status"},"token_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token Prefix"},"issued_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Issued At"},"idle_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Idle Expires At"},"today_spend_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Today Spend Credits"},"total_spend_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Total Spend Credits","default":"0"},"recent_tasks":{"items":{"$ref":"#/components/schemas/ConnectedAgentRecentTask"},"type":"array","title":"Recent Tasks"},"skills":{"items":{"$ref":"#/components/schemas/ConnectedAgentSkill"},"type":"array","title":"Skills"},"recovery_code":{"type":"string","enum":["none","await_first_use","reauthorize_expired","reauthorize_disconnected","reauthorize_revoked"],"title":"Recovery Code"},"recovery_command":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recovery Command"},"recovery_docs_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recovery Docs Url"},"can_revoke":{"type":"boolean","title":"Can Revoke"},"device_kind":{"type":"string","title":"Device Kind","default":"agent"},"installed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Installed At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["installation_id","platform","client_name","status","installation_status","credential_count","active_credential_count","today_spend_credits","recovery_code","can_revoke","created_at","updated_at"],"title":"ConnectedAgentItem"},"ConnectedAgentRecentTask":{"properties":{"task_id":{"type":"string","title":"Task Id"},"capability":{"type":"string","title":"Capability"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"status":{"type":"string","title":"Status"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"recovery_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recovery Hint"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["task_id","capability","status","created_at"],"title":"ConnectedAgentRecentTask"},"ConnectedAgentRenameRequest":{"properties":{"device_name":{"type":"string","maxLength":120,"minLength":1,"title":"Device Name"}},"additionalProperties":false,"type":"object","required":["device_name"],"title":"ConnectedAgentRenameRequest"},"ConnectedAgentRenameResponse":{"properties":{"installation_id":{"type":"string","title":"Installation Id"},"device_name":{"type":"string","title":"Device Name"}},"type":"object","required":["installation_id","device_name"],"title":"ConnectedAgentRenameResponse"},"ConnectedAgentRevokeResponse":{"properties":{"installation_id":{"type":"string","title":"Installation Id"},"status":{"type":"string","const":"revoked","title":"Status"},"revoked_credentials":{"type":"integer","title":"Revoked Credentials"}},"type":"object","required":["installation_id","status","revoked_credentials"],"title":"ConnectedAgentRevokeResponse"},"ConnectedAgentSkill":{"properties":{"package_slug":{"type":"string","title":"Package Slug"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"last_version":{"type":"string","title":"Last Version"},"platforms":{"items":{"type":"string"},"type":"array","title":"Platforms"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"last_seen_at":{"type":"string","format":"date-time","title":"Last Seen At"}},"type":"object","required":["package_slug","last_version","first_seen_at","last_seen_at"],"title":"ConnectedAgentSkill","description":"One Skill package used on this device (docs/device-model.md).\n\n`platforms` are the agent environments this skill has been active in.\nThe operational `recognized` flag is deliberately absent — it is backend\nregistry lag, not a customer concept."},"ConnectedAgentsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ConnectedAgentItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"ConnectedAgentsResponse"},"CountryOptionResponse":{"properties":{"country_code":{"type":"string","title":"Country Code"},"country_policy_key":{"type":"string","title":"Country Policy Key"},"currency":{"type":"string","title":"Currency"},"commercial_catalog_key":{"type":"string","title":"Commercial Catalog Key"}},"type":"object","required":["country_code","country_policy_key","currency","commercial_catalog_key"],"title":"CountryOptionResponse"},"CountryOptionsResponse":{"properties":{"version":{"type":"integer","title":"Version"},"unknown_country_code":{"type":"string","title":"Unknown Country Code"},"items":{"items":{"$ref":"#/components/schemas/CountryOptionResponse"},"type":"array","title":"Items"}},"type":"object","required":["version","unknown_country_code","items"],"title":"CountryOptionsResponse"},"CreateCallbackSigningKeyRequest":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name","default":"callback"}},"type":"object","title":"CreateCallbackSigningKeyRequest"},"CreateKeyRequest":{"properties":{"name":{"type":"string","maxLength":64,"minLength":1,"title":"Name","default":"key"}},"type":"object","title":"CreateKeyRequest"},"CreatedCallbackSigningKeyResponse":{"properties":{"signing_key_id":{"type":"string","title":"Signing Key Id"},"name":{"type":"string","title":"Name"},"secret_prefix":{"type":"string","title":"Secret Prefix"},"status":{"type":"string","const":"active","title":"Status"},"secret":{"type":"string","title":"Secret"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"replaces_signing_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replaces Signing Key Id"}},"type":"object","required":["signing_key_id","name","secret_prefix","status","secret","created_at"],"title":"CreatedCallbackSigningKeyResponse"},"CreatedKeyResponse":{"properties":{"api_key_id":{"type":"string","title":"Api Key Id"},"name":{"type":"string","title":"Name"},"key_prefix":{"type":"string","title":"Key Prefix"},"status":{"type":"string","title":"Status"},"secret":{"type":"string","title":"Secret"}},"type":"object","required":["api_key_id","name","key_prefix","status","secret"],"title":"CreatedKeyResponse"},"CreditGrantSummaryItem":{"properties":{"grant_id":{"type":"string","title":"Grant Id"},"source_type":{"type":"string","title":"Source Type"},"remaining_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Remaining Credits"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["grant_id","source_type","remaining_credits","status","created_at"],"title":"CreditGrantSummaryItem"},"DefaultVoice":{"properties":{"voice_id":{"type":"string","title":"Voice Id"},"display_name":{"type":"string","title":"Display Name"},"category":{"type":"string","title":"Category"}},"type":"object","required":["voice_id","display_name","category"],"title":"DefaultVoice"},"DefaultsRequest":{"properties":{"voice_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Voice Id"},"avatar_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Avatar Id"}},"additionalProperties":false,"type":"object","title":"DefaultsRequest","description":"Leave a field out to keep it; send null to clear it."},"DefaultsResponse":{"properties":{"voice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice Id"},"avatar_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Id"}},"type":"object","required":["voice_id","avatar_id"],"title":"DefaultsResponse"},"DisplayNameUpdateRequest":{"properties":{"display_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["display_name"],"title":"DisplayNameUpdateRequest","description":"A new nickname, or null (or blank) to clear it. Length is checked after trimming."},"ErrorBody":{"properties":{"code":{"type":"string","title":"Code","description":"Stable public error code"},"type":{"type":"string","title":"Type","description":"Broad SDK-friendly error family"},"message":{"type":"string","title":"Message","description":"Human-readable explanation"},"retryable":{"type":"boolean","title":"Retryable","description":"If true, retrying the exact same request may succeed"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details","description":"Code-specific structured info"},"request_id":{"type":"string","title":"Request Id","description":"Echo of X-Request-Id for support correlation"},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Param","description":"JSON Pointer to offending field, if applicable"}},"type":"object","required":["code","type","message","retryable","request_id"],"title":"ErrorBody"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorBody"}},"type":"object","required":["error"],"title":"ErrorResponse"},"FeedbackConversationResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"region":{"type":"string","title":"Region"},"tenant_id":{"type":"string","title":"Tenant Id"},"user_id":{"type":"string","title":"User Id"},"user_status":{"type":"string","title":"User Status"},"display_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Identity"},"last_sequence":{"type":"integer","minimum":0.0,"title":"Last Sequence"},"ops_last_read_sequence":{"type":"integer","minimum":0.0,"title":"Ops Last Read Sequence"},"customer_last_read_sequence":{"type":"integer","minimum":0.0,"title":"Customer Last Read Sequence"},"last_message_at":{"type":"string","format":"date-time","title":"Last Message At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"ops_unread":{"type":"boolean","title":"Ops Unread"},"customer_unread":{"type":"boolean","title":"Customer Unread"},"latest_message_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Message Preview"},"latest_sender_type":{"anyOf":[{"type":"string","enum":["customer","admin"]},{"type":"null"}],"title":"Latest Sender Type"}},"type":"object","required":["conversation_id","region","tenant_id","user_id","user_status","display_identity","last_sequence","ops_last_read_sequence","customer_last_read_sequence","last_message_at","created_at","updated_at","ops_unread","customer_unread","latest_message_preview","latest_sender_type"],"title":"FeedbackConversationResponse"},"FeedbackMessageResponse":{"properties":{"message_id":{"type":"string","title":"Message Id"},"conversation_id":{"type":"string","title":"Conversation Id"},"sequence":{"type":"integer","exclusiveMinimum":0.0,"title":"Sequence"},"sender_type":{"type":"string","enum":["customer","admin"],"title":"Sender Type"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"screenshot":{"anyOf":[{"$ref":"#/components/schemas/FeedbackScreenshotResponse"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["message_id","conversation_id","sequence","sender_type","body","screenshot","created_at"],"title":"FeedbackMessageResponse"},"FeedbackReadRequest":{"properties":{"sequence":{"type":"integer","minimum":0.0,"title":"Sequence"}},"type":"object","required":["sequence"],"title":"FeedbackReadRequest"},"FeedbackReadResponse":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"},"read_sequence":{"type":"integer","minimum":0.0,"title":"Read Sequence"},"unread":{"type":"boolean","title":"Unread"}},"type":"object","required":["conversation_id","read_sequence","unread"],"title":"FeedbackReadResponse"},"FeedbackScreenshotResponse":{"properties":{"mime_type":{"type":"string","enum":["image/png","image/jpeg","image/webp"],"title":"Mime Type"},"size_bytes":{"type":"integer","maximum":10485760.0,"minimum":1.0,"title":"Size Bytes"},"width":{"type":"integer","exclusiveMinimum":0.0,"title":"Width"},"height":{"type":"integer","exclusiveMinimum":0.0,"title":"Height"}},"type":"object","required":["mime_type","size_bytes","width","height"],"title":"FeedbackScreenshotResponse"},"FeedbackThreadResponse":{"properties":{"conversation":{"anyOf":[{"$ref":"#/components/schemas/FeedbackConversationResponse"},{"type":"null"}]},"messages":{"items":{"$ref":"#/components/schemas/FeedbackMessageResponse"},"type":"array","title":"Messages"},"has_unread_reply":{"type":"boolean","title":"Has Unread Reply"}},"type":"object","required":["conversation","messages","has_unread_reply"],"title":"FeedbackThreadResponse"},"FileContentPart":{"properties":{"type":{"type":"string","const":"file","title":"Type"},"file":{"$ref":"#/components/schemas/FileData"}},"type":"object","required":["type","file"],"title":"FileContentPart"},"FileData":{"properties":{"file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Id"},"file_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Data"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"}},"type":"object","title":"FileData"},"FramesToVideoRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","minimax-h3","wan3.0-video","wan3.0-video-prime","wan2.7-i2v","seedance-2","seedance-2-fast","seedance-2-mini","seedance-2.5"],"title":"Model","description":"Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"negative_prompt":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Negative Prompt","description":"Content or qualities to avoid when supported by the selected model."},"duration":{"anyOf":[{"type":"integer"},{"type":"string","const":"auto"},{"type":"null"}],"title":"Duration","description":"Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default."},"aspect_ratio":{"anyOf":[{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","21:9","9:21","adaptive"]},{"type":"null"}],"title":"Aspect Ratio","description":"Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior."},"resolution":{"anyOf":[{"type":"string","enum":["480p","720p","1080p","2k","4k"]},{"type":"null"}],"title":"Resolution","description":"Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written."},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark","description":"Whether generated video should include the model watermark."},"generate_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Audio","description":"Whether the selected model should generate synchronized audio."},"web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Web Search","description":"Whether the selected model may use web search during generation."},"return_last_frame":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return Last Frame","description":"Whether to return the generated video's last frame as an image artifact."},"output_format":{"anyOf":[{"type":"string","enum":["mp4","mov"]},{"type":"null"}],"title":"Output Format","description":"Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding."},"prompt":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"Prompt","description":"Optional instructions for the motion ending at the required last frame."},"first_frame":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},{"type":"null"}],"title":"First Frame","description":"Optional image that must be the video's first frame. Omit it for a last-frame-only request when the selected model advertises that input combination."},"last_frame":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"title":"Last Frame","description":"Required image that must be the video's last frame.","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},"driving_audio":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},{"type":"null"}],"title":"Driving Audio","description":"Optional driving audio. Supplying it requires a model that supports this control."}},"additionalProperties":false,"type":"object","required":["last_frame"],"title":"FramesToVideoRequest"},"FreeVideoOfferResponse":{"properties":{"status":{"type":"string","title":"Status"},"capability":{"type":"string","title":"Capability"},"model":{"type":"string","title":"Model"},"resolution":{"type":"string","title":"Resolution"},"duration_seconds":{"type":"integer","title":"Duration Seconds"},"consumed_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consumed Task Id"},"consumed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Consumed At"}},"type":"object","required":["status","capability","model","resolution","duration_seconds"],"title":"FreeVideoOfferResponse","description":"The free-first-video offer as the console renders it.\n\n`status` is `available | granted | holding | consumed`. Only `available` is\nderived — a tenant with no row reads as available; everything else is stored.\n0013 removed the redemption window, so a claim no longer expires.\n\nThe locked scope is echoed back on every response so the page states what\nis being given in the same words the redemption path will enforce.\n`consumed_task_id` and `consumed_at` are the receipt: which video this\nturned into, and when."},"FunctionDefinition":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters","description":"JSON Schema"},"strict":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Strict"}},"type":"object","required":["name"],"title":"FunctionDefinition"},"GroupBy":{"type":"string","enum":["capability_model","capability","model"],"title":"GroupBy"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ImageAspectRange":{"properties":{"minimum":{"type":"string","title":"Minimum"},"maximum":{"type":"string","title":"Maximum"}},"additionalProperties":false,"type":"object","required":["minimum","maximum"],"title":"ImageAspectRange"},"ImageAutoSelectionCard":{"properties":{"default_model":{"type":"string","const":"auto","title":"Default Model","default":"auto"},"basic_request_preference":{"type":"string","title":"Basic Request Preference"},"request_dependent":{"type":"boolean","const":true,"title":"Request Dependent","default":true},"persisted_selection_field":{"type":"string","const":"resolved_model","title":"Persisted Selection Field","default":"resolved_model"},"description":{"type":"string","title":"Description"}},"additionalProperties":false,"type":"object","required":["basic_request_preference","description"],"title":"ImageAutoSelectionCard"},"ImageCanvasCard":{"properties":{"default":{"additionalProperties":{"type":"string"},"type":"object","title":"Default"},"preset_tiers":{"items":{"type":"string","enum":["1K","2K","4K"]},"type":"array","title":"Preset Tiers"},"target":{"$ref":"#/components/schemas/ImageTargetCanvasCard"},"source_aspect_anchor":{"type":"string","enum":["none","first_input","last_input"],"title":"Source Aspect Anchor"}},"additionalProperties":false,"type":"object","required":["default","preset_tiers","target","source_aspect_anchor"],"title":"ImageCanvasCard"},"ImageControlCard":{"properties":{"field":{"type":"string","title":"Field"},"value_type":{"type":"string","enum":["string","integer","boolean","enum","canvas","image_collection","palette","region_collection"],"title":"Value Type"},"required":{"type":"boolean","title":"Required"},"nullable":{"type":"boolean","title":"Nullable"},"default":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"},{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Default"},"model_default":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Default"},"omitted_behavior":{"type":"string","enum":["invalid","use_public_default","use_model_default","same_as_omitted","random"],"title":"Omitted Behavior"},"null_behavior":{"type":"string","enum":["invalid","same_as_omitted","use_model_default"],"title":"Null Behavior"},"allowed_values":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Values"},"minimum":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Minimum"},"maximum":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Maximum"},"min_items":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Items"},"max_items":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Items"},"max_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Length"}},"additionalProperties":false,"type":"object","required":["field","value_type","required","nullable","default","omitted_behavior","null_behavior"],"title":"ImageControlCard","description":"One public request field and its stable omission/null semantics."},"ImageEditPresetCanvas":{"properties":{"type":{"type":"string","const":"preset","title":"Type"},"tier":{"$ref":"#/components/schemas/ImageResolution"},"aspect":{"anyOf":[{"type":"string","pattern":"^(?:source|[1-9][0-9]{0,5}:[1-9][0-9]{0,5})(?![\\s\\S])"},{"type":"null"}],"title":"Aspect","description":"Positive width:height ratio with integer components from 1 to 999999, or `source` to inherit the first input image's ratio. Positive ratios are normalized by greatest common divisor.","default":"source","x-beatra-runtime-normalization":{"appliesTo":"concrete-positive-width:height","id":"aspect-ratio-gcd","operation":"divide-width-and-height-by-greatest-common-divisor","result":"reduced-width:height","sourceBehavior":"pass-through"}}},"additionalProperties":false,"type":"object","required":["type","tier"],"title":"ImageEditPresetCanvas","description":"Edit canvas whose ratio may be inherited from the first input image."},"ImageEditRegion":{"properties":{"image_index":{"type":"integer","minimum":0.0,"title":"Image Index"},"x":{"type":"number","exclusiveMaximum":1.0,"minimum":0.0,"title":"X","x-beatra-runtime-constraints":[{"expression":"decode(encode(value)) == value","id":"exact-json-number-round-trip"}]},"y":{"type":"number","exclusiveMaximum":1.0,"minimum":0.0,"title":"Y","x-beatra-runtime-constraints":[{"expression":"decode(encode(value)) == value","id":"exact-json-number-round-trip"}]},"width":{"type":"number","maximum":1.0,"exclusiveMinimum":0.0,"title":"Width","x-beatra-runtime-constraints":[{"expression":"decode(encode(value)) == value","id":"exact-json-number-round-trip"}]},"height":{"type":"number","maximum":1.0,"exclusiveMinimum":0.0,"title":"Height","x-beatra-runtime-constraints":[{"expression":"decode(encode(value)) == value","id":"exact-json-number-round-trip"}]}},"additionalProperties":false,"type":"object","required":["image_index","x","y","width","height"],"title":"ImageEditRegion","description":"Normalized rectangle associated with one ordered input image."},"ImageEditRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","gpt-image-2.5-flare","gpt-image-2.5-sunburst","gpt-image-2","image-01-live","wan2.7-image-pro","wan2.7-image","qwen-image-3.0-pro","qwen-image-3.0","qwen-image-2.0-pro","qwen-image-2.0"],"title":"Model","description":"Use auto for compatibility-based selection from the configured live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"prompt":{"type":"string","minLength":1,"pattern":"\\S","title":"Prompt","description":"Required prompt containing at least one non-whitespace character."},"count":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Count","description":"Requested output image count. The public range is one through four, and the selected model must support the exact count; Beatra does not split the request.","default":1},"canvas":{"oneOf":[{"$ref":"#/components/schemas/ImageEditPresetCanvas"},{"$ref":"#/components/schemas/ImageTargetCanvas"}],"title":"Canvas","description":"Desired output canvas. The default is a 2K tier derived from the first base image's ratio; actual output dimensions remain authoritative.","default":{"type":"preset","tier":"2K","aspect":"source"},"discriminator":{"propertyName":"type","mapping":{"preset":"#/components/schemas/ImageEditPresetCanvas","target":"#/components/schemas/ImageTargetCanvas"}}},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed","description":"Optional random seed. Supplying it constrains model eligibility; omit it for model-managed randomness."},"negative_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Negative Prompt","description":"Optional content or qualities to avoid. Supplying it constrains model eligibility and is rejected when no compatible model is available."},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written; an explicit boolean constrains model eligibility."},"palette":{"anyOf":[{"items":{"$ref":"#/components/schemas/ImagePaletteColor"},"type":"array","maxItems":10,"minItems":3},{"type":"null"}],"title":"Palette","description":"Three to ten weighted RGB colors. Runtime validation requires the weights to sum exactly to 1.0000.","x-beatra-runtime-relations":[{"expression":"sum(palette[*].weight) == 1.0000","id":"palette-weight-sum"}]},"images":{"items":{"oneOf":[{"$ref":"#/components/schemas/ImageMediaInputUrl"},{"$ref":"#/components/schemas/ImageMediaInputArtifact"},{"$ref":"#/components/schemas/ImageMediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/ImageMediaInputArtifact","data_uri":"#/components/schemas/ImageMediaInputDataUri","url":"#/components/schemas/ImageMediaInputUrl"}}},"type":"array","maxItems":4,"minItems":1,"title":"Images","description":"Ordered inputs; images[0] is the base and later entries are references."},"edit_regions":{"anyOf":[{"items":{"$ref":"#/components/schemas/ImageEditRegion"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Edit Regions","description":"Flat normalized rectangles keyed by an input image_index. Runtime validation enforces cross-coordinate and collection relations.","x-beatra-runtime-relations":[{"expression":"x + width <= 1 and y + height <= 1","id":"region-within-canvas"},{"expression":"0 <= image_index < len(images)","id":"region-image-index"},{"expression":"count(edit_regions where image_index == i) <= 2 for each i","id":"region-per-image-limit"},{"expression":"unique(image_index, x, y, width, height)","id":"region-unique-geometry"}]}},"additionalProperties":false,"type":"object","required":["prompt","images"],"title":"ImageEditRequest","description":"Edit a base image with optional ordered references and normalized regions."},"ImageInputHardConstraints":{"properties":{"max_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Bytes"},"edge_pixels":{"anyOf":[{"$ref":"#/components/schemas/ImageIntegerRange"},{"type":"null"}]},"aspect_ratio":{"anyOf":[{"$ref":"#/components/schemas/ImageAspectRange"},{"type":"null"}]},"alpha":{"type":"string","enum":["allowed","reject_png_alpha"],"title":"Alpha"}},"additionalProperties":false,"type":"object","required":["max_bytes","edge_pixels","aspect_ratio","alpha"],"title":"ImageInputHardConstraints"},"ImageInputRecommendations":{"properties":{"edge_pixels":{"anyOf":[{"$ref":"#/components/schemas/ImageIntegerRange"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["edge_pixels"],"title":"ImageInputRecommendations"},"ImageInputTransportCard":{"properties":{"accepted_kinds":{"items":{"type":"string","enum":["artifact","data_uri","https_url"]},"type":"array","title":"Accepted Kinds"},"https_only":{"type":"boolean","title":"Https Only"},"data_uri_max_encoded_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Data Uri Max Encoded Length"}},"additionalProperties":false,"type":"object","required":["accepted_kinds","https_only","data_uri_max_encoded_length"],"title":"ImageInputTransportCard"},"ImageInputsCard":{"properties":{"minimum_count":{"type":"integer","minimum":0.0,"title":"Minimum Count"},"public_max_count":{"type":"integer","maximum":4.0,"minimum":0.0,"title":"Public Max Count"},"native_max_count":{"type":"integer","minimum":0.0,"title":"Native Max Count"},"formats":{"items":{"type":"string"},"type":"array","title":"Formats"},"hard_constraints":{"$ref":"#/components/schemas/ImageInputHardConstraints"},"recommendations":{"$ref":"#/components/schemas/ImageInputRecommendations"},"animation":{"additionalProperties":{"type":"string","enum":["as_provided","first_frame"]},"type":"object","title":"Animation"},"transport":{"$ref":"#/components/schemas/ImageInputTransportCard"},"ordering":{"type":"string","enum":["none","ordered_references","first_is_base_remaining_are_references"],"title":"Ordering"},"source_aspect_anchor":{"type":"string","enum":["none","first_input","last_input"],"title":"Source Aspect Anchor"}},"additionalProperties":false,"type":"object","required":["minimum_count","public_max_count","native_max_count","formats","hard_constraints","recommendations","animation","transport","ordering","source_aspect_anchor"],"title":"ImageInputsCard"},"ImageIntegerRange":{"properties":{"minimum":{"type":"integer","title":"Minimum"},"maximum":{"type":"integer","title":"Maximum"}},"additionalProperties":false,"type":"object","required":["minimum","maximum"],"title":"ImageIntegerRange"},"ImageInterfaceCard":{"properties":{"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"capability":{"type":"string","enum":["text_to_image","image_to_image","image_edit"],"title":"Capability"},"status":{"type":"string","const":"available","title":"Status","default":"available"},"controls":{"items":{"$ref":"#/components/schemas/ImageControlCard"},"type":"array","title":"Controls"},"prompt":{"$ref":"#/components/schemas/ImagePromptCard"},"inputs":{"$ref":"#/components/schemas/ImageInputsCard"},"outputs":{"$ref":"#/components/schemas/ImageOutputsCard"},"canvas":{"$ref":"#/components/schemas/ImageCanvasCard"},"rules":{"items":{"$ref":"#/components/schemas/ImageInterfaceRule"},"type":"array","title":"Rules"},"pricing":{"$ref":"#/components/schemas/ImagePricingCard"},"auto":{"$ref":"#/components/schemas/ImageAutoSelectionCard"}},"additionalProperties":false,"type":"object","required":["model","display_name","capability","controls","prompt","inputs","outputs","canvas","rules","pricing","auto"],"title":"ImageInterfaceCard","description":"Canonical image discovery record shared by REST, MCP and Console."},"ImageInterfaceRule":{"properties":{"id":{"type":"string","title":"Id"},"when":{"items":{"$ref":"#/components/schemas/ImageRulePredicate"},"type":"array","title":"When"},"effect":{"$ref":"#/components/schemas/ImageRuleEffect"}},"additionalProperties":false,"type":"object","required":["id","when","effect"],"title":"ImageInterfaceRule"},"ImageItem":{"properties":{"artifact_id":{"type":"string","title":"Artifact Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"mime_type":{"type":"string","title":"Mime Type"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"type":"object","required":["artifact_id","url","mime_type","width","height"],"title":"ImageItem"},"ImageMediaInputArtifact":{"properties":{"type":{"type":"string","const":"artifact","title":"Type"},"artifact_id":{"type":"string","title":"Artifact Id"}},"additionalProperties":false,"type":"object","required":["type","artifact_id"],"title":"ImageMediaInputArtifact","description":"Closed reference to a Beatra artifact."},"ImageMediaInputDataUri":{"properties":{"type":{"type":"string","const":"data_uri","title":"Type"},"data":{"type":"string","maxLength":262144,"title":"Data","description":"Data URI with a 256 KiB encoded inline transport cap. This is not the model image-byte limit; use an artifact or public HTTPS URL for larger inputs."}},"additionalProperties":false,"type":"object","required":["type","data"],"title":"ImageMediaInputDataUri","description":"Closed inline image reference accepted by Beatra."},"ImageMediaInputUrl":{"properties":{"type":{"type":"string","const":"url","title":"Type"},"url":{"type":"string","pattern":"^[Hh][Tt][Tt][Pp][Ss]://(?:(?=[A-Za-z0-9.-]{1,253}\\.?(?=[:/?#]|$))(?=[A-Za-z0-9.-]*[A-Za-z])[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)*\\.?|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])|\\[(?:(?:[0-9A-Fa-f]{1,4}:){6}(?:[0-9A-Fa-f]{1,4}:[0-9A-Fa-f]{1,4}|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9]))|::(?:[0-9A-Fa-f]{1,4}:){5}(?:[0-9A-Fa-f]{1,4}:[0-9A-Fa-f]{1,4}|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9]))|(?:[0-9A-Fa-f]{1,4})?::(?:[0-9A-Fa-f]{1,4}:){4}(?:[0-9A-Fa-f]{1,4}:[0-9A-Fa-f]{1,4}|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9]))|(?:(?:[0-9A-Fa-f]{1,4}:){0,1}[0-9A-Fa-f]{1,4})?::(?:[0-9A-Fa-f]{1,4}:){3}(?:[0-9A-Fa-f]{1,4}:[0-9A-Fa-f]{1,4}|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9]))|(?:(?:[0-9A-Fa-f]{1,4}:){0,2}[0-9A-Fa-f]{1,4})?::(?:[0-9A-Fa-f]{1,4}:){2}(?:[0-9A-Fa-f]{1,4}:[0-9A-Fa-f]{1,4}|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9]))|(?:(?:[0-9A-Fa-f]{1,4}:){0,3}[0-9A-Fa-f]{1,4})?::[0-9A-Fa-f]{1,4}:(?:[0-9A-Fa-f]{1,4}:[0-9A-Fa-f]{1,4}|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9]))|(?:(?:[0-9A-Fa-f]{1,4}:){0,4}[0-9A-Fa-f]{1,4})?::(?:[0-9A-Fa-f]{1,4}:[0-9A-Fa-f]{1,4}|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9]))|(?:(?:[0-9A-Fa-f]{1,4}:){0,5}[0-9A-Fa-f]{1,4})?::[0-9A-Fa-f]{1,4}|(?:(?:[0-9A-Fa-f]{1,4}:){0,6}[0-9A-Fa-f]{1,4})?::)\\])(?::0*(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?(?:[/?#][^\\s]*)?(?![\\s\\S])","title":"Url","description":"Public HTTPS image URL with a non-empty host."}},"additionalProperties":false,"type":"object","required":["type","url"],"title":"ImageMediaInputUrl","description":"Closed HTTPS image reference accepted by Beatra."},"ImageOutputRelationship":{"type":"string","enum":["independent","sequence"],"title":"ImageOutputRelationship"},"ImageOutputsCard":{"properties":{"public_max_count":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Public Max Count"},"native_max_independent_count":{"type":"integer","minimum":1.0,"title":"Native Max Independent Count"},"native_max_sequence_count":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Native Max Sequence Count"},"relationships":{"items":{"type":"string","enum":["independent","sequence"]},"type":"array","title":"Relationships"},"format":{"type":"string","const":"image/png","title":"Format","default":"image/png"}},"additionalProperties":false,"type":"object","required":["public_max_count","native_max_independent_count","relationships"],"title":"ImageOutputsCard"},"ImagePaletteColor":{"properties":{"color":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}(?![\\s\\S])","title":"Color"},"weight":{"anyOf":[{"type":"number","maximum":1.0,"exclusiveMinimum":0.0},{"type":"string","pattern":"^\\+?(?:0*\\.(?=[0-9]{0,3}[1-9])[0-9]{1,4}|0*1(?:\\.0{0,4})?)(?![\\s\\S])"}],"title":"Weight","description":"Exact decimal weight greater than 0 and at most 1, with no more than 4 fractional digits. Decimal strings avoid binary-float ambiguity.","x-beatra-decimal-precision":{"maximumFractionalDigits":4,"numberEnforcement":"runtime","stringEnforcement":"schema-and-runtime"},"x-beatra-maximum-fractional-digits":4}},"additionalProperties":false,"type":"object","required":["color","weight"],"title":"ImagePaletteColor","description":"One exact weighted RGB color in a requested palette."},"ImagePresetCanvas":{"properties":{"type":{"type":"string","const":"preset","title":"Type"},"tier":{"$ref":"#/components/schemas/ImageResolution"},"aspect":{"anyOf":[{"type":"string","pattern":"^[1-9][0-9]{0,5}:[1-9][0-9]{0,5}(?![\\s\\S])"},{"type":"null"}],"title":"Aspect","description":"Positive width:height ratio whose components are integers from 1 to 999999, normalized by greatest common divisor. A tier describes quality, not exact pixels.","default":"16:9","x-beatra-runtime-normalization":{"appliesTo":"concrete-positive-width:height","id":"aspect-ratio-gcd","operation":"divide-width-and-height-by-greatest-common-divisor","result":"reduced-width:height"}}},"additionalProperties":false,"type":"object","required":["type","tier"],"title":"ImagePresetCanvas","description":"Named canvas tier with an optional positive aspect ratio."},"ImagePriceOptionCard":{"properties":{"dimensions":{"additionalProperties":{"type":"string"},"type":"object","title":"Dimensions"},"unit_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unit Credits"}},"additionalProperties":false,"type":"object","required":["dimensions","unit_credits"],"title":"ImagePriceOptionCard"},"ImagePricingCard":{"properties":{"meter":{"type":"string","const":"image_count","title":"Meter","default":"image_count"},"unit":{"type":"string","const":"image","title":"Unit","default":"image"},"billing_basis":{"type":"string","const":"successful_image_count","title":"Billing Basis","default":"successful_image_count"},"estimate_formula":{"type":"string","const":"unit_credits * successful_image_count","title":"Estimate Formula","default":"unit_credits * successful_image_count"},"options":{"items":{"$ref":"#/components/schemas/ImagePriceOptionCard"},"type":"array","minItems":1,"title":"Options"}},"additionalProperties":false,"type":"object","required":["options"],"title":"ImagePricingCard"},"ImagePromptCard":{"properties":{"limit":{"type":"integer","exclusiveMinimum":0.0,"title":"Limit"},"unit":{"type":"string","enum":["characters","qwen_tokens"],"title":"Unit"},"overflow":{"type":"string","const":"reject","title":"Overflow","default":"reject"},"languages":{"items":{"type":"string","enum":["en","zh"]},"type":"array","title":"Languages"},"counter":{"type":"string","enum":["unicode_characters","qwen_open_family_proxy"],"title":"Counter"},"counter_is_exact":{"type":"boolean","title":"Counter Is Exact"},"counter_unavailable_behavior":{"type":"string","const":"reject","title":"Counter Unavailable Behavior","default":"reject"}},"additionalProperties":false,"type":"object","required":["limit","unit","languages","counter","counter_is_exact"],"title":"ImagePromptCard"},"ImageResolution":{"type":"string","enum":["1K","2K","4K"],"title":"ImageResolution","description":"Named quality tier, not a promise of exact encoded dimensions."},"ImageRuleEffect":{"properties":{"type":{"type":"string","enum":["allow","forbid","limit","require"],"title":"Type"},"field":{"type":"string","title":"Field"},"value":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Value"}},"additionalProperties":false,"type":"object","required":["type","field"],"title":"ImageRuleEffect"},"ImageRulePredicate":{"properties":{"field":{"type":"string","title":"Field"},"operator":{"type":"string","enum":["equals","present","greater_than"],"title":"Operator"},"value":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Value"}},"additionalProperties":false,"type":"object","required":["field","operator"],"title":"ImageRulePredicate"},"ImageTargetCanvas":{"properties":{"type":{"type":"string","const":"target","title":"Type"},"width":{"type":"integer","maximum":999999.0,"exclusiveMinimum":0.0,"title":"Width","description":"Desired output width in pixels"},"height":{"type":"integer","maximum":999999.0,"exclusiveMinimum":0.0,"title":"Height","description":"Desired output height in pixels"}},"additionalProperties":false,"type":"object","required":["type","width","height"],"title":"ImageTargetCanvas","description":"Desired pixel target; the selected implementation may normalize actual output."},"ImageTargetCanvasCard":{"properties":{"supported":{"type":"boolean","title":"Supported"},"minimum_total_pixels":{"type":"integer","title":"Minimum Total Pixels"},"maximum_total_pixels":{"type":"integer","title":"Maximum Total Pixels"},"minimum_aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Minimum Aspect Ratio"},"maximum_aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Maximum Aspect Ratio"},"normalization_multiple":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Normalization Multiple"},"actual_dimensions_may_differ":{"type":"boolean","title":"Actual Dimensions May Differ"}},"additionalProperties":false,"type":"object","required":["supported","minimum_total_pixels","maximum_total_pixels","minimum_aspect_ratio","maximum_aspect_ratio","normalization_multiple","actual_dimensions_may_differ"],"title":"ImageTargetCanvasCard"},"ImageToImageRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","gpt-image-2.5-flare","gpt-image-2.5-sunburst","gpt-image-2","image-01-live","wan2.7-image-pro","wan2.7-image","qwen-image-3.0-pro","qwen-image-3.0","qwen-image-2.0-pro","qwen-image-2.0"],"title":"Model","description":"Use auto for compatibility-based selection from the configured live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"prompt":{"type":"string","minLength":1,"pattern":"\\S","title":"Prompt","description":"Required prompt containing at least one non-whitespace character."},"count":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Count","description":"Requested output image count. The public range is one through four, and the selected model must support the exact count; Beatra does not split the request.","default":1},"canvas":{"oneOf":[{"$ref":"#/components/schemas/ImageTransformPresetCanvas"},{"$ref":"#/components/schemas/ImageTargetCanvas"}],"title":"Canvas","description":"Desired output canvas. Preset `source` inherits the last input image's ratio; the omitted default is 2K at 16:9.","default":{"type":"preset","tier":"2K","aspect":"16:9"},"discriminator":{"propertyName":"type","mapping":{"preset":"#/components/schemas/ImageTransformPresetCanvas","target":"#/components/schemas/ImageTargetCanvas"}}},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed","description":"Optional random seed. Supplying it constrains model eligibility; omit it for model-managed randomness."},"negative_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Negative Prompt","description":"Optional content or qualities to avoid. Supplying it constrains model eligibility and is rejected when no compatible model is available."},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written; an explicit boolean constrains model eligibility."},"palette":{"anyOf":[{"items":{"$ref":"#/components/schemas/ImagePaletteColor"},"type":"array","maxItems":10,"minItems":3},{"type":"null"}],"title":"Palette","description":"Three to ten weighted RGB colors. Runtime validation requires the weights to sum exactly to 1.0000.","x-beatra-runtime-relations":[{"expression":"sum(palette[*].weight) == 1.0000","id":"palette-weight-sum"}]},"images":{"items":{"oneOf":[{"$ref":"#/components/schemas/ImageMediaInputUrl"},{"$ref":"#/components/schemas/ImageMediaInputArtifact"},{"$ref":"#/components/schemas/ImageMediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/ImageMediaInputArtifact","data_uri":"#/components/schemas/ImageMediaInputDataUri","url":"#/components/schemas/ImageMediaInputUrl"}}},"type":"array","maxItems":4,"minItems":1,"title":"Images","description":"Ordered artifact, HTTPS URL, or data URI references."},"output_relationship":{"$ref":"#/components/schemas/ImageOutputRelationship","description":"Use independent for unrelated results, or sequence for a related image set. An explicit value constrains model eligibility and is rejected when unsupported.","default":"independent"}},"additionalProperties":false,"type":"object","required":["prompt","images"],"title":"ImageToImageRequest","description":"Transform one to four ordered image references with a prompt."},"ImageToTextRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","title":"Model"},"prompt":{"type":"string","maxLength":4000,"title":"Prompt"},"images":{"items":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/ImageUnderstandingDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/ImageUnderstandingDataUri","url":"#/components/schemas/MediaInputUrl"}}},"type":"array","maxItems":8,"minItems":1,"title":"Images","description":"One through eight ordered image inputs. Each admitted image is billed once."},"detail":{"type":"string","enum":["default","low","high"],"title":"Detail","description":"Visual detail preference. It does not change Beatra's per-image price.","default":"default"},"response_format":{"anyOf":[{"type":"string","enum":["text","json"]},{"type":"null"}],"title":"Response Format"},"temperature":{"anyOf":[{"type":"number","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Temperature"}},"additionalProperties":false,"type":"object","required":["model","prompt","images"],"title":"ImageToTextRequest","description":"Vision Q&A or captioning; unrelated to the image creation contract."},"ImageToVideoRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","minimax-h3","wan3.0-video","wan3.0-video-prime","happyhorse-1.1-i2v","wan2.7-i2v","seedance-2","seedance-2-fast","seedance-2-mini","seedance-2.5"],"title":"Model","description":"Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"negative_prompt":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Negative Prompt","description":"Content or qualities to avoid when supported by the selected model."},"duration":{"anyOf":[{"type":"integer"},{"type":"string","const":"auto"},{"type":"null"}],"title":"Duration","description":"Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default."},"aspect_ratio":{"anyOf":[{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","21:9","9:21","adaptive"]},{"type":"null"}],"title":"Aspect Ratio","description":"Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior."},"resolution":{"anyOf":[{"type":"string","enum":["480p","720p","1080p","2k","4k"]},{"type":"null"}],"title":"Resolution","description":"Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written."},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark","description":"Whether generated video should include the model watermark."},"generate_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Audio","description":"Whether the selected model should generate synchronized audio."},"web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Web Search","description":"Whether the selected model may use web search during generation."},"return_last_frame":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return Last Frame","description":"Whether to return the generated video's last frame as an image artifact."},"output_format":{"anyOf":[{"type":"string","enum":["mp4","mov"]},{"type":"null"}],"title":"Output Format","description":"Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding."},"prompt":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"Prompt","description":"Optional motion, scene, and camera instructions for animating the opening image."},"image":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"title":"Image","description":"Required strict first-frame image; this is not a loose visual reference.","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},"driving_audio":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},{"type":"null"}],"title":"Driving Audio","description":"Optional driving audio. Supplying it requires a model that supports this control."}},"additionalProperties":false,"type":"object","required":["image"],"title":"ImageToVideoRequest"},"ImageTransformPresetCanvas":{"properties":{"type":{"type":"string","const":"preset","title":"Type"},"tier":{"$ref":"#/components/schemas/ImageResolution"},"aspect":{"anyOf":[{"type":"string","pattern":"^(?:source|[1-9][0-9]{0,5}:[1-9][0-9]{0,5})(?![\\s\\S])"},{"type":"null"}],"title":"Aspect","description":"Positive width:height ratio with integer components from 1 to 999999, or `source` to inherit the last input image's ratio. Positive ratios are normalized by greatest common divisor.","default":"16:9","x-beatra-runtime-normalization":{"appliesTo":"concrete-positive-width:height","id":"aspect-ratio-gcd","operation":"divide-width-and-height-by-greatest-common-divisor","result":"reduced-width:height","sourceBehavior":"pass-through"}}},"additionalProperties":false,"type":"object","required":["type","tier"],"title":"ImageTransformPresetCanvas","description":"Transform canvas whose ratio may be inherited from the last input image."},"ImageUnderstandingDataUri":{"properties":{"type":{"type":"string","const":"data_uri","title":"Type"},"data":{"type":"string","maxLength":13981144,"title":"Data","description":"Base64 data URI. Decoded image content is limited to 10 MiB."}},"type":"object","required":["type","data"],"title":"ImageUnderstandingDataUri"},"ImageUrlContentPart":{"properties":{"type":{"type":"string","const":"image_url","title":"Type"},"image_url":{"$ref":"#/components/schemas/ImageUrlData"}},"type":"object","required":["type","image_url"],"title":"ImageUrlContentPart"},"ImageUrlData":{"properties":{"url":{"type":"string","title":"Url"},"detail":{"anyOf":[{"type":"string","enum":["auto","low","default","high"]},{"type":"null"}],"title":"Detail","default":"auto"},"max_long_side_pixel":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Long Side Pixel"}},"type":"object","required":["url"],"title":"ImageUrlData"},"InputAudioContentPart":{"properties":{"type":{"type":"string","const":"input_audio","title":"Type"},"input_audio":{"$ref":"#/components/schemas/InputAudioData"}},"type":"object","required":["type","input_audio"],"title":"InputAudioContentPart"},"InputAudioData":{"properties":{"data":{"type":"string","title":"Data","description":"base64-encoded audio bytes"},"format":{"type":"string","enum":["wav","mp3"],"title":"Format"}},"type":"object","required":["data","format"],"title":"InputAudioData"},"InvoiceRequestCreate":{"properties":{"payment_order_ids":{"items":{"type":"string"},"type":"array","title":"Payment Order Ids"},"title_name":{"type":"string","maxLength":255,"title":"Title Name"},"tax_id":{"type":"string","maxLength":32,"title":"Tax Id"},"recipient_email":{"type":"string","maxLength":255,"title":"Recipient Email"}},"additionalProperties":false,"type":"object","required":["payment_order_ids","title_name","tax_id","recipient_email"],"title":"InvoiceRequestCreate"},"InvoiceRequestItem":{"properties":{"invoice_request_id":{"type":"string","title":"Invoice Request Id"},"status":{"type":"string","enum":["pending","issued","rejected","canceled"],"title":"Status"},"title_name":{"type":"string","title":"Title Name"},"tax_id":{"type":"string","title":"Tax Id"},"recipient_email":{"type":"string","title":"Recipient Email"},"fiat_currency":{"type":"string","title":"Fiat Currency"},"fiat_amount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Fiat Amount"},"reject_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reject Reason"},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Name"},"payment_order_ids":{"items":{"type":"string"},"type":"array","title":"Payment Order Ids"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"issued_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Issued At"},"rejected_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Rejected At"},"canceled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Canceled At"}},"type":"object","required":["invoice_request_id","status","title_name","tax_id","recipient_email","fiat_currency","fiat_amount","created_at"],"title":"InvoiceRequestItem"},"InvoiceRequestsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/InvoiceRequestItem"},"type":"array","title":"Items"}},"type":"object","title":"InvoiceRequestsResponse"},"InvoiceableOrderItem":{"properties":{"payment_order_id":{"type":"string","title":"Payment Order Id"},"provider":{"type":"string","title":"Provider"},"order_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Kind"},"purchase_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purchase Mode"},"fiat_currency":{"type":"string","title":"Fiat Currency"},"fiat_amount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Fiat Amount"},"paid_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paid At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["payment_order_id","provider","fiat_currency","fiat_amount","created_at"],"title":"InvoiceableOrderItem"},"InvoiceableOrdersResponse":{"properties":{"visible":{"type":"boolean","title":"Visible","default":false},"has_stripe_settled_history":{"type":"boolean","title":"Has Stripe Settled History","default":false},"items":{"items":{"$ref":"#/components/schemas/InvoiceableOrderItem"},"type":"array","title":"Items"}},"type":"object","title":"InvoiceableOrdersResponse"},"JsonSchemaDef":{"properties":{"name":{"type":"string","title":"Name","description":"Required by OpenAI: identifier for the schema"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"schema":{"additionalProperties":true,"type":"object","title":"Schema","description":"JSON Schema"},"strict":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Strict"}},"type":"object","required":["name","schema"],"title":"JsonSchemaDef"},"KeyListItem":{"properties":{"api_key_id":{"type":"string","title":"Api Key Id"},"name":{"type":"string","title":"Name"},"key_prefix":{"type":"string","title":"Key Prefix"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["api_key_id","name","key_prefix","status","created_at"],"title":"KeyListItem"},"KeyListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/KeyListItem"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"KeyListResponse"},"LedgerEntry":{"properties":{"ledger_id":{"type":"string","title":"Ledger Id"},"ledger_type":{"type":"string","title":"Ledger Type"},"amount_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount Credits"},"balance_after_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Balance After Credits"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"capability":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capability"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","required":["ledger_id","ledger_type","amount_credits","balance_after_credits","created_at"],"title":"LedgerEntry"},"LedgerPageResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/LedgerEntry"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"LedgerPageResponse"},"LoginIdentityResponse":{"properties":{"provider":{"type":"string","title":"Provider"},"display_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Value"}},"type":"object","required":["provider"],"title":"LoginIdentityResponse","description":"A way this account can actually be signed in to.\n\n`login_methods` above is the country policy's list of what a market\nsupports; this is what the account itself has. Settings was showing the\nformer labelled as the latter, so an account created with Google was told\nits sign-in was phone and WeChat."},"LoginMethodEnum":{"type":"string","enum":["email_otp","phone_otp","wechat_qr","wechat_browser"],"title":"LoginMethodEnum"},"LoginMethodsResponse":{"properties":{"primary":{"items":{"type":"string"},"type":"array","title":"Primary"},"other":{"items":{"type":"string"},"type":"array","title":"Other"}},"type":"object","required":["primary","other"],"title":"LoginMethodsResponse"},"LogprobToken":{"properties":{"token":{"type":"string","title":"Token"},"logprob":{"type":"number","title":"Logprob"},"bytes":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Bytes"},"top_logprobs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Top Logprobs"}},"type":"object","required":["token","logprob"],"title":"LogprobToken"},"Logprobs":{"properties":{"content":{"anyOf":[{"items":{"$ref":"#/components/schemas/LogprobToken"},"type":"array"},{"type":"null"}],"title":"Content"},"refusal":{"anyOf":[{"items":{"$ref":"#/components/schemas/LogprobToken"},"type":"array"},{"type":"null"}],"title":"Refusal"}},"type":"object","title":"Logprobs"},"MeResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"balance_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Balance Credits"}},"type":"object","required":["tenant_id","balance_credits"],"title":"MeResponse"},"MediaInputArtifact":{"properties":{"type":{"type":"string","const":"artifact","title":"Type"},"artifact_id":{"type":"string","title":"Artifact Id","description":"ULID of a previously-uploaded artifact"}},"type":"object","required":["type","artifact_id"],"title":"MediaInputArtifact"},"MediaInputDataUri":{"properties":{"type":{"type":"string","const":"data_uri","title":"Type"},"data":{"type":"string","maxLength":262144,"title":"Data","description":"Data URI (e.g. data:image/png;base64,...) — max 256KB encoded"}},"type":"object","required":["type","data"],"title":"MediaInputDataUri"},"MediaInputUrl":{"properties":{"type":{"type":"string","const":"url","title":"Type"},"url":{"type":"string","title":"Url","description":"HTTPS URL. External URLs are downloaded and re-hosted to beatra CDN."}},"type":"object","required":["type","url"],"title":"MediaInputUrl"},"MiniMaxMusicAudioSetting":{"properties":{"sample_rate":{"anyOf":[{"type":"integer","enum":[16000,24000,32000,44100]},{"type":"null"}],"title":"Sample Rate"},"bitrate":{"anyOf":[{"type":"integer","enum":[32000,64000,128000,256000]},{"type":"null"}],"title":"Bitrate"},"format":{"anyOf":[{"type":"string","const":"mp3"},{"type":"null"}],"title":"Format"}},"additionalProperties":false,"type":"object","title":"MiniMaxMusicAudioSetting"},"MiniMaxMusicOptions":{"properties":{"lyrics_optimizer":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lyrics Optimizer"},"aigc_watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Aigc Watermark"},"audio_setting":{"anyOf":[{"$ref":"#/components/schemas/MiniMaxMusicAudioSetting"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"MiniMaxMusicOptions"},"MiniappCashierResultRequest":{"properties":{"cashier_token":{"type":"string","maxLength":64,"minLength":8,"title":"Cashier Token"},"result":{"type":"string","pattern":"^(ok|cancel|fail)$","title":"Result"}},"type":"object","required":["cashier_token","result"],"title":"MiniappCashierResultRequest"},"MiniappPayCreateRequest":{"properties":{"offer_id":{"type":"string","maxLength":128,"minLength":1,"title":"Offer Id"},"idempotency_key":{"type":"string","maxLength":128,"minLength":1,"title":"Idempotency Key"}},"type":"object","required":["offer_id","idempotency_key"],"title":"MiniappPayCreateRequest"},"MiniappPaySignRequest":{"properties":{"js_code":{"type":"string","maxLength":256,"minLength":1,"title":"Js Code"},"pay_ticket":{"type":"string","maxLength":64,"minLength":8,"title":"Pay Ticket"},"platform":{"type":"string","maxLength":32,"title":"Platform","default":""}},"type":"object","required":["js_code","pay_ticket"],"title":"MiniappPaySignRequest"},"MiniappPayTicketRequest":{"properties":{"pay_ticket":{"type":"string","maxLength":64,"minLength":8,"title":"Pay Ticket"}},"type":"object","required":["pay_ticket"],"title":"MiniappPayTicketRequest"},"ModelDetail":{"properties":{"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status","default":"available"},"interfaces":{"items":{"$ref":"#/components/schemas/ImageInterfaceCard"},"type":"array","title":"Interfaces"}},"additionalProperties":false,"type":"object","required":["model","display_name","description","interfaces"],"title":"ModelDetail"},"ModelRosterCapability":{"properties":{"capability":{"type":"string","title":"Capability"},"models":{"items":{"$ref":"#/components/schemas/ModelRosterEntry"},"type":"array","title":"Models"}},"type":"object","required":["capability","models"],"title":"ModelRosterCapability"},"ModelRosterEntry":{"properties":{"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"price":{"anyOf":[{"$ref":"#/components/schemas/ModelRosterPrice"},{"type":"null"}]}},"type":"object","required":["model","display_name"],"title":"ModelRosterEntry"},"ModelRosterPrice":{"properties":{"credits":{"type":"string","title":"Credits"},"per":{"type":"string","title":"Per"},"from":{"type":"boolean","title":"From","default":false}},"type":"object","required":["credits","per"],"title":"ModelRosterPrice"},"ModelRosterResponse":{"properties":{"region":{"type":"string","title":"Region"},"capabilities":{"items":{"$ref":"#/components/schemas/ModelRosterCapability"},"type":"array","title":"Capabilities"}},"type":"object","required":["region","capabilities"],"title":"ModelRosterResponse"},"MusicAutoSelectionCard":{"properties":{"request_dependent":{"type":"boolean","const":false,"title":"Request Dependent","default":false},"default_for_omitted_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default For Omitted Request"},"candidate_order":{"items":{"type":"string"},"type":"array","title":"Candidate Order"},"persisted_selection_field":{"type":"string","const":"resolved_model","title":"Persisted Selection Field","default":"resolved_model"}},"additionalProperties":false,"type":"object","required":["default_for_omitted_request","candidate_order"],"title":"MusicAutoSelectionCard"},"MusicCapabilityDetail":{"properties":{"capability":{"type":"string","enum":["text_to_music","reference_audio_to_music"],"title":"Capability"},"endpoint":{"type":"string","title":"Endpoint"},"input_modality":{"type":"string","title":"Input Modality"},"output_modality":{"type":"string","const":"audio","title":"Output Modality","default":"audio"},"execution_mode":{"type":"string","const":"async","title":"Execution Mode","default":"async"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"auto":{"$ref":"#/components/schemas/MusicAutoSelectionCard"},"models":{"items":{"$ref":"#/components/schemas/MusicModelCard"},"type":"array","title":"Models"}},"additionalProperties":false,"type":"object","required":["capability","endpoint","input_modality","description","status","auto","models"],"title":"MusicCapabilityDetail"},"MusicConstraintsCard":{"properties":{"prompt_min_characters":{"type":"integer","minimum":1.0,"title":"Prompt Min Characters"},"prompt_max_characters":{"type":"integer","minimum":1.0,"title":"Prompt Max Characters"},"custom_prompt_max_characters":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Custom Prompt Max Characters"},"negative_tags_max_characters":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Negative Tags Max Characters","description":"Maximum characters for model_options.suno.negative_tags when that control is supported."},"lyrics_min_characters":{"type":"integer","minimum":1.0,"title":"Lyrics Min Characters"},"lyrics_max_characters":{"type":"integer","minimum":1.0,"title":"Lyrics Max Characters"},"title_max_characters":{"type":"integer","minimum":1.0,"title":"Title Max Characters"},"instrumental_forbids_lyrics":{"type":"boolean","const":true,"title":"Instrumental Forbids Lyrics","default":true},"vocal_lyrics_requirement":{"type":"string","enum":["required_or_optimizer","required_in_custom_mode","reference_audio_asr_or_supplied"],"title":"Vocal Lyrics Requirement"},"reference_audio":{"anyOf":[{"$ref":"#/components/schemas/MusicReferenceAudioConstraints"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["prompt_min_characters","prompt_max_characters","lyrics_min_characters","lyrics_max_characters","title_max_characters","vocal_lyrics_requirement"],"title":"MusicConstraintsCard"},"MusicModelCard":{"properties":{"schema_version":{"type":"string","const":"music-interface.v1","title":"Schema Version","default":"music-interface.v1"},"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"capability":{"type":"string","enum":["text_to_music","reference_audio_to_music"],"title":"Capability"},"status":{"type":"string","const":"available","title":"Status","default":"available"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls"},"constraints":{"$ref":"#/components/schemas/MusicConstraintsCard"},"output_mime_type":{"type":"string","const":"audio/mpeg","title":"Output Mime Type","default":"audio/mpeg"},"output_cardinality":{"type":"string","const":"one_or_more_clips","title":"Output Cardinality","default":"one_or_more_clips"},"pricing":{"$ref":"#/components/schemas/MusicPricingCard"}},"additionalProperties":false,"type":"object","required":["model","display_name","capability","controls","constraints","pricing"],"title":"MusicModelCard"},"MusicModelDetail":{"properties":{"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"interfaces":{"items":{"$ref":"#/components/schemas/MusicModelCard"},"type":"array","title":"Interfaces"}},"additionalProperties":false,"type":"object","required":["model","display_name","description","status","interfaces"],"title":"MusicModelDetail"},"MusicModelOptions":{"properties":{"suno":{"anyOf":[{"$ref":"#/components/schemas/SunoMusicOptions"},{"type":"null"}]},"minimax":{"anyOf":[{"$ref":"#/components/schemas/MiniMaxMusicOptions"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"MusicModelOptions","description":"Model-family scoped public options for music generation."},"MusicPricingCard":{"properties":{"unit_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unit Credits"},"unit":{"type":"string","const":"task","title":"Unit","default":"task"},"billing_basis":{"type":"string","const":"successful_task","title":"Billing Basis","default":"successful_task"}},"additionalProperties":false,"type":"object","required":["unit_credits"],"title":"MusicPricingCard"},"MusicReferenceAudioConstraints":{"properties":{"required":{"type":"boolean","const":true,"title":"Required","default":true},"minimum_seconds":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Minimum Seconds"},"maximum_seconds":{"type":"integer","minimum":1.0,"title":"Maximum Seconds"},"maximum_bytes":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Maximum Bytes"},"mime_types":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Mime Types"},"accepted_kinds":{"items":{"type":"string","enum":["artifact","data_uri","https_url"]},"type":"array","title":"Accepted Kinds"}},"additionalProperties":false,"type":"object","required":["maximum_seconds","mime_types","accepted_kinds"],"title":"MusicReferenceAudioConstraints"},"NamedFunctionChoice":{"properties":{"type":{"type":"string","const":"function","title":"Type"},"function":{"additionalProperties":{"type":"string"},"type":"object","title":"Function","description":"{name: str}"}},"type":"object","required":["type","function"],"title":"NamedFunctionChoice"},"OAuthCallbackRequest":{"properties":{"code":{"type":"string","maxLength":2048,"minLength":1,"title":"Code"},"state":{"type":"string","maxLength":512,"minLength":8,"title":"State"}},"type":"object","required":["code","state"],"title":"OAuthCallbackRequest"},"OAuthIdTokenRequest":{"properties":{"id_token":{"type":"string","maxLength":8192,"minLength":20,"title":"Id Token"},"visitor_context_token":{"anyOf":[{"type":"string","maxLength":2048,"minLength":16},{"type":"null"}],"title":"Visitor Context Token"}},"type":"object","required":["id_token"],"title":"OAuthIdTokenRequest"},"OAuthIdTokenResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"}},"type":"object","required":["tenant_id"],"title":"OAuthIdTokenResponse"},"OAuthLoginResponse":{"properties":{"token":{"type":"string","title":"Token"},"token_type":{"type":"string","const":"bearer","title":"Token Type","default":"bearer"},"tenant_id":{"type":"string","title":"Tenant Id"}},"type":"object","required":["token","tenant_id"],"title":"OAuthLoginResponse"},"OAuthStartResponse":{"properties":{"provider":{"type":"string","const":"google","title":"Provider"},"available":{"type":"boolean","title":"Available"},"fallback":{"type":"string","const":"email_code","title":"Fallback","default":"email_code"},"authorization_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization Url"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["provider","available"],"title":"OAuthStartResponse"},"OpenAIModel":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","const":"model","title":"Object","default":"model"},"created":{"type":"integer","title":"Created","description":"Unix seconds"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"}},"type":"object","required":["id","created"],"title":"OpenAIModel"},"OpenAIModelList":{"properties":{"object":{"type":"string","const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/OpenAIModel"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"OpenAIModelList"},"PaymentOrderCreateRequest":{"properties":{"offer_id":{"type":"string","maxLength":128,"minLength":1,"title":"Offer Id"},"idempotency_key":{"type":"string","maxLength":128,"minLength":1,"title":"Idempotency Key"},"checkout_channel":{"anyOf":[{"type":"string","enum":["wechat_jsapi","wechat_h5"]},{"type":"null"}],"title":"Checkout Channel"},"require_payer":{"type":"boolean","title":"Require Payer","default":false},"payer_refresh":{"type":"boolean","title":"Payer Refresh","default":false}},"additionalProperties":false,"type":"object","required":["offer_id","idempotency_key"],"title":"PaymentOrderCreateRequest"},"PaymentOrderCreateResponse":{"properties":{"mode":{"type":"string","enum":["manual_dev","mock_provider","provider_checkout"],"title":"Mode"},"message":{"type":"string","title":"Message"},"payment_order":{"$ref":"#/components/schemas/PaymentOrderItem"}},"type":"object","required":["mode","message","payment_order"],"title":"PaymentOrderCreateResponse"},"PaymentOrderItem":{"properties":{"payment_order_id":{"type":"string","title":"Payment Order Id"},"provider":{"type":"string","title":"Provider"},"payment_method_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method Id"},"status":{"type":"string","title":"Status"},"order_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Kind"},"purchase_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purchase Mode"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"},"fiat_currency":{"type":"string","title":"Fiat Currency"},"fiat_amount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Fiat Amount"},"credits_quoted":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Credits Quoted"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"country_policy_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Policy Key"},"country_policy_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Country Policy Version"},"commercial_catalog_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commercial Catalog Key"},"commercial_catalog_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Commercial Catalog Version"},"commercial_catalog_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commercial Catalog Item Id"},"product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Id"},"term_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Term Id"},"offer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offer Id"},"credits_granted":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Credits Granted"},"credits_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Credits Expires At"},"request_idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Idempotency Key"},"checkout_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkout Mode"},"fallback_register_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fallback Register Id"},"settlement_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Settlement Status"},"subscription_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Id"},"ledger_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ledger Id"},"checkout_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkout Url"},"checkout_params":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Checkout Params"},"payer_authorize_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payer Authorize Url"},"paid_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paid At"},"failed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Failed At"},"canceled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Canceled At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["payment_order_id","provider","status","fiat_currency","fiat_amount","credits_quoted","created_at","updated_at"],"title":"PaymentOrderItem"},"PaymentOrderMockCompleteResponse":{"properties":{"payment_order":{"$ref":"#/components/schemas/PaymentOrderItem"}},"type":"object","required":["payment_order"],"title":"PaymentOrderMockCompleteResponse"},"PaymentOrderPayerRequest":{"properties":{"wechat_code":{"type":"string","maxLength":256,"minLength":1,"title":"Wechat Code"},"wechat_state":{"type":"string","maxLength":256,"minLength":1,"title":"Wechat State"}},"additionalProperties":false,"type":"object","required":["wechat_code","wechat_state"],"title":"PaymentOrderPayerRequest"},"PaymentOrderPayerResponse":{"properties":{"payment_order":{"$ref":"#/components/schemas/PaymentOrderItem"}},"type":"object","required":["payment_order"],"title":"PaymentOrderPayerResponse","description":"The parked JSAPI order after authorize, including transient checkout_params."},"PaymentOrderStatusResponse":{"properties":{"payment_order_id":{"type":"string","title":"Payment Order Id"},"status":{"type":"string","title":"Status"},"settlement_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Settlement Status"},"checkout_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkout Mode"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"paid_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paid At"},"settled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Settled At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["payment_order_id","status","updated_at"],"title":"PaymentOrderStatusResponse"},"PaymentOrdersResponse":{"properties":{"self_serve_available":{"type":"boolean","title":"Self Serve Available","default":false},"mode":{"type":"string","enum":["manual_top_up","manual_dev","mock_provider","provider_unavailable","self_serve_payment"],"title":"Mode","default":"manual_top_up"},"message":{"type":"string","title":"Message"},"items":{"items":{"$ref":"#/components/schemas/PaymentOrderItem"},"type":"array","title":"Items"}},"type":"object","required":["message","items"],"title":"PaymentOrdersResponse"},"PromptTokensDetails":{"properties":{"cached_tokens":{"type":"integer","title":"Cached Tokens","default":0},"audio_tokens":{"type":"integer","title":"Audio Tokens","default":0}},"type":"object","title":"PromptTokensDetails"},"ReasoningConfig":{"properties":{"effort":{"anyOf":[{"type":"string","enum":["minimal","low","medium","high","max"]},{"type":"null"}],"title":"Effort"},"mode":{"anyOf":[{"type":"string","enum":["fixed","adaptive"]},{"type":"null"}],"title":"Mode"},"expose_trace":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Expose Trace","description":"Return the reasoning trace separately (maps to MiniMax reasoning_split)."}},"additionalProperties":false,"type":"object","title":"ReasoningConfig","description":"Model-agnostic reasoning controls.\n\nThe object form of the `reasoning` field. The bare booleans are sugar:\n`reasoning: true` == `{}` (on at the model default), `reasoning: false`\n== reasoning off. Engine-specific wire differences (DeepSeek `enabled`,\nMiniMax `adaptive`, NVIDIA `chat_template_kwargs`) are translated\nserver-side."},"ReferenceAudioToMusicRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; limited by task creation policy."},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","minimax-music-3.0","suno-6"],"title":"Model"},"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt","description":"Style, mood, genre, and instrumentation. When lyrics are supplied (or Suno custom mode is on) this maps to the provider's style-conditioning field; otherwise it is the song description the model writes the song from. Either way it is not an instruction field: execution directives written here (for example \"do not omit anything\", \"sing it verbatim\", \"make chapter three differ from chapter one\") are not read as instructions and will not be obeyed. Put the words to be sung in `lyrics`, or set `instrumental` to true for a track with no vocals."},"lyrics":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Lyrics","description":"Optional lyrics text. Must be omitted for instrumental music."},"instrumental":{"type":"boolean","title":"Instrumental","description":"When true, generate instrumental music without vocals.","default":false},"title":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Title"},"model_options":{"anyOf":[{"$ref":"#/components/schemas/MusicModelOptions"},{"type":"null"}],"description":"Options grouped by public music model family."},"reference_audio":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"title":"Reference Audio","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}}},"additionalProperties":false,"type":"object","required":["model","prompt","reference_audio"],"title":"ReferenceAudioToMusicRequest","description":"Generate music from a prompt, optional lyrics, and reference audio."},"ReferenceToVideoRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","minimax-h3","wan3.0-video","wan3.0-video-prime","happyhorse-1.1-r2v","wan2.7-r2v","seedance-2","seedance-2-fast","seedance-2-mini","seedance-2.5"],"title":"Model","description":"Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"negative_prompt":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Negative Prompt","description":"Content or qualities to avoid when supported by the selected model."},"duration":{"anyOf":[{"type":"integer"},{"type":"string","const":"auto"},{"type":"null"}],"title":"Duration","description":"Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default."},"aspect_ratio":{"anyOf":[{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","21:9","9:21","adaptive"]},{"type":"null"}],"title":"Aspect Ratio","description":"Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior."},"resolution":{"anyOf":[{"type":"string","enum":["480p","720p","1080p","2k","4k"]},{"type":"null"}],"title":"Resolution","description":"Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written."},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark","description":"Whether generated video should include the model watermark."},"generate_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Audio","description":"Whether the selected model should generate synchronized audio."},"web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Web Search","description":"Whether the selected model may use web search during generation."},"return_last_frame":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return Last Frame","description":"Whether to return the generated video's last frame as an image artifact."},"output_format":{"anyOf":[{"type":"string","enum":["mp4","mov"]},{"type":"null"}],"title":"Output Format","description":"Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding."},"prompt":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"Prompt","description":"Optional instructions describing how the ordered references should guide the output."},"references":{"items":{"$ref":"#/components/schemas/VideoReference"},"type":"array","maxItems":50,"minItems":1,"title":"References","description":"One to fifty ordered image, video, or audio references. Model-specific kind, count, duration, and combination limits still apply."}},"additionalProperties":false,"type":"object","required":["references"],"title":"ReferenceToVideoRequest"},"ResponseFormatJsonObject":{"properties":{"type":{"type":"string","const":"json_object","title":"Type","default":"json_object"}},"type":"object","title":"ResponseFormatJsonObject"},"ResponseFormatJsonSchema":{"properties":{"type":{"type":"string","const":"json_schema","title":"Type","default":"json_schema"},"json_schema":{"$ref":"#/components/schemas/JsonSchemaDef"}},"type":"object","required":["json_schema"],"title":"ResponseFormatJsonSchema"},"ResponseFormatText":{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"}},"type":"object","title":"ResponseFormatText"},"RetireCallbackSigningKeyResponse":{"properties":{"signing_key_id":{"type":"string","title":"Signing Key Id"},"status":{"type":"string","const":"retired","title":"Status","default":"retired"}},"type":"object","required":["signing_key_id"],"title":"RetireCallbackSigningKeyResponse"},"RevokeKeyResponse":{"properties":{"api_key_id":{"type":"string","title":"Api Key Id"},"status":{"type":"string","const":"revoked","title":"Status","default":"revoked"}},"type":"object","required":["api_key_id"],"title":"RevokeKeyResponse"},"SessionHandoffRedeemRequest":{"properties":{"ticket":{"type":"string","maxLength":128,"minLength":32,"title":"Ticket"}},"additionalProperties":false,"type":"object","required":["ticket"],"title":"SessionHandoffRedeemRequest"},"SessionHandoffRedeemResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true}},"type":"object","title":"SessionHandoffRedeemResponse"},"SessionHandoffRequest":{"properties":{"target_host":{"type":"string","enum":["h5.beatra.cn","h5.beatra.ai","console.beatra.cn","console.beatra.ai"],"title":"Target Host"}},"additionalProperties":false,"type":"object","required":["target_host"],"title":"SessionHandoffRequest"},"SessionHandoffResponse":{"properties":{"ticket":{"type":"string","title":"Ticket"},"expires_in":{"type":"integer","title":"Expires In"}},"type":"object","required":["ticket","expires_in"],"title":"SessionHandoffResponse"},"SocialTaskIdentity":{"properties":{"platform":{"type":"string","title":"Platform"},"operation_key":{"type":"string","title":"Operation Key"},"operation_name":{"type":"string","title":"Operation Name"},"schema_hash":{"type":"string","title":"Schema Hash"}},"type":"object","required":["platform","operation_key","operation_name","schema_hash"],"title":"SocialTaskIdentity"},"SpeechCharacterWeights":{"properties":{"han_ideograph":{"type":"integer","const":2,"title":"Han Ideograph","default":2},"other":{"type":"integer","const":1,"title":"Other","default":1}},"additionalProperties":false,"type":"object","title":"SpeechCharacterWeights"},"SpeechConstraintsCard":{"properties":{"input_max_characters":{"type":"integer","const":50000,"title":"Input Max Characters","default":50000},"supported_languages":{"items":{"type":"string"},"type":"array","title":"Supported Languages"},"formats":{"items":{"type":"string","enum":["mp3","wav","flac","opus","pcm"]},"type":"array","title":"Formats"},"sample_rates":{"items":{"type":"integer","enum":[8000,16000,22050,24000,32000,44100]},"type":"array","title":"Sample Rates"},"speed":{"$ref":"#/components/schemas/AudioNumberRange"},"volume":{"$ref":"#/components/schemas/AudioNumberRange"},"pitch":{"$ref":"#/components/schemas/AudioNumberRange"},"emotions":{"items":{"type":"string"},"type":"array","title":"Emotions"},"billing_character_weights":{"$ref":"#/components/schemas/SpeechCharacterWeights"},"minimum_billable_characters":{"type":"integer","const":0,"title":"Minimum Billable Characters","default":0}},"additionalProperties":false,"type":"object","required":["supported_languages","formats","sample_rates","speed","volume","pitch","emotions"],"title":"SpeechConstraintsCard"},"StreamOptions":{"properties":{"include_usage":{"type":"boolean","title":"Include Usage","default":false}},"type":"object","title":"StreamOptions"},"SunoMusicOptions":{"properties":{"custom_mode":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Custom Mode"},"negative_tags":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Negative Tags","description":"Suno traits to exclude; limited independently from prompt, lyrics, and title."},"vocal_gender":{"anyOf":[{"type":"string","enum":["m","f"]},{"type":"null"}],"title":"Vocal Gender"},"style_weight":{"anyOf":[{"type":"number","multipleOf":0.01,"maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Style Weight"},"weirdness_constraint":{"anyOf":[{"type":"number","multipleOf":0.01,"maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Weirdness Constraint"},"audio_weight":{"anyOf":[{"type":"number","multipleOf":0.01,"maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Audio Weight"}},"additionalProperties":false,"type":"object","title":"SunoMusicOptions"},"SystemMessage":{"properties":{"role":{"type":"string","enum":["system","developer"],"title":"Role"},"content":{"anyOf":[{"type":"string"},{"items":{"$ref":"#/components/schemas/TextContentPart"},"type":"array"}],"title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["role","content"],"title":"SystemMessage"},"TaskBilling":{"properties":{"charged_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Charged Credits","description":"Credits charged to wallet for this Task. Populated by PR-2/3."},"refunded_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Refunded Credits","description":"Credits refunded for this Task. Populated by PR-3."},"granted_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Granted Credits","description":"Credits on this Task covered by a directed grant rather than by the wallet, net of any revocation. Absent when no grant applied."},"grant_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grant Source","description":"Which grant covered it. Present exactly when granted_credits is."},"net_charged_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Net Charged Credits","description":"Final customer charge: charged_credits minus refunded_credits minus granted_credits. This is the number to report as what the Task cost."}},"type":"object","title":"TaskBilling"},"TaskBillingSummary":{"properties":{"billing_mode":{"type":"string","title":"Billing Mode"},"charge_status":{"type":"string","title":"Charge Status"},"refund_status":{"type":"string","title":"Refund Status"},"charged_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Charged Credits"},"refunded_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Refunded Credits"},"granted_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Granted Credits"},"grant_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grant Source"}},"type":"object","required":["billing_mode","charge_status","refund_status","charged_credits","refunded_credits"],"title":"TaskBillingSummary"},"TaskCallback":{"properties":{"url":{"type":"string","title":"Url"},"status":{"type":"string","enum":["pending","dispatching","delivered","retrying","failed"],"title":"Status"},"attempt_count":{"type":"integer","title":"Attempt Count"},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Delivered At"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error","description":"Stable Beatra-owned callback delivery failure summary."}},"type":"object","required":["url","status","attempt_count"],"title":"TaskCallback"},"TaskCallbackSummary":{"properties":{"url":{"type":"string","title":"Url"},"status":{"$ref":"#/components/schemas/CallbackStatusEnum"},"attempt_count":{"type":"integer","title":"Attempt Count"},"last_status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Status Code"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"next_action_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Action At"},"delivered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Delivered At"}},"type":"object","required":["url","status","attempt_count"],"title":"TaskCallbackSummary"},"TaskCancelRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Reason"}},"type":"object","title":"TaskCancelRequest"},"TaskDetail":{"properties":{"task_id":{"type":"string","title":"Task Id"},"capability":{"type":"string","title":"Capability"},"workload_type":{"type":"string","enum":["model","social_operation"],"title":"Workload Type","default":"model"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"resolved_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved Model"},"social":{"anyOf":[{"$ref":"#/components/schemas/SocialTaskIdentity"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/TaskStatusEnum"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"cancel_requested_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cancel Requested At"},"progress":{"anyOf":[{"$ref":"#/components/schemas/app__api__account__schemas__TaskProgress"},{"type":"null"}]},"error":{"anyOf":[{"$ref":"#/components/schemas/app__api__account__schemas__TaskError"},{"type":"null"}]},"request_parameters":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Parameters","description":"Provider-neutral request parameters after recursive public projection."},"output_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output Summary","description":"Provider-neutral task output after recursive supply declassification."},"billing":{"$ref":"#/components/schemas/TaskBillingSummary"},"callback":{"anyOf":[{"$ref":"#/components/schemas/TaskCallbackSummary"},{"type":"null"}]}},"type":"object","required":["task_id","capability","status","created_at","billing"],"title":"TaskDetail"},"TaskEnvelope":{"properties":{"object":{"type":"string","const":"task","title":"Object","default":"task"},"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","enum":["queued","running","succeeded","failed","canceled"],"title":"Status"},"capability":{"type":"string","title":"Capability"},"workload_type":{"type":"string","enum":["model","social_operation"],"title":"Workload Type","default":"model"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Caller-requested model verbatim (may be 'auto'). Null for social_operation tasks."},"resolved_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved Model","description":"Actual model that ran (null until execution starts; equals model for explicit-model calls)"},"model_selection_reason":{"type":"null","title":"Model Selection Reason","description":"Deprecated. Always null.","deprecated":true},"social":{"anyOf":[{"$ref":"#/components/schemas/SocialTaskIdentity"},{"type":"null"}]},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata"},"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input"},"progress":{"anyOf":[{"$ref":"#/components/schemas/app__api__v1__schemas__common__TaskProgress"},{"type":"null"}]},"output":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output"},"warnings":{"items":{"$ref":"#/components/schemas/TaskWarning"},"type":"array","title":"Warnings"},"error":{"anyOf":[{"$ref":"#/components/schemas/app__api__v1__schemas__common__TaskError"},{"type":"null"}]},"usage":{"anyOf":[{"$ref":"#/components/schemas/UsageObject"},{"type":"null"}]},"billing":{"anyOf":[{"$ref":"#/components/schemas/TaskBilling"},{"type":"null"}]},"callback":{"anyOf":[{"$ref":"#/components/schemas/TaskCallback"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"deadline_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"cancel_requested_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cancel Requested At"},"links":{"$ref":"#/components/schemas/TaskLinks"}},"type":"object","required":["task_id","status","capability","created_at","links"],"title":"TaskEnvelope","description":"Standard Task envelope.\n\nReturned by every async-creation endpoint, GET /v1/tasks/{id}, and\nthe body of customer callback POSTs."},"TaskLibraryDeleteResponse":{"properties":{"task_id":{"type":"string","title":"Task Id"},"status":{"type":"string","const":"deleted","title":"Status","default":"deleted"}},"type":"object","required":["task_id"],"title":"TaskLibraryDeleteResponse"},"TaskLinks":{"properties":{"self":{"type":"string","title":"Self"},"cancel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancel"},"assets":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assets","description":"Absolute customer-console URL for viewing and managing the generated artifacts."}},"type":"object","required":["self"],"title":"TaskLinks"},"TaskListItem":{"properties":{"task_id":{"type":"string","title":"Task Id"},"capability":{"type":"string","title":"Capability"},"workload_type":{"type":"string","enum":["model","social_operation"],"title":"Workload Type","default":"model"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"resolved_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved Model"},"social":{"anyOf":[{"$ref":"#/components/schemas/SocialTaskIdentity"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/TaskStatusEnum"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"billing":{"$ref":"#/components/schemas/TaskBillingSummary"},"source_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Platform"},"device_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Kind"}},"type":"object","required":["task_id","capability","status","created_at","billing"],"title":"TaskListItem"},"TaskStatusEnum":{"type":"string","enum":["queued","running","succeeded","failed","canceled"],"title":"TaskStatusEnum"},"TaskWarning":{"properties":{"code":{"type":"string","title":"Code","description":"e.g. option_clamped / auto_routed"},"message":{"type":"string","title":"Message"},"field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field"}},"type":"object","required":["code","message"],"title":"TaskWarning"},"TextContentPart":{"properties":{"type":{"type":"string","const":"text","title":"Type"},"text":{"type":"string","title":"Text"}},"type":"object","required":["type","text"],"title":"TextContentPart"},"TextToImageRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","gpt-image-2.5-flare","gpt-image-2.5-sunburst","gpt-image-2","image-01-live","wan2.7-image-pro","wan2.7-image","qwen-image-3.0-pro","qwen-image-3.0","qwen-image-2.0-pro","qwen-image-2.0"],"title":"Model","description":"Use auto for compatibility-based selection from the configured live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"prompt":{"type":"string","minLength":1,"pattern":"\\S","title":"Prompt","description":"Required prompt containing at least one non-whitespace character."},"count":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Count","description":"Requested output image count. The public range is one through four, and the selected model must support the exact count; Beatra does not split the request.","default":1},"canvas":{"oneOf":[{"$ref":"#/components/schemas/ImagePresetCanvas"},{"$ref":"#/components/schemas/ImageTargetCanvas"}],"title":"Canvas","description":"Desired output canvas. Presets are quality tiers, and target dimensions may be normalized or vary; inspect output images for actual dimensions.","default":{"type":"preset","tier":"2K","aspect":"16:9"},"discriminator":{"propertyName":"type","mapping":{"preset":"#/components/schemas/ImagePresetCanvas","target":"#/components/schemas/ImageTargetCanvas"}}},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed","description":"Optional random seed. Supplying it constrains model eligibility; omit it for model-managed randomness."},"negative_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Negative Prompt","description":"Optional content or qualities to avoid. Supplying it constrains model eligibility and is rejected when no compatible model is available."},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written; an explicit boolean constrains model eligibility."},"palette":{"anyOf":[{"items":{"$ref":"#/components/schemas/ImagePaletteColor"},"type":"array","maxItems":10,"minItems":3},{"type":"null"}],"title":"Palette","description":"Three to ten weighted RGB colors. Runtime validation requires the weights to sum exactly to 1.0000.","x-beatra-runtime-relations":[{"expression":"sum(palette[*].weight) == 1.0000","id":"palette-weight-sum"}]},"output_relationship":{"$ref":"#/components/schemas/ImageOutputRelationship","description":"Use independent for unrelated results, or sequence for a related image set. An explicit value constrains model eligibility and is rejected when unsupported.","default":"independent"},"reasoning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Reasoning","description":"Omit or use null to retain the selected model's documented default; an explicit boolean constrains model eligibility."}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"TextToImageRequest","description":"Generate one to four images from a prompt."},"TextToMusicRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; limited by task creation policy."},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","minimax-music-3.0","suno-6"],"title":"Model"},"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt","description":"Style, mood, genre, and instrumentation. When lyrics are supplied (or Suno custom mode is on) this maps to the provider's style-conditioning field; otherwise it is the song description the model writes the song from. Either way it is not an instruction field: execution directives written here (for example \"do not omit anything\", \"sing it verbatim\", \"make chapter three differ from chapter one\") are not read as instructions and will not be obeyed. Put the words to be sung in `lyrics`, or set `instrumental` to true for a track with no vocals."},"lyrics":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Lyrics","description":"Optional lyrics text. Must be omitted for instrumental music."},"instrumental":{"type":"boolean","title":"Instrumental","description":"When true, generate instrumental music without vocals.","default":false},"title":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Title"},"model_options":{"anyOf":[{"$ref":"#/components/schemas/MusicModelOptions"},{"type":"null"}],"description":"Options grouped by public music model family."}},"additionalProperties":false,"type":"object","required":["model","prompt"],"title":"TextToMusicRequest","description":"Generate music from a prompt and optional lyrics."},"TextToSpeechRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Model Options","description":"Per-model-family passthrough options; opaque to the platform, validated per model"},"voice":{"type":"string","title":"Voice","description":"Opaque beatra voice_id (preset or cloned)"},"input":{"type":"string","maxLength":50000,"minLength":1,"title":"Input","description":"Text to synthesize"},"model":{"type":"string","enum":["auto","minimax-speech-2.8-hd","minimax-speech-2.8-turbo"],"title":"Model","description":"TTS model; 'auto' picks a model compatible with the voice","default":"auto"},"language":{"anyOf":[{"type":"string","maxLength":32,"minLength":2},{"type":"null"}],"title":"Language","description":"Optional BCP-47 language tag, for example zh-CN, yue-HK, or en-US. Read supported_languages from the selected model's catalog card. When omitted, the voice or provider chooses the language."},"format":{"type":"string","enum":["mp3","wav","flac","opus","pcm"],"title":"Format","default":"mp3"},"sample_rate":{"anyOf":[{"type":"integer","enum":[8000,16000,22050,24000,32000,44100]},{"type":"null"}],"title":"Sample Rate"},"speed":{"type":"number","maximum":2.0,"minimum":0.5,"title":"Speed","default":1.0},"volume":{"type":"number","maximum":10.0,"exclusiveMinimum":0.0,"title":"Volume","default":1.0},"pitch":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Pitch","description":"Pitch adjustment from -1 to 1: 0 keeps the voice's original pitch, -1 is the lowest and 1 the highest the selected model supports. Use decimals such as 0.25 or -0.5 for subtle tuning.","default":0.0},"emotion":{"anyOf":[{"type":"string","enum":["happy","sad","angry","fearful","disgusted","surprised","calm"]},{"type":"null"}],"title":"Emotion","description":"Provider-neutral discrete speaking emotion"}},"additionalProperties":false,"type":"object","required":["voice","input"],"title":"TextToSpeechRequest"},"TextToVideoRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","minimax-h3","wan3.0-video","wan3.0-video-prime","happyhorse-1.1-t2v","wan2.7-t2v","seedance-2","seedance-2-fast","seedance-2-mini","seedance-2.5"],"title":"Model","description":"Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"negative_prompt":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Negative Prompt","description":"Content or qualities to avoid when supported by the selected model."},"duration":{"anyOf":[{"type":"integer"},{"type":"string","const":"auto"},{"type":"null"}],"title":"Duration","description":"Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default."},"aspect_ratio":{"anyOf":[{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","21:9","9:21","adaptive"]},{"type":"null"}],"title":"Aspect Ratio","description":"Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior."},"resolution":{"anyOf":[{"type":"string","enum":["480p","720p","1080p","2k","4k"]},{"type":"null"}],"title":"Resolution","description":"Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written."},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark","description":"Whether generated video should include the model watermark."},"generate_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Audio","description":"Whether the selected model should generate synchronized audio."},"web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Web Search","description":"Whether the selected model may use web search during generation."},"return_last_frame":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return Last Frame","description":"Whether to return the generated video's last frame as an image artifact."},"output_format":{"anyOf":[{"type":"string","enum":["mp4","mov"]},{"type":"null"}],"title":"Output Format","description":"Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding."},"prompt":{"type":"string","maxLength":20000,"minLength":1,"title":"Prompt","description":"Required description of the video to generate without source image or video media."},"audio":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},{"type":"null"}],"title":"Audio","description":"Optional driving audio for models that support audio-conditioned generation."}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"TextToVideoRequest"},"Tool":{"properties":{"type":{"type":"string","const":"function","title":"Type","default":"function"},"function":{"$ref":"#/components/schemas/FunctionDefinition"}},"type":"object","required":["function"],"title":"Tool"},"ToolCall":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","const":"function","title":"Type","default":"function"},"function":{"$ref":"#/components/schemas/ToolCallFunction"}},"type":"object","required":["id","function"],"title":"ToolCall"},"ToolCallFunction":{"properties":{"name":{"type":"string","title":"Name"},"arguments":{"type":"string","title":"Arguments","description":"JSON-stringified arguments"}},"type":"object","required":["name","arguments"],"title":"ToolCallFunction"},"ToolMessage":{"properties":{"role":{"type":"string","const":"tool","title":"Role"},"content":{"anyOf":[{"type":"string"},{"items":{"$ref":"#/components/schemas/TextContentPart"},"type":"array"}],"title":"Content"},"tool_call_id":{"type":"string","title":"Tool Call Id"}},"type":"object","required":["role","content","tool_call_id"],"title":"ToolMessage"},"UnderstandingAutoSelectionCard":{"properties":{"request_dependent":{"type":"boolean","const":true,"title":"Request Dependent","default":true},"default_for_omitted_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default For Omitted Request"},"candidate_order":{"items":{"type":"string"},"type":"array","title":"Candidate Order"}},"additionalProperties":false,"type":"object","required":["default_for_omitted_request","candidate_order"],"title":"UnderstandingAutoSelectionCard"},"UnderstandingCapabilityDetail":{"properties":{"schema_version":{"type":"string","const":"understanding-interface.v1","title":"Schema Version","default":"understanding-interface.v1"},"capability":{"type":"string","enum":["image_to_text","video_to_text"],"title":"Capability"},"endpoint":{"type":"string","title":"Endpoint"},"input_modality":{"type":"string","title":"Input Modality"},"output_modality":{"type":"string","const":"text","title":"Output Modality","default":"text"},"execution_mode":{"type":"string","const":"sync_long","title":"Execution Mode","default":"sync_long"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"auto":{"$ref":"#/components/schemas/UnderstandingAutoSelectionCard"},"models":{"items":{"$ref":"#/components/schemas/UnderstandingModelCard"},"type":"array","title":"Models"}},"additionalProperties":false,"type":"object","required":["capability","endpoint","input_modality","description","status","auto","models"],"title":"UnderstandingCapabilityDetail"},"UnderstandingDetailCard":{"properties":{"default":{"type":"string","const":"default","title":"Default","default":"default"},"values":{"items":{"type":"string","enum":["default","low","high"]},"type":"array","title":"Values"},"affects_price":{"type":"boolean","const":false,"title":"Affects Price","default":false}},"additionalProperties":false,"type":"object","title":"UnderstandingDetailCard"},"UnderstandingMediaConstraintsCard":{"properties":{"kind":{"type":"string","enum":["image","video"],"title":"Kind"},"accepted_kinds":{"items":{"type":"string","enum":["artifact","data_uri","https_url"]},"type":"array","title":"Accepted Kinds"},"min_items":{"type":"integer","const":1,"title":"Min Items","default":1},"max_items":{"type":"integer","maximum":8.0,"minimum":1.0,"title":"Max Items"},"max_bytes_each":{"type":"integer","exclusiveMinimum":0.0,"title":"Max Bytes Each"},"max_duration_seconds":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Duration Seconds"},"sampling_fps":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Sampling Fps"}},"additionalProperties":false,"type":"object","required":["kind","accepted_kinds","max_items","max_bytes_each"],"title":"UnderstandingMediaConstraintsCard"},"UnderstandingModelCard":{"properties":{"schema_version":{"type":"string","const":"understanding-interface.v1","title":"Schema Version","default":"understanding-interface.v1"},"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"capability":{"type":"string","enum":["image_to_text","video_to_text"],"title":"Capability"},"status":{"type":"string","const":"available","title":"Status","default":"available"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls"},"media":{"$ref":"#/components/schemas/UnderstandingMediaConstraintsCard"},"detail":{"$ref":"#/components/schemas/UnderstandingDetailCard"},"thinking":{"$ref":"#/components/schemas/UnderstandingThinkingCard"},"pricing":{"items":{"$ref":"#/components/schemas/UnderstandingPricingCard"},"type":"array","minItems":1,"title":"Pricing"}},"additionalProperties":false,"type":"object","required":["model","display_name","capability","controls","media","detail","thinking","pricing"],"title":"UnderstandingModelCard"},"UnderstandingModelDetail":{"properties":{"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"interfaces":{"items":{"$ref":"#/components/schemas/UnderstandingModelCard"},"type":"array","title":"Interfaces"}},"additionalProperties":false,"type":"object","required":["model","display_name","description","status","interfaces"],"title":"UnderstandingModelDetail"},"UnderstandingPricingCard":{"properties":{"meter":{"type":"string","enum":["image_count","input_video_second"],"title":"Meter"},"unit":{"type":"string","enum":["image","second"],"title":"Unit"},"unit_price_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unit Price Credits"},"scale":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Scale"},"billing_basis":{"type":"string","enum":["admitted_image_count","ceil_admitted_input_video_seconds"],"title":"Billing Basis"},"estimate_formula":{"type":"string","const":"(unit_price_credits * billable_quantity) / scale","title":"Estimate Formula","default":"(unit_price_credits * billable_quantity) / scale"}},"additionalProperties":false,"type":"object","required":["meter","unit","unit_price_credits","scale","billing_basis"],"title":"UnderstandingPricingCard"},"UnderstandingThinkingCard":{"properties":{"public_control":{"type":"boolean","const":false,"title":"Public Control","default":false},"mode":{"type":"string","enum":["adaptive","model_default"],"title":"Mode"}},"additionalProperties":false,"type":"object","required":["mode"],"title":"UnderstandingThinkingCard"},"UploadResponse":{"properties":{"object":{"type":"string","const":"upload","title":"Object","default":"upload"},"artifact_id":{"type":"string","title":"Artifact Id"},"cdn_url":{"type":"string","title":"Cdn Url"},"mime_type":{"type":"string","title":"Mime Type"},"media_type":{"type":"string","enum":["image","video","audio"],"title":"Media Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"checksum_sha256":{"type":"string","title":"Checksum Sha256"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["artifact_id","cdn_url","mime_type","media_type","size_bytes","checksum_sha256","created_at"],"title":"UploadResponse","description":"Returned by both /v1/uploads (201) and de-dup hit (200)."},"UsageLine":{"properties":{"meter":{"type":"string","title":"Meter","description":"e.g. input_token / output_token / image_count / input_video_second / output_video_second"},"quantity":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Quantity","description":"Decimal — number of meter units consumed"},"unit":{"type":"string","title":"Unit","description":"Display unit, e.g. 'token' / 'image' / 'second'"},"billed_amount_credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Billed Amount Credits","description":"Credits charged for this usage line. Populated by PR-2/3."}},"type":"object","required":["meter","quantity","unit"],"title":"UsageLine"},"UsageObject":{"properties":{"input_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Input Tokens"},"output_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Output Tokens"},"cache_read_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cache Read Tokens"},"cache_creation_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cache Creation Tokens"},"reasoning_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reasoning Tokens"},"image_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Image Count"},"image_pixels":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Image Pixels"},"video_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Video Seconds"},"input_video_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Input Video Seconds","description":"Authoritative input-video seconds included in settled video usage."},"output_video_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Output Video Seconds","description":"Authoritative generated/output-video seconds included in settled video usage."},"audio_seconds":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Audio Seconds"},"characters":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Characters"},"lines":{"items":{"$ref":"#/components/schemas/UsageLine"},"type":"array","title":"Lines"},"credits":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Credits","description":"Credits charged for this Task. Populated by PR-2 / PR-3."}},"type":"object","title":"UsageObject"},"UsageSeriesRow":{"properties":{"date":{"type":"string","format":"date","title":"Date"},"capability":{"type":"string","title":"Capability"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"requests":{"type":"integer","title":"Requests"},"credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Credits"}},"type":"object","required":["date","capability","requests","credits"],"title":"UsageSeriesRow"},"UsageTotals":{"properties":{"requests":{"type":"integer","title":"Requests"},"credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Credits"}},"type":"object","required":["requests","credits"],"title":"UsageTotals"},"UsageWindow":{"properties":{"from":{"type":"string","format":"date","title":"From"},"to":{"type":"string","format":"date","title":"To"},"group_by":{"$ref":"#/components/schemas/GroupBy"},"totals":{"$ref":"#/components/schemas/UsageTotals"},"series":{"items":{"$ref":"#/components/schemas/UsageSeriesRow"},"type":"array","title":"Series"}},"type":"object","required":["from","to","group_by","totals","series"],"title":"UsageWindow"},"UserMessage":{"properties":{"role":{"type":"string","const":"user","title":"Role"},"content":{"anyOf":[{"type":"string"},{"items":{"oneOf":[{"$ref":"#/components/schemas/TextContentPart"},{"$ref":"#/components/schemas/ImageUrlContentPart"},{"$ref":"#/components/schemas/VideoUrlContentPart"},{"$ref":"#/components/schemas/InputAudioContentPart"},{"$ref":"#/components/schemas/FileContentPart"}],"discriminator":{"propertyName":"type","mapping":{"file":"#/components/schemas/FileContentPart","image_url":"#/components/schemas/ImageUrlContentPart","input_audio":"#/components/schemas/InputAudioContentPart","text":"#/components/schemas/TextContentPart","video_url":"#/components/schemas/VideoUrlContentPart"}}},"type":"array"}],"title":"Content"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["role","content"],"title":"UserMessage"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VideoAspectCard":{"properties":{"mode":{"type":"string","enum":["explicit_control","source_derived","upstream_fixed","unsupported"],"title":"Mode"},"accepts_explicit_value":{"type":"boolean","title":"Accepts Explicit Value"},"supported_values":{"items":{"type":"string"},"type":"array","title":"Supported Values"},"default":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default"},"source_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Role"}},"additionalProperties":false,"type":"object","required":["mode","accepts_explicit_value","supported_values","default","source_role"],"title":"VideoAspectCard"},"VideoAutoSelectionCard":{"properties":{"request_dependent":{"type":"boolean","const":true,"title":"Request Dependent","description":"Auto selection evaluates the complete request rather than resolving to one fixed model.","default":true},"default_for_omitted_request":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default For Omitted Request","description":"First live candidate for a request that omits all optional selection controls."},"candidate_order":{"items":{"type":"string"},"type":"array","title":"Candidate Order","description":"Ordered live public candidates; auto selects the first candidate eligible for the request."},"persisted_selection_field":{"type":"string","const":"resolved_model","title":"Persisted Selection Field","description":"Task field that records the concrete model selected during admission.","default":"resolved_model"}},"additionalProperties":false,"type":"object","required":["default_for_omitted_request","candidate_order"],"title":"VideoAutoSelectionCard"},"VideoBillableQuantityCard":{"properties":{"basis":{"type":"string","enum":["admitted_output_duration_seconds","final_output_duration_seconds","reference_video_seconds","capped_reference_video_seconds","source_video_seconds","source_and_reference_video_seconds"],"title":"Basis"},"counted_inputs":{"items":{"type":"string"},"type":"array","title":"Counted Inputs"},"aggregate_max_seconds":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Aggregate Max Seconds"},"per_video_cap_seconds_by_video_count":{"anyOf":[{"additionalProperties":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},"type":"object"},{"type":"null"}],"title":"Per Video Cap Seconds By Video Count"}},"additionalProperties":false,"type":"object","required":["basis","counted_inputs"],"title":"VideoBillableQuantityCard"},"VideoCapabilityDetail":{"properties":{"capability":{"type":"string","enum":["text_to_video","image_to_video","reference_to_video","frames_to_video","video_edit","video_extend"],"title":"Capability"},"endpoint":{"type":"string","title":"Endpoint"},"input_modality":{"type":"string","title":"Input Modality"},"output_modality":{"type":"string","const":"video","title":"Output Modality","default":"video"},"execution_mode":{"type":"string","const":"async","title":"Execution Mode","default":"async"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"auto":{"$ref":"#/components/schemas/VideoAutoSelectionCard"},"models":{"items":{"$ref":"#/components/schemas/VideoModelCard"},"type":"array","title":"Models"}},"additionalProperties":false,"type":"object","required":["capability","endpoint","input_modality","description","status","auto","models"],"title":"VideoCapabilityDetail"},"VideoComposeRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"clips":{"items":{"$ref":"#/components/schemas/ComposeClip"},"type":"array","maxItems":12,"minItems":1,"title":"Clips"},"narration":{"anyOf":[{"$ref":"#/components/schemas/MediaInputArtifact"},{"type":"null"}]},"music":{"anyOf":[{"$ref":"#/components/schemas/ComposeMusic"},{"type":"null"}]},"subtitles":{"items":{"$ref":"#/components/schemas/ComposeSubtitle"},"type":"array","maxItems":200,"title":"Subtitles"},"canvas":{"type":"string","enum":["9:16","16:9","1:1","3:4"],"title":"Canvas","default":"9:16"},"model":{"type":"string","enum":["auto","beatra-compose-v1"],"title":"Model","default":"auto"},"client_request_id":{"type":"string","maxLength":128,"minLength":1,"title":"Client Request Id"}},"additionalProperties":false,"type":"object","required":["clips","client_request_id"],"title":"VideoComposeRequest","description":"Join the caller's own video artifacts with narration, ducked music and subtitles."},"VideoDefaultsCard":{"properties":{"resolution":{"type":"string","title":"Resolution"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"generate_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Audio"},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark"},"web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Web Search"},"return_last_frame":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return Last Frame"}},"additionalProperties":false,"type":"object","required":["resolution","duration"],"title":"VideoDefaultsCard"},"VideoDurationCard":{"properties":{"mode":{"type":"string","enum":["explicit_control","source_derived","final_duration","upstream_fixed"],"title":"Mode"},"required":{"type":"boolean","title":"Required"},"explicit_override":{"type":"boolean","title":"Explicit Override"},"supports_auto":{"type":"boolean","title":"Supports Auto","default":false}},"additionalProperties":false,"type":"object","required":["mode","required","explicit_override"],"title":"VideoDurationCard"},"VideoEditRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","wan3.0-video","wan3.0-video-prime","happyhorse-1.0-video-edit","wan2.7-videoedit","seedance-2","seedance-2-fast","seedance-2-mini","seedance-2.5"],"title":"Model","description":"Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"negative_prompt":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Negative Prompt","description":"Content or qualities to avoid when supported by the selected model."},"duration":{"anyOf":[{"type":"integer"},{"type":"string","const":"auto"},{"type":"null"}],"title":"Duration","description":"Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default."},"aspect_ratio":{"anyOf":[{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","21:9","9:21","adaptive"]},{"type":"null"}],"title":"Aspect Ratio","description":"Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior."},"resolution":{"anyOf":[{"type":"string","enum":["480p","720p","1080p","2k","4k"]},{"type":"null"}],"title":"Resolution","description":"Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written."},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark","description":"Whether generated video should include the model watermark."},"generate_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Audio","description":"Whether the selected model should generate synchronized audio."},"web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Web Search","description":"Whether the selected model may use web search during generation."},"return_last_frame":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return Last Frame","description":"Whether to return the generated video's last frame as an image artifact."},"output_format":{"anyOf":[{"type":"string","enum":["mp4","mov"]},{"type":"null"}],"title":"Output Format","description":"Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding."},"source_video":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"title":"Source Video","description":"Required video whose existing content will be edited.","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},"instruction":{"type":"string","maxLength":20000,"minLength":1,"title":"Instruction","description":"Required instruction describing changes to the source video."},"references":{"items":{"$ref":"#/components/schemas/VideoReference"},"type":"array","maxItems":49,"title":"References","description":"Optional ordered image, video, or audio references. The selected model must support every supplied reference kind and count."},"audio_setting":{"anyOf":[{"type":"string","enum":["auto","origin"]},{"type":"null"}],"title":"Audio Setting","description":"Optional edit-audio policy: auto lets a compatible model choose, while origin requests preservation of source audio."}},"additionalProperties":false,"type":"object","required":["source_video","instruction"],"title":"VideoEditRequest","description":"Instruction-based video editing with optional multimodal references."},"VideoExtendRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","enum":["auto","wan3.0-video","wan3.0-video-prime","wan2.7-i2v","seedance-2","seedance-2-fast","seedance-2-mini","seedance-2.5"],"title":"Model","description":"Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted.","default":"auto"},"negative_prompt":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Negative Prompt","description":"Content or qualities to avoid when supported by the selected model."},"duration":{"type":"integer","maximum":30.0,"minimum":2.0,"title":"Duration","description":"Required final returned-video duration in integer seconds. It must exceed the trusted source-video duration; model-specific admission may narrow the range."},"aspect_ratio":{"anyOf":[{"type":"string","enum":["16:9","9:16","1:1","4:3","3:4","4:5","5:4","21:9","9:21","adaptive"]},{"type":"null"}],"title":"Aspect Ratio","description":"Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior."},"resolution":{"anyOf":[{"type":"string","enum":["480p","720p","1080p","2k","4k"]},{"type":"null"}],"title":"Resolution","description":"Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced."},"seed":{"anyOf":[{"type":"integer","maximum":2147483647.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"enhance_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enhance Prompt","description":"Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written."},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark","description":"Whether generated video should include the model watermark."},"generate_audio":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Audio","description":"Whether the selected model should generate synchronized audio."},"web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Web Search","description":"Whether the selected model may use web search during generation."},"return_last_frame":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Return Last Frame","description":"Whether to return the generated video's last frame as an image artifact."},"output_format":{"anyOf":[{"type":"string","enum":["mp4","mov"]},{"type":"null"}],"title":"Output Format","description":"Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding."},"video":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"title":"Video","description":"The single source video to continue.","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},"direction":{"type":"string","enum":["before","after"],"title":"Direction","description":"Generate new content immediately before or after the source video's content."},"instruction":{"type":"string","maxLength":20000,"minLength":1,"title":"Instruction","description":"Required instruction describing how the source video should continue."},"references":{"items":{"$ref":"#/components/schemas/VideoReference"},"type":"array","maxItems":49,"title":"References","description":"Optional ordered image, video, or audio references. The selected model must support every supplied reference kind and count."}},"additionalProperties":false,"type":"object","required":["duration","video","direction","instruction"],"title":"VideoExtendRequest","description":"Generate footage immediately before or after one source video."},"VideoModelCard":{"properties":{"schema_version":{"type":"string","const":"video-interface.v1","title":"Schema Version","default":"video-interface.v1"},"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"capability":{"type":"string","enum":["text_to_video","image_to_video","reference_to_video","frames_to_video","video_edit","video_extend"],"title":"Capability"},"status":{"type":"string","const":"available","title":"Status","default":"available"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls"},"output_formats":{"items":{"type":"string","enum":["mp4","mov"]},"type":"array","minItems":1,"title":"Output Formats"},"skus":{"items":{"$ref":"#/components/schemas/VideoSKUCard"},"type":"array","minItems":1,"title":"Skus"},"defaults":{"$ref":"#/components/schemas/VideoDefaultsCard"},"aspect":{"$ref":"#/components/schemas/VideoAspectCard"},"duration":{"$ref":"#/components/schemas/VideoDurationCard"},"prompt_required":{"type":"boolean","title":"Prompt Required"},"prompt_max_units":{"type":"integer","exclusiveMinimum":0.0,"title":"Prompt Max Units"},"prompt_unit":{"type":"string","enum":["characters","happyhorse_weighted"],"title":"Prompt Unit"},"reference_kinds":{"items":{"type":"string"},"type":"array","title":"Reference Kinds"},"reference_roles":{"items":{"type":"string"},"type":"array","title":"Reference Roles"},"max_references":{"type":"integer","minimum":0.0,"title":"Max References"},"reference_limits":{"anyOf":[{"$ref":"#/components/schemas/VideoReferenceLimitsCard"},{"type":"null"}]},"input_combinations":{"items":{"items":{"type":"string"},"type":"array"},"type":"array","title":"Input Combinations"},"output_audio":{"anyOf":[{"$ref":"#/components/schemas/VideoOutputAudioCard"},{"type":"null"}]},"media":{"additionalProperties":true,"type":"object","title":"Media"},"pricing":{"items":{"$ref":"#/components/schemas/VideoPricingOption"},"type":"array","minItems":1,"title":"Pricing"}},"additionalProperties":false,"type":"object","required":["model","display_name","capability","controls","output_formats","skus","defaults","aspect","duration","prompt_required","prompt_max_units","prompt_unit","reference_kinds","reference_roles","max_references","media","pricing"],"title":"VideoModelCard"},"VideoModelDetail":{"properties":{"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"interfaces":{"items":{"anyOf":[{"$ref":"#/components/schemas/VideoModelCard"},{"$ref":"#/components/schemas/VideoPromptEnhancementModelCard"}]},"type":"array","title":"Interfaces"}},"additionalProperties":false,"type":"object","required":["model","display_name","description","status","interfaces"],"title":"VideoModelDetail"},"VideoOutputAudioCard":{"properties":{"included":{"type":"boolean","title":"Included"},"channel_layout":{"anyOf":[{"type":"string","const":"stereo"},{"type":"null"}],"title":"Channel Layout"},"source":{"anyOf":[{"type":"string","const":"model_generated"},{"type":"null"}],"title":"Source"}},"additionalProperties":false,"type":"object","required":["included"],"title":"VideoOutputAudioCard"},"VideoPricingOption":{"properties":{"meter":{"type":"string","enum":["input_video_second","output_video_second"],"title":"Meter"},"unit":{"type":"string","const":"second","title":"Unit","default":"second"},"unit_price_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unit Price Credits"},"scale":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Scale"},"resolution":{"type":"string","title":"Resolution"},"duration_seconds":{"items":{"type":"integer"},"type":"array","minItems":1,"title":"Duration Seconds"},"applicability":{"type":"string","enum":["video_input_present","always"],"title":"Applicability"},"billable_quantity":{"$ref":"#/components/schemas/VideoBillableQuantityCard"},"estimate_formula":{"type":"string","const":"(unit_price_credits * billable_quantity) / scale","title":"Estimate Formula","default":"(unit_price_credits * billable_quantity) / scale"}},"additionalProperties":false,"type":"object","required":["meter","unit_price_credits","scale","resolution","duration_seconds","applicability","billable_quantity"],"title":"VideoPricingOption"},"VideoPromptEnhancementAutoCard":{"properties":{"request_dependent":{"type":"boolean","const":false,"title":"Request Dependent","default":false},"model_input_ignored":{"type":"boolean","const":true,"title":"Model Input Ignored","default":true},"resolved_model":{"type":"string","title":"Resolved Model"},"persisted_selection_field":{"type":"string","const":"resolved_model","title":"Persisted Selection Field","default":"resolved_model"}},"additionalProperties":false,"type":"object","required":["resolved_model"],"title":"VideoPromptEnhancementAutoCard"},"VideoPromptEnhancementCapabilityDetail":{"properties":{"capability":{"type":"string","const":"video_prompt_enhancement","title":"Capability","default":"video_prompt_enhancement"},"endpoint":{"type":"string","title":"Endpoint"},"input_modality":{"type":"string","title":"Input Modality"},"output_modality":{"type":"string","const":"text","title":"Output Modality","default":"text"},"execution_mode":{"type":"string","const":"async","title":"Execution Mode","default":"async"},"description":{"type":"string","title":"Description"},"status":{"type":"string","enum":["available","unavailable"],"title":"Status"},"auto":{"$ref":"#/components/schemas/VideoPromptEnhancementAutoCard"},"models":{"items":{"$ref":"#/components/schemas/VideoPromptEnhancementModelCard"},"type":"array","title":"Models"}},"additionalProperties":false,"type":"object","required":["endpoint","input_modality","description","status","auto","models"],"title":"VideoPromptEnhancementCapabilityDetail"},"VideoPromptEnhancementModelCard":{"properties":{"schema_version":{"type":"string","const":"video-prompt-enhancement.v1","title":"Schema Version","default":"video-prompt-enhancement.v1"},"model":{"type":"string","title":"Model"},"display_name":{"type":"string","title":"Display Name"},"owned_by":{"type":"string","const":"beatra","title":"Owned By","default":"beatra"},"capability":{"type":"string","const":"video_prompt_enhancement","title":"Capability","default":"video_prompt_enhancement"},"status":{"type":"string","const":"available","title":"Status","default":"available"},"controls":{"items":{"type":"string"},"type":"array","title":"Controls"},"duration_seconds":{"additionalProperties":{"type":"integer"},"type":"object","title":"Duration Seconds"},"aspect_ratios":{"items":{"type":"string"},"type":"array","title":"Aspect Ratios"},"max_references":{"type":"integer","title":"Max References","default":11},"reference_limits":{"$ref":"#/components/schemas/VideoReferenceLimitsCard"},"billing_mode":{"type":"string","const":"postpaid","title":"Billing Mode","default":"postpaid"},"billing_basis":{"type":"string","const":"successful_provider_reported_tokens","title":"Billing Basis","default":"successful_provider_reported_tokens"},"pricing":{"items":{"$ref":"#/components/schemas/VideoPromptPricingOption"},"type":"array","maxItems":2,"minItems":2,"title":"Pricing"}},"additionalProperties":false,"type":"object","required":["model","display_name","controls","duration_seconds","aspect_ratios","reference_limits","pricing"],"title":"VideoPromptEnhancementModelCard"},"VideoPromptEnhancementRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"title":"Model","description":"Compatibility input only. Its value and type are ignored in the first release; Beatra resolves the available prompt-enhancement model internally.","default":"auto"},"prompt":{"type":"string","maxLength":7000,"minLength":1,"title":"Prompt","description":"Required creative intent to expand into a production-ready video prompt."},"duration":{"type":"integer","maximum":15.0,"minimum":4.0,"title":"Duration","description":"Target video duration in integer seconds."},"aspect_ratio":{"type":"string","enum":["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"],"title":"Aspect Ratio","description":"Target video aspect ratio. Text-only requests cannot use adaptive."},"first_frame":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},{"type":"null"}],"title":"First Frame","description":"Optional strict first-frame context image."},"last_frame":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},{"type":"null"}],"title":"Last Frame","description":"Optional strict last-frame context image."},"references":{"items":{"$ref":"#/components/schemas/VideoReference"},"type":"array","maxItems":11,"title":"References","description":"Optional ordered image, video, or audio context. Reference mode and strict-frame mode are mutually exclusive."}},"additionalProperties":false,"type":"object","required":["prompt","duration","aspect_ratio"],"title":"VideoPromptEnhancementRequest","description":"Model-neutral multimodal context for one enhanced video prompt."},"VideoPromptPricingOption":{"properties":{"meter":{"type":"string","enum":["input_token","output_token"],"title":"Meter"},"unit":{"type":"string","const":"token","title":"Unit","default":"token"},"unit_price_credits":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unit Price Credits"},"scale":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Scale"}},"additionalProperties":false,"type":"object","required":["meter","unit_price_credits","scale"],"title":"VideoPromptPricingOption"},"VideoReference":{"properties":{"kind":{"type":"string","enum":["image","video","audio"],"title":"Kind","description":"Declares whether this ordered reference is image, video, or audio."},"media":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"title":"Media","description":"Artifact, HTTPS URL, or data URI for this ordered reference.","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},"role":{"anyOf":[{"type":"string","enum":["subject","style","character","product","background","pose"]},{"type":"null"}],"title":"Role","description":"Optional semantic hint. Set it only when `beatra.models.list` advertises top-level `reference_roles` for the selected typed video model card; otherwise omit it and identify ordered references in the prompt."},"reference_voice":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},{"type":"null"}],"title":"Reference Voice","description":"Optional voice reference associated with this item when the selected model supports it."}},"additionalProperties":false,"type":"object","required":["kind","media"],"title":"VideoReference","description":"One ordered visual reference with optional semantic and voice guidance."},"VideoReferenceLimitsCard":{"properties":{"image":{"type":"integer","minimum":0.0,"title":"Image"},"video":{"type":"integer","minimum":0.0,"title":"Video"},"audio":{"type":"integer","minimum":0.0,"title":"Audio"},"video_total_seconds":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Video Total Seconds"},"audio_total_seconds":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Audio Total Seconds"},"audio_requires_image_or_video":{"type":"boolean","title":"Audio Requires Image Or Video","default":false}},"additionalProperties":false,"type":"object","required":["image","video","audio"],"title":"VideoReferenceLimitsCard"},"VideoSKUCard":{"properties":{"resolution":{"type":"string","title":"Resolution"},"duration_seconds":{"type":"integer","title":"Duration Seconds"}},"additionalProperties":false,"type":"object","required":["resolution","duration_seconds"],"title":"VideoSKUCard"},"VideoToTextRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model":{"type":"string","title":"Model","description":"Video-understanding model (`auto` or `MiniMax-M3`)."},"prompt":{"type":"string","maxLength":32000,"title":"Prompt"},"video":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/VideoUnderstandingDataUri"}],"title":"Video","description":"The single video input. Beatra samples internally at 1 fps, 0.5 fps from 120 seconds, and 0.2 fps from 240 seconds.","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/VideoUnderstandingDataUri","url":"#/components/schemas/MediaInputUrl"}}},"detail":{"type":"string","enum":["default","low","high"],"title":"Detail","description":"Visual detail preference. It does not change Beatra's per-second price.","default":"default"},"response_format":{"anyOf":[{"type":"string","enum":["text","json"]},{"type":"null"}],"title":"Response Format"},"temperature":{"anyOf":[{"type":"number","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Temperature"}},"additionalProperties":false,"type":"object","required":["model","prompt","video"],"title":"VideoToTextRequest"},"VideoUnderstandingDataUri":{"properties":{"type":{"type":"string","const":"data_uri","title":"Type"},"data":{"type":"string","maxLength":69905196,"title":"Data","description":"Base64 data URI. Decoded video content is limited to 50 MiB."}},"type":"object","required":["type","data"],"title":"VideoUnderstandingDataUri"},"VideoUrlContentPart":{"properties":{"type":{"type":"string","const":"video_url","title":"Type"},"video_url":{"$ref":"#/components/schemas/VideoUrlData"}},"type":"object","required":["type","video_url"],"title":"VideoUrlContentPart"},"VideoUrlData":{"properties":{"url":{"type":"string","title":"Url"},"detail":{"anyOf":[{"type":"string","enum":["auto","low","default","high"]},{"type":"null"}],"title":"Detail","default":"auto"},"fps":{"anyOf":[{"type":"number","maximum":5.0,"minimum":0.2},{"type":"null"}],"title":"Fps"},"max_frames":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Frames"},"max_long_side_pixel":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Long Side Pixel"}},"type":"object","required":["url"],"title":"VideoUrlData"},"VirtualCashierResultRequest":{"properties":{"cashier_token":{"type":"string","maxLength":64,"minLength":8,"title":"Cashier Token"},"result":{"type":"string","pattern":"^(ok|cancel|fail)$","title":"Result"}},"type":"object","required":["cashier_token","result"],"title":"VirtualCashierResultRequest"},"VirtualPayCreateRequest":{"properties":{"offer_id":{"type":"string","maxLength":128,"minLength":1,"title":"Offer Id"},"idempotency_key":{"type":"string","maxLength":128,"minLength":1,"title":"Idempotency Key"}},"type":"object","required":["offer_id","idempotency_key"],"title":"VirtualPayCreateRequest"},"VirtualPaySignRequest":{"properties":{"js_code":{"type":"string","maxLength":256,"minLength":1,"title":"Js Code"},"pay_ticket":{"type":"string","maxLength":64,"minLength":8,"title":"Pay Ticket"},"platform":{"type":"string","maxLength":32,"title":"Platform","default":""}},"type":"object","required":["js_code","pay_ticket"],"title":"VirtualPaySignRequest"},"VisitorContextResponse":{"properties":{"country_code":{"type":"string","title":"Country Code"},"country_source":{"type":"string","title":"Country Source"},"country_policy_key":{"type":"string","title":"Country Policy Key"},"country_policy_version":{"type":"integer","title":"Country Policy Version"},"locale":{"type":"string","title":"Locale"},"supported_locales":{"items":{"type":"string"},"type":"array","title":"Supported Locales"},"login_methods":{"$ref":"#/components/schemas/LoginMethodsResponse"},"currency":{"type":"string","title":"Currency"},"commercial_catalog_key":{"type":"string","title":"Commercial Catalog Key"},"visitor_context_token":{"type":"string","title":"Visitor Context Token"},"cn_wechat_one_tap":{"type":"boolean","title":"Cn Wechat One Tap","default":false}},"type":"object","required":["country_code","country_source","country_policy_key","country_policy_version","locale","supported_locales","login_methods","currency","commercial_catalog_key","visitor_context_token"],"title":"VisitorContextResponse"},"Voice":{"properties":{"voice_id":{"type":"string","title":"Voice Id","description":"Opaque beatra voice handle"},"display_name":{"type":"string","title":"Display Name"},"category":{"type":"string","enum":["preset","cloned"],"title":"Category"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"languages_supported":{"items":{"type":"string"},"type":"array","title":"Languages Supported"},"gender":{"anyOf":[{"type":"string","enum":["male","female","neutral"]},{"type":"null"}],"title":"Gender"},"age":{"anyOf":[{"type":"string","enum":["adult","child","elder"]},{"type":"null"}],"title":"Age"},"accent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accent"},"use_case":{"items":{"type":"string"},"type":"array","title":"Use Case"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url"},"compatible_models":{"items":{"type":"string"},"type":"array","title":"Compatible Models","description":"Models this voice currently resolves on (informational; 'auto' always works)"},"status":{"type":"string","enum":["processing","ready","failed"],"title":"Status","default":"ready"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["voice_id","display_name","category"],"title":"Voice"},"VoiceCloneConstraintsCard":{"properties":{"accepted_sample_kinds":{"items":{"type":"string","enum":["artifact","data_uri","https_url"]},"type":"array","title":"Accepted Sample Kinds"},"sample_min_seconds":{"type":"integer","const":10,"title":"Sample Min Seconds","default":10},"sample_max_seconds":{"type":"integer","const":300,"title":"Sample Max Seconds","default":300},"sample_max_bytes":{"type":"integer","const":20971520,"title":"Sample Max Bytes","default":20971520},"consent_attestation_required":{"type":"boolean","const":true,"title":"Consent Attestation Required","default":true},"automatic_formal_activation":{"type":"boolean","const":true,"title":"Automatic Formal Activation","default":true}},"additionalProperties":false,"type":"object","required":["accepted_sample_kinds"],"title":"VoiceCloneConstraintsCard"},"VoiceCloneRequest":{"properties":{"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Metadata","description":"Caller-supplied metadata; ≤16 keys, key ≤64 chars, value ≤512 chars"},"callback_url":{"anyOf":[{"type":"string","maxLength":2048,"pattern":"^https://"},{"type":"null"}],"title":"Callback Url","description":"HTTPS URL beatra will POST the final Task envelope to when the Task reaches a terminal state"},"callback_signing_key_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^whkey_[A-Za-z0-9]+$"},{"type":"null"}],"title":"Callback Signing Key Id","description":"Optional standalone callback signing key. Omit for unsigned callback delivery; requires callback_url when provided."},"model_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Model Options","description":"Per-model-family passthrough options; opaque to the platform, validated per model"},"sample":{"oneOf":[{"$ref":"#/components/schemas/MediaInputUrl"},{"$ref":"#/components/schemas/MediaInputArtifact"},{"$ref":"#/components/schemas/MediaInputDataUri"}],"title":"Sample","description":"Clean single-speaker voice sample (uploaded artifact or HTTPS URL), ~10s-5min","discriminator":{"propertyName":"type","mapping":{"artifact":"#/components/schemas/MediaInputArtifact","data_uri":"#/components/schemas/MediaInputDataUri","url":"#/components/schemas/MediaInputUrl"}}},"display_name":{"type":"string","maxLength":255,"minLength":1,"title":"Display Name"},"model":{"type":"string","enum":["auto","minimax-voice-clone"],"title":"Model","description":"Clone engine; 'auto' lets the platform choose","default":"auto"},"language":{"anyOf":[{"type":"string","maxLength":32,"minLength":2},{"type":"null"}],"title":"Language","description":"Optional BCP-47 language hint for the cloned voice"},"consent_attested":{"type":"boolean","const":true,"title":"Consent Attested","description":"Caller asserts it has the rights to clone this voice. Recorded, not verified."}},"additionalProperties":false,"type":"object","required":["sample","display_name","consent_attested"],"title":"VoiceCloneRequest"},"VoiceItem":{"properties":{"voice_id":{"type":"string","title":"Voice Id"},"display_name":{"type":"string","title":"Display Name"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"created_at":{"type":"string","title":"Created At"},"is_default":{"type":"boolean","title":"Is Default"},"avatar_count":{"type":"integer","title":"Avatar Count"},"has_same_name":{"type":"boolean","title":"Has Same Name"}},"type":"object","required":["voice_id","display_name","language","created_at","is_default","avatar_count","has_same_name"],"title":"VoiceItem"},"VoiceList":{"properties":{"object":{"type":"string","const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/Voice"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"VoiceList"},"VoiceListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/VoiceItem"},"type":"array","title":"Items"},"default_voice":{"anyOf":[{"$ref":"#/components/schemas/DefaultVoice"},{"type":"null"}]}},"type":"object","required":["items","default_voice"],"title":"VoiceListResponse"},"VoicePreviewResponse":{"properties":{"voice_id":{"type":"string","title":"Voice Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"kind":{"type":"string","enum":["preview","sample","none"],"title":"Kind"}},"type":"object","required":["voice_id","url","kind"],"title":"VoicePreviewResponse"},"VoiceRenameRequest":{"properties":{"display_name":{"type":"string","maxLength":200,"minLength":1,"title":"Display Name"}},"additionalProperties":false,"type":"object","required":["display_name"],"title":"VoiceRenameRequest"},"VoiceRenameResponse":{"properties":{"voice_id":{"type":"string","title":"Voice Id"},"display_name":{"type":"string","title":"Display Name"}},"type":"object","required":["voice_id","display_name"],"title":"VoiceRenameResponse"},"WechatJsSdkConfigRequest":{"properties":{"url":{"type":"string","maxLength":2048,"minLength":1,"title":"Url"}},"additionalProperties":false,"type":"object","required":["url"],"title":"WechatJsSdkConfigRequest"},"WechatJsSdkConfigResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"app_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Id"},"timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Timestamp"},"nonce_str":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nonce Str"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"}},"type":"object","required":["enabled"],"title":"WechatJsSdkConfigResponse","description":"What `wx.config` needs for one address, or `enabled: false`. The ticket stays in cn_gateway."},"WechatMiniProgramGrantRequest":{"properties":{"js_code":{"type":"string","maxLength":256,"minLength":1,"title":"Js Code"},"locale":{"anyOf":[{"type":"string","enum":["zh","en"]},{"type":"null"}],"title":"Locale"}},"additionalProperties":false,"type":"object","required":["js_code"],"title":"WechatMiniProgramGrantRequest"},"WechatMiniProgramGrantResponse":{"properties":{"ticket":{"type":"string","title":"Ticket"}},"type":"object","required":["ticket"],"title":"WechatMiniProgramGrantResponse"},"WechatMiniProgramRedeemRequest":{"properties":{"ticket":{"type":"string","maxLength":128,"minLength":32,"title":"Ticket"}},"additionalProperties":false,"type":"object","required":["ticket"],"title":"WechatMiniProgramRedeemRequest"},"WechatPayerCompleteRequest":{"properties":{"wechat_code":{"type":"string","maxLength":256,"minLength":1,"title":"Wechat Code"},"wechat_state":{"type":"string","maxLength":256,"minLength":1,"title":"Wechat State"}},"additionalProperties":false,"type":"object","required":["wechat_code","wechat_state"],"title":"WechatPayerCompleteRequest"},"WechatPayerCompleteResponse":{"properties":{"ok":{"type":"boolean","title":"Ok","default":true}},"type":"object","title":"WechatPayerCompleteResponse"},"WechatPayerStartRequest":{"properties":{"offer_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,128}$","title":"Offer Id"},"nonce":{"type":"string","pattern":"^[A-Za-z0-9_-]{8,40}$","title":"Nonce"},"back":{"anyOf":[{"type":"string","const":"ai"},{"type":"null"}],"title":"Back"},"locale":{"anyOf":[{"type":"string","enum":["zh","en","ja"]},{"type":"null"}],"title":"Locale"}},"additionalProperties":false,"type":"object","required":["offer_id","nonce"],"title":"WechatPayerStartRequest","description":"Where the silent authorize brings the browser back: the pay it was making."},"WechatPayerStartResponse":{"properties":{"authorize_url":{"type":"string","title":"Authorize Url"}},"type":"object","required":["authorize_url"],"title":"WechatPayerStartResponse"},"WorkShareCreateRequest":{"properties":{"artifact_id":{"type":"string","maxLength":64,"minLength":1,"title":"Artifact Id"},"skill":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Skill"}},"additionalProperties":false,"type":"object","required":["artifact_id"],"title":"WorkShareCreateRequest"},"WorkShareCreatedResponse":{"properties":{"share_id":{"type":"string","title":"Share Id"}},"type":"object","required":["share_id"],"title":"WorkShareCreatedResponse"},"WorkSharePageResponse":{"properties":{"media":{"type":"string","enum":["image","video","audio"],"title":"Media"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"skill":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill"},"src":{"type":"string","title":"Src"},"poster":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Poster"}},"type":"object","required":["media","src"],"title":"WorkSharePageResponse","description":"A work someone can look at. There is no file to save."},"WorkShareStateResponse":{"properties":{"share_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Id"}},"type":"object","title":"WorkShareStateResponse","description":"The owner's open link for a work; null when it was never shared or is closed."},"app__api__account__schemas__TaskError":{"properties":{"code":{"type":"string","title":"Code"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data","description":"Provider-neutral failure details after recursive supply declassification."}},"type":"object","required":["code"],"title":"TaskError"},"app__api__account__schemas__TaskListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TaskListItem"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"TaskListResponse"},"app__api__account__schemas__TaskProgress":{"properties":{"percent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Percent"},"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"TaskProgress"},"app__api__v1__schemas__common__TaskError":{"properties":{"code":{"type":"string","title":"Code","description":"Stable machine-readable public error code."},"type":{"type":"string","title":"Type","description":"Stable public error family."},"message":{"type":"string","title":"Message","description":"Human-readable safe failure reason."},"retryable":{"type":"boolean","title":"Retryable","description":"Whether the same logical request may succeed when retried unchanged."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Param","description":"JSON Pointer to the relevant request or output field."},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details","description":"Provider-neutral expected, received, supported, or candidate failure facts."},"request_id":{"type":"string","title":"Request Id","description":"Request trace identifier for support and correlation."}},"type":"object","required":["code","type","message","retryable","request_id"],"title":"TaskError"},"app__api__v1__schemas__common__TaskProgress":{"properties":{"percent":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Percent"},"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"TaskProgress"},"app__api__v1__schemas__tasks__TaskListResponse":{"properties":{"object":{"type":"string","const":"list","title":"Object","default":"list"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data","description":"TaskSummary[] by default; TaskEnvelope[] with expand"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More","default":false}},"type":"object","required":["data"],"title":"TaskListResponse","description":"List response wrapper. Uses TaskSummary by default.\n\nClients can opt-in to richer detail via `?expand=output,usage,billing,callback,input`\nor `?expand=all`. When expand is in effect, items become full TaskEnvelope."}}}}