{"openapi":"3.1.0","info":{"title":"MusCap Agent-Skill 智能联动系统","description":"## MusCap 音乐创作与外部 Agent 接入\nMusCap 围绕用户的想法、故事、部分歌词或完整歌词，协作完善歌词、歌名和配乐要求，生成并保存音乐作品。\n这里的委托创作是用户授权外部 Agent 与平台创作引擎协作，不是宣称提供真人代写服务。\n当前为小范围测试环境，非正式商用发布；正式域名和源码公开发布均后置。\n匿名接入说明：https://staging.muscap.me/agents\n实际开放能力：https://api-staging.muscap.me/api/v3/agent/capabilities\n接口被列出不等于功能已开放；能力清单不可读取时，不创建连接或发起创作。\n仅了解服务无需注册、不调用模型、不消耗创作额度。开始连接时由用户本人注册或登录，核对邀请并点击“授权连接”，才建立账号绑定。\n登录、输入连接码或领取测试额度均不等于授权；连接不收费，也不自动批准生成、充值或额外付费。\n测试账号由平台按本轮名单单独发放测试额度；不要求真实充值，不因发放额度而开放创作权限。\n发现与连接就绪不代表创作流程已开放。请只使用能力清单标为可用的接口。\n不提供未经核实的公开仓库、邮箱或域名作为身份依据。","termsOfService":"https://staging.muscap.me/legal/terms","license":{"name":"MIT License"},"version":"1.2.0"},"paths":{"/api/v2/agent-connect/status":{"get":{"tags":["🔗 Agent Connect","Agent Connect"],"summary":"Agent 自动核对自己的连接与账号；无需用户再次确认","operationId":"connection_status_api_v2_agent_connect_status_get","parameters":[{"name":"task","in":"query","required":false,"schema":{"anyOf":[{"enum":["music_creation","material_delivery","work_images","account_creative"],"type":"string"},{"type":"null"}],"title":"Task"}},{"name":"view","in":"query","required":false,"schema":{"enum":["full","connection"],"type":"string","default":"full","title":"View"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v3/agent/activities/{activity_id}/works":{"get":{"tags":["Agent owner account creative"],"summary":"Get Activity Works","operationId":"get_activity_works_api_v3_agent_activities__activity_id__works_get","parameters":[{"name":"activity_id","in":"path","required":true,"schema":{"type":"string","title":"Activity Id"}},{"name":"after_position","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"After Position"}},{"name":"after_draft_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"After Draft Id"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v3/agent/creative-objects":{"get":{"tags":["Agent owner account creative"],"summary":"Find Objects","operationId":"find_objects_api_v3_agent_creative_objects_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v3/agent/creative-objects/{kind}/{object_id}":{"get":{"tags":["Agent owner account creative"],"summary":"Read Object","operationId":"read_object_api_v3_agent_creative_objects__kind___object_id__get","parameters":[{"name":"kind","in":"path","required":true,"schema":{"enum":["work","draft","notebook"],"type":"string","title":"Kind"}},{"name":"object_id","in":"path","required":true,"schema":{"type":"string","title":"Object Id"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}},"post":{"tags":["Agent owner account creative"],"summary":"Update Object","operationId":"update_object_api_v3_agent_creative_objects__kind___object_id__post","parameters":[{"name":"kind","in":"path","required":true,"schema":{"enum":["work","draft","notebook"],"type":"string","title":"Kind"}},{"name":"object_id","in":"path","required":true,"schema":{"type":"string","title":"Object Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/AccountCommand"}}}},"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v3/agent/drafts/{draft_id}/image-uploads/{upload_id}":{"get":{"tags":["Agent private work images"],"summary":"Get Draft Upload","operationId":"get_draft_upload_api_v3_agent_drafts__draft_id__image_uploads__upload_id__get","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/drafts/{draft_id}/images":{"get":{"tags":["Agent private work images"],"summary":"Read Draft Images","operationId":"read_draft_images_api_v3_agent_drafts__draft_id__images_get","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}},"post":{"tags":["Agent private work images"],"summary":"Save Draft Images","operationId":"save_draft_images_api_v3_agent_drafts__draft_id__images_post","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/SaveDraftImagesRequest"}}}},"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/materials/{receipt_id}":{"get":{"tags":["Agent Material Delivery"],"summary":"读取本 Agent 自己递交材料的回执","operationId":"agent_material_receipt_api_v3_agent_materials__receipt_id__get","parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","title":"Receipt Id"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v3/agent/work-card":{"get":{"tags":["Agent WorkSpec"],"summary":"Get Card","operationId":"get_card_api_v3_agent_work_card_get","parameters":[{"name":"goal","in":"query","required":false,"schema":{"anyOf":[{"enum":["music","spoken","package"],"type":"string"},{"type":"null"}],"title":"Goal"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"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/WorkReceipt"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/work-specs/{spec_id}":{"get":{"tags":["Agent WorkSpec"],"summary":"Wait Work Spec","description":"Current view; with wait=true returns when something needs the Agent or the work is done.","operationId":"wait_work_spec_api_v3_agent_work_specs__spec_id__get","parameters":[{"name":"spec_id","in":"path","required":true,"schema":{"type":"string","title":"Spec Id"}},{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Hold while the platform works or the owner confirms rights; return on done / other needs_input / failed.","default":false,"title":"Wait"},"description":"Hold while the platform works or the owner confirms rights; return on done / other needs_input / failed."},{"name":"max_seconds","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":25,"title":"Max Seconds"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"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/WorkReceipt"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}},"post":{"tags":["Agent WorkSpec"],"summary":"Submit Work Spec","description":"Update the spec; fields you send replace stored ones, omitted fields are kept.","operationId":"submit_work_spec_api_v3_agent_work_specs__spec_id__post","parameters":[{"name":"spec_id","in":"path","required":true,"schema":{"type":"string","title":"Spec Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":120,"description":"One key per intent (8–120 characters). Reuse it only to retry the same call.","title":"Idempotency-Key"},"description":"One key per intent (8–120 characters). Reuse it only to retry the same call."},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/SubmitWork"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkReceipt"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/works/{work_id}/image-uploads/{upload_id}":{"get":{"tags":["Agent private work images"],"summary":"Get Image Upload","operationId":"get_image_upload_api_v3_agent_works__work_id__image_uploads__upload_id__get","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","title":"Work Id"}},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/works/{work_id}/images":{"get":{"tags":["Agent private work images"],"summary":"Get Images","operationId":"get_images_api_v3_agent_works__work_id__images_get","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","title":"Work Id"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}},"post":{"tags":["Agent private work images"],"summary":"Save Images","operationId":"save_images_api_v3_agent_works__work_id__images_post","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","title":"Work Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/SaveImagesRequest"}}}},"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v2/agent-connect/poll":{"post":{"tags":["🔗 Agent Connect","Agent Connect"],"summary":"自动等待授权；授权后本接口一次性返回首次凭据，不再调用 token 换取","operationId":"poll_pairing_api_v2_agent_connect_poll_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PollRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v2/agent-connect/requests":{"post":{"tags":["🔗 Agent Connect","Agent Connect"],"summary":"发起连接邀请：将 connect_url 原样交给用户，并自动轮询","description":"One owner approval of the displayed scope; no grant or fee on invitation.\n\nIn normal account-balance creation, omitted scope flags request the current\ncomplete creative bundle. Explicit flags retain the old narrow request.\nExisting grants and invitations are never expanded by a read or refresh.","operationId":"start_pairing_api_v2_agent_connect_requests_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartPairingRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v2/agent-connect/token":{"post":{"tags":["🔗 Agent Connect","Agent Connect"],"summary":"仅用已有 refresh_token 自动续期；不是首次领取凭据","operationId":"refresh_agent_token_api_v2_agent_connect_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v3/agent/activities":{"post":{"tags":["Agent owner account creative"],"summary":"Start Activity","description":"Create an ordinary owner notebook/context using existing account authority.","operationId":"start_activity_api_v3_agent_activities_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/StartActivity"}}}},"responses":{"201":{"description":"Successful Response"},"422":{"description":"Validation Error"}}}},"/api/v3/agent/drafts/{draft_id}/image-uploads":{"post":{"tags":["Agent private work images"],"summary":"Start Draft Image","operationId":"start_draft_image_api_v3_agent_drafts__draft_id__image_uploads_post","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/ImageUploadRequest"}}}},"responses":{"201":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/drafts/{draft_id}/image-uploads/{upload_id}/complete":{"post":{"tags":["Agent private work images"],"summary":"Complete Draft Image","operationId":"complete_draft_image_api_v3_agent_drafts__draft_id__image_uploads__upload_id__complete_post","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/ImageCompleteRequest"}}}},"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/materials":{"post":{"tags":["Agent Material Delivery"],"summary":"仅递交材料到创作本：无需指定作品类型，不生成、不扣额度","operationId":"agent_material_delivery_api_v3_agent_materials_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/AgentMaterialDelivery"}}}},"responses":{"201":{"description":"Successful Response"},"200":{"description":"Original receipt; no duplicate materials or credits."},"422":{"description":"Validation Error"}}}},"/api/v3/agent/work-specs":{"post":{"tags":["Agent WorkSpec"],"summary":"Create Work Spec","description":"New work. Own lyrics/text + action=generate is the whole job in one call; then wait.","operationId":"create_work_spec_api_v3_agent_work_specs_post","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":120,"description":"One key per intent (8–120 characters). Reuse it only to retry the same call.","title":"Idempotency-Key"},"description":"One key per intent (8–120 characters). Reuse it only to retry the same call."},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/SubmitWork"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkReceipt"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/work-specs/{spec_id}/cancel":{"post":{"tags":["Agent WorkSpec"],"summary":"Cancel Work Spec","description":"Stop a generation that has not reached the model yet; credits come back, the text stays.","operationId":"cancel_work_spec_api_v3_agent_work_specs__spec_id__cancel_post","parameters":[{"name":"spec_id","in":"path","required":true,"schema":{"type":"string","title":"Spec Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":120,"description":"One key per intent (8–120 characters). Reuse it only to retry the same call.","title":"Idempotency-Key"},"description":"One key per intent (8–120 characters). Reuse it only to retry the same call."},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"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/WorkReceipt"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/work-specs/{spec_id}/discuss":{"post":{"tags":["Agent WorkSpec"],"summary":"Discuss Work Spec","description":"Talk with the platform writer (full candidate back, self-checked) or patch lines.","operationId":"discuss_work_spec_api_v3_agent_work_specs__spec_id__discuss_post","parameters":[{"name":"spec_id","in":"path","required":true,"schema":{"type":"string","title":"Spec Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":120,"description":"One key per intent (8–120 characters). Reuse it only to retry the same call.","title":"Idempotency-Key"},"description":"One key per intent (8–120 characters). Reuse it only to retry the same call."},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/DiscussWork"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkReceipt"}}}},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/works/{work_id}/image-uploads":{"post":{"tags":["Agent private work images"],"summary":"Start Image Upload","operationId":"start_image_upload_api_v3_agent_works__work_id__image_uploads_post","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","title":"Work Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/ImageUploadRequest"}}}},"responses":{"201":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/works/{work_id}/image-uploads/{upload_id}/cancel":{"post":{"tags":["Agent private work images"],"summary":"Cancel Image","operationId":"cancel_image_api_v3_agent_works__work_id__image_uploads__upload_id__cancel_post","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","title":"Work Id"}},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/works/{work_id}/image-uploads/{upload_id}/complete":{"post":{"tags":["Agent private work images"],"summary":"Complete Image","operationId":"complete_image_api_v3_agent_works__work_id__image_uploads__upload_id__complete_post","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","title":"Work Id"}},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-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/ImageCompleteRequest"}}}},"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/drafts/{draft_id}/image-uploads/{upload_id}/parts/{part_number}":{"put":{"tags":["Agent private work images"],"summary":"Put Draft Image","operationId":"put_draft_image_api_v3_agent_drafts__draft_id__image_uploads__upload_id__parts__part_number__put","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"part_number","in":"path","required":true,"schema":{"type":"integer","title":"Part Number"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}},"/api/v3/agent/works/{work_id}/image-uploads/{upload_id}/parts/{part_number}":{"put":{"tags":["Agent private work images"],"summary":"Put Image Part","operationId":"put_image_part_api_v3_agent_works__work_id__image_uploads__upload_id__parts__part_number__put","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","title":"Work Id"}},{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"part_number","in":"path","required":true,"schema":{"type":"integer","title":"Part Number"}},{"name":"X-MusCap-Integration-Channel","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Muscap-Integration-Channel"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"Authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"402":{"description":"Payment Required"},"403":{"description":"Forbidden"},"404":{"description":"Not Found"},"409":{"description":"Conflict"},"412":{"description":"Precondition Failed"},"422":{"description":"Unprocessable Entity"},"429":{"description":"Too Many Requests"},"500":{"description":"Internal Server Error"},"503":{"description":"Service Unavailable"}}}}},"components":{"schemas":{"AccountCommand":{"properties":{"resume_responsibility":{"type":"boolean","title":"Resume Responsibility","description":"Only when the owner explicitly assigns this work back to a previously replaced Agent. Ordinary writes, transport retries and new idempotency keys do not reclaim responsibility. No additional human approval; original task, version, permission and expense checks still apply.","default":false},"source_event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Source Event Id"},"version":{"type":"integer","minimum":1.0,"title":"Version"},"action":{"type":"string","enum":["rename","supplement_text","new_music_from_work","configure_series_context"],"title":"Action"},"title":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string","maxLength":100000,"minLength":1},{"type":"null"}],"title":"Text"},"series_context":{"anyOf":[{"$ref":"#/components/schemas/SeriesContextCommand"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["source_event_id","version","action"],"title":"AccountCommand"},"AgentMaterialDelivery":{"properties":{"source_event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Source Event Id"},"title":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Title"},"materials":{"items":{"$ref":"#/components/schemas/AgentTextMaterial"},"type":"array","maxItems":20,"minItems":1,"title":"Materials"},"notebook_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Notebook Id","description":"Only a notebook previously created by this Agent's material deliveries; not an arbitrary account notebook."},"notebook_version":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Notebook Version"}},"additionalProperties":false,"type":"object","required":["source_event_id","materials"],"title":"AgentMaterialDelivery"},"AgentTextMaterial":{"properties":{"kind":{"type":"string","enum":["text","lyrics","music_prompt","photo_note","voice_transcript"],"title":"Kind","default":"text"},"text":{"type":"string","maxLength":10000,"minLength":1,"title":"Text"}},"additionalProperties":false,"type":"object","required":["text"],"title":"AgentTextMaterial"},"DiscussWork":{"properties":{"message":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Message","description":"Talk with the platform writer; returns a full candidate."},"patch":{"anyOf":[{"items":{"$ref":"#/components/schemas/LinePatch"},"type":"array","maxItems":200},{"type":"null"}],"title":"Patch","description":"Edit the candidate (or current text) by line, without a model call."},"option_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Option Id","description":"Answer a question from the last receipt."},"rewrite":{"type":"boolean","title":"Rewrite","description":"Allow the platform to rewrite existing lyrics freely.","default":false}},"additionalProperties":false,"type":"object","title":"DiscussWork"},"ImageCompleteRequest":{"properties":{"parts":{"items":{"$ref":"#/components/schemas/CompletePart"},"type":"array","minItems":1,"title":"Parts"},"source_event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Source Event Id"}},"additionalProperties":false,"type":"object","required":["parts","source_event_id"],"title":"ImageCompleteRequest"},"CompletePart":{"properties":{"part_number":{"type":"integer","minimum":1.0,"title":"Part Number"},"etag":{"type":"string","maxLength":255,"minLength":1,"title":"Etag"}},"additionalProperties":false,"type":"object","required":["part_number","etag"],"title":"CompletePart"},"ImageUploadRequest":{"properties":{"source_event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Source Event Id"},"role":{"type":"string","enum":["cover","photo"],"title":"Role"},"file":{"$ref":"#/components/schemas/UploadFileSpec"}},"additionalProperties":false,"type":"object","required":["source_event_id","role","file"],"title":"ImageUploadRequest"},"LinePatch":{"properties":{"line":{"type":"integer","minimum":1.0,"title":"Line","description":"1-based line number in the text shown in the last receipt."},"op":{"type":"string","enum":["replace","delete","insert_after"],"title":"Op","default":"replace"},"text":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Text"}},"additionalProperties":false,"type":"object","required":["line"],"title":"LinePatch"},"PollRequest":{"properties":{"session_id":{"type":"string","title":"Session Id"},"poll_secret":{"type":"string","maxLength":200,"minLength":32,"title":"Poll Secret"},"delivery_secret":{"anyOf":[{"type":"string","maxLength":200,"minLength":43},{"type":"null"}],"title":"Delivery Secret"}},"additionalProperties":false,"type":"object","required":["session_id","poll_secret"],"title":"PollRequest"},"RefreshRequest":{"properties":{"refresh_token":{"type":"string","maxLength":300,"minLength":32,"title":"Refresh Token"}},"additionalProperties":false,"type":"object","required":["refresh_token"],"title":"RefreshRequest"},"SaveDraftImagesRequest":{"properties":{"resume_responsibility":{"type":"boolean","title":"Resume Responsibility","description":"Only when the owner explicitly assigns this work back to a previously replaced Agent. Ordinary writes, transport retries and new idempotency keys do not reclaim responsibility. No additional human approval; original task, version, permission and expense checks still apply.","default":false},"source_event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Source Event Id"},"draft_version":{"type":"integer","minimum":1.0,"title":"Draft Version"},"cover_asset_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Cover Asset Id"},"append_photo_asset_ids":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Append Photo Asset Ids"},"photo_asset_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Photo Asset Ids"}},"additionalProperties":false,"type":"object","required":["source_event_id","draft_version"],"title":"SaveDraftImagesRequest"},"SaveImagesRequest":{"properties":{"source_event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Source Event Id"},"work_version":{"type":"integer","minimum":1.0,"title":"Work Version"},"base_revision_id":{"type":"string","maxLength":64,"minLength":1,"title":"Base Revision Id"},"cover_asset_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Cover Asset Id"},"append_photo_asset_ids":{"items":{"type":"string"},"type":"array","maxItems":20,"title":"Append Photo Asset Ids"},"photo_asset_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Photo Asset Ids","description":"Complete ordered displayed photo list; replaces references only, retaining all original assets and revisions. Cannot combine with append."}},"additionalProperties":false,"type":"object","required":["source_event_id","work_version","base_revision_id"],"title":"SaveImagesRequest"},"SeriesContextCommand":{"properties":{"update_mode":{"type":"string","enum":["replace","merge"],"title":"Update Mode","description":"merge inherits omitted requirements, summary and source links from the latest immutable snapshot; explicit empty values clear them. Key point deltas always require explicit confirmation. Existing works are not rebound.","default":"replace"},"requirements":{"type":"string","maxLength":6000,"title":"Requirements","default":""},"summary":{"type":"string","maxLength":6000,"title":"Summary","default":""},"source_link_ids":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Source Link Ids"},"key_point_updates":{"items":{"$ref":"#/components/schemas/SeriesKeyPointUpdate"},"type":"array","maxItems":32,"title":"Key Point Updates"},"remove_key_point_keys":{"items":{"type":"string"},"type":"array","maxItems":32,"title":"Remove Key Point Keys"}},"additionalProperties":false,"type":"object","title":"SeriesContextCommand"},"SeriesKeyPointUpdate":{"properties":{"key":{"type":"string","maxLength":64,"minLength":1,"title":"Key"},"text":{"type":"string","maxLength":1500,"minLength":1,"title":"Text"},"kind":{"type":"string","enum":["fictional_setting","creative_decision","user_assertion"],"title":"Kind"},"source_kind":{"type":"string","enum":["completed_work","activity_confirmation"],"title":"Source Kind","default":"completed_work"},"source_work_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Source Work Id"},"source_revision_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Source Revision Id"},"source_dialogue_evidence_id":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Source Dialogue Evidence Id","description":"Optional exact owned dialogue source for an explicitly confirmed activity key point; not automatic adoption or a verified life fact."},"confirmed":{"type":"boolean","const":true,"title":"Confirmed"}},"additionalProperties":false,"type":"object","required":["key","text","kind","confirmed"],"title":"SeriesKeyPointUpdate"},"StartActivity":{"properties":{"source_event_id":{"type":"string","maxLength":128,"minLength":1,"title":"Source Event Id"},"title":{"type":"string","maxLength":80,"minLength":1,"title":"Title"},"series_context":{"$ref":"#/components/schemas/SeriesContextCommand"}},"additionalProperties":false,"type":"object","required":["source_event_id","title"],"title":"StartActivity"},"StartPairingRequest":{"properties":{"agent_name":{"type":"string","maxLength":100,"minLength":1,"title":"Agent Name"},"agent_product_id":{"type":"string","maxLength":150,"minLength":1,"title":"Agent Product Id"},"installation_id":{"type":"string","maxLength":200,"minLength":8,"title":"Installation Id"},"agent_version":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Agent Version"},"platform":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Platform"},"integration_channel":{"type":"string","enum":["mcp","rest"],"title":"Integration Channel","default":"rest"},"material_delivery":{"type":"boolean","title":"Material Delivery","description":"Request opt-in text material delivery; user must approve the displayed scope. Does not permit generation or formal work creation. When ALL scope fields are omitted and normal account-balance creation with images is available, the invitation displays the complete current creative bundle for one owner approval. Explicit scope fields preserve the requested narrow scope; existing grants never auto-expand.","default":false},"work_images":{"type":"boolean","title":"Work Images","description":"Opt-in covers/photos on this Agent's own private completed songs; no audio, publication or extra payment.","default":false},"account_creative":{"type":"boolean","title":"Account Creative","description":"Explicit owner-account creative opt-in: find and update own works/drafts across creators; never delete or publish. Includes text material delivery and work images, so those scopes are granted with it. New music requires approved music scope and the owner's available shared balance in account-balance mode.","default":false},"music_creation":{"type":"boolean","title":"Music Creation","description":"Request ongoing private music creation using the owner's shared account balance; owner must explicitly approve this scope.","default":false},"music_maximum_credits":{"anyOf":[{"type":"integer","maximum":20.0,"minimum":1.0},{"type":"null"}],"title":"Music Maximum Credits","description":"Legacy invitation field retained for compatibility only; not the current creation budget. New clients use music_creation=true and the owner's shared account balance, without Agent-specific song or time limits.","deprecated":true},"delivery_secret":{"anyOf":[{"type":"string","maxLength":200,"minLength":43},{"type":"null"}],"title":"Delivery Secret","description":"Optional client-generated random secret (at least 32 random bytes, URL-safe encoded), kept outside chat. Enables bounded encrypted delivery recovery."},"expected_account_phone":{"anyOf":[{"type":"string","pattern":"^1\\d{10}$"},{"type":"null"}],"title":"Expected Account Phone","description":"The mainland mobile number the user told this Agent to bind. When present, only that MusCap account can open or approve the invitation; any other signed-in account gets agent.account_mismatch and nothing is bound. Never echoed back; responses show only a masked hint."}},"additionalProperties":false,"type":"object","required":["agent_name","agent_product_id","installation_id"],"title":"StartPairingRequest"},"SubmitWork":{"properties":{"spec":{"$ref":"#/components/schemas/WorkSpec"},"action":{"type":"string","enum":["draft","generate"],"title":"Action","description":"draft: prepare/write, never charges music. generate: finalize text, set direction, reserve credits and accept generation in one step."}},"additionalProperties":false,"type":"object","required":["spec","action"],"title":"SubmitWork"},"UploadFileSpec":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"byte_size":{"type":"integer","exclusiveMinimum":0.0,"title":"Byte Size"},"declared_mime_type":{"type":"string","maxLength":120,"minLength":3,"title":"Declared Mime Type"},"sha256":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[a-f0-9]{64}$","title":"Sha256"}},"additionalProperties":false,"type":"object","required":["name","byte_size","declared_mime_type","sha256"],"title":"UploadFileSpec"},"WorkReceipt":{"properties":{"data":{"additionalProperties":true,"type":"object","title":"Data"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["data","meta"],"title":"WorkReceipt"},"WorkSpec":{"properties":{"goal":{"type":"string","enum":["music","spoken"],"title":"Goal","description":"Fixed when the work is created. package is not open yet.","default":"music"},"intent":{"type":"string","maxLength":12000,"title":"Intent","description":"Owner's words, kept verbatim. May be empty.","default":""},"title":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Title"},"text":{"anyOf":[{"type":"string","maxLength":100000},{"type":"null"}],"title":"Text","description":"Complete lyrics, or the complete spoken script. Music: omit to have the platform write (or keep the current text)."},"requirements":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requirements","description":"Free-form writing requirements for the platform text model; at most 4000 UTF-8 bytes."},"direction":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Direction","description":"Free description, delivered verbatim to the music or voice model (sha256 reported)."},"voice":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Voice","description":"Spoken: platform voice id from the card, or 'none'. Omitted: the card's default voice."},"background_music":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Background Music","description":"Spoken: background track code from the card, or 'none' (default)."},"speech_rate":{"anyOf":[{"type":"number","maximum":2.0,"minimum":0.5},{"type":"null"}],"title":"Speech Rate","description":"Spoken: 1.0 is normal."},"checks":{"items":{"$ref":"#/components/schemas/WorkCheck"},"type":"array","maxItems":32,"title":"Checks"},"targets":{"$ref":"#/components/schemas/WorkTargets"},"authority":{"$ref":"#/components/schemas/WorkAuthority"}},"additionalProperties":false,"type":"object","title":"WorkSpec"},"WorkAuthority":{"properties":{"accept_unmet_checks":{"type":"boolean","title":"Accept Unmet Checks","description":"With action=generate: generate even if a check is unmet; unmet checks are recorded.","default":false},"maximum_credits":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Maximum Credits","description":"Optional cap; generation stops before reserving if the quote is higher."}},"additionalProperties":false,"type":"object","title":"WorkAuthority"},"WorkCheck":{"properties":{"id":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Id","description":"Optional; defaults to c1, c2… in order."},"kind":{"type":"string","enum":["forbidden_word","occurrences","max_line_chars","line_count","identical_sections","required_section"],"title":"Kind"},"term":{"anyOf":[{"type":"string","maxLength":128,"minLength":1},{"type":"null"}],"title":"Term","description":"forbidden_word / occurrences: the exact word; identical_sections / required_section: section label, e.g. 副歌."},"minimum":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":0.0},{"type":"null"}],"title":"Minimum"},"maximum":{"anyOf":[{"type":"integer","maximum":1000.0,"minimum":0.0},{"type":"null"}],"title":"Maximum"}},"additionalProperties":false,"type":"object","required":["kind"],"title":"WorkCheck"},"WorkTargets":{"properties":{"duration_seconds":{"anyOf":[{"type":"integer","maximum":3600.0,"minimum":15.0},{"type":"null"}],"title":"Duration Seconds","description":"Music 30–600, spoken 15–3600. best_effort: passed to the model; actual duration and deviation are reported."},"deadline":{"type":"string","enum":["now","flexible"],"title":"Deadline","description":"Music only, same price. flexible: yields its queue turn to now work for up to 10 minutes; the receipt eta shows the applied lane.","default":"now"}},"additionalProperties":false,"type":"object","title":"WorkTargets"}},"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v2/auth/login"}}}}}}