{"product_name":"Compeller","description":"Compeller is the AI show pipeline for live music: generate audio-reactive visuals from tracks, then perform them live through REACT on streams, stages, projectors, LED walls, CDJ-connected setups, NDI, and DMX lighting.","base_url":"https://compeller.ai","api_base":"https://compeller.ai/api/v1","openapi_url":"https://compeller.ai/api/v1/openapi.yaml","mcp_endpoint":"https://compeller.ai/api/mcp","mcp_docs_url":"https://compeller.ai/api/mcp/docs","mcp_protocol":"json-rpc-2.0","mcp_transport":"streamable-http","docs_url":"https://compeller.ai/for-agents","llms_url":"https://compeller.ai/llms.txt","music_search":{"source":"deezer_preview","search_url":"https://compeller.ai/api/v1/music/search?q={query}","create_url":"https://compeller.ai/api/v1/compels/from-music","guidance":"If the user provides only a song/artist string, search music first and create the compel from the selected preview. If they provide MP3/WAV/FLAC, upload the file instead."},"account":{"credits_url":"https://compeller.ai/api/v1/account/credits","guidance":"Call before starting a render if you need to preflight quota. If a compel response has failure_reason=account_quota_exceeded, tell the user to top up or upgrade via billing_url, then retry start-render."},"long_running_jobs":{"check_back_after_seconds":600,"guidance":"Save the compel id. If status is QUEUED, PROCESSING, RENDERING, or VALIDATING, stop active polling and check back in about 10 minutes with GET /api/v1/compels/{id}. Use events_url for diagnostics, not provider internals.","public_task_types":["AUDIO_ANALYSIS","AUDIO_TRANSCRIPTION","SCENE_PLANNING","IMAGE_GENERATION","SCENE_ANALYSIS","CLIP_GENERATION","FINAL_RENDER"]},"react":{"name":"REACT by Compeller.ai","description":"Free live performance system for experiencing compels as real-time audio-reactive visual shows.","learn_more":"https://compeller.ai/react","download_url":"https://compeller.ai/download/desktop"},"well_known":{"ai_plugin":"https://compeller.ai/.well-known/ai-plugin.json","mcp":"https://compeller.ai/.well-known/mcp.json"},"media_limits":{"audio_formats":["mp3","wav","flac"],"max_file_size_mb":100,"max_duration_seconds":600},"rate_limits":{"policy":"adaptive","retry_after":"Honor HTTP 429 Retry-After when present. Back off exponentially otherwise."},"authentication":{"type":"bearer","header":"Authorization","scheme":"Bearer","alt_header":"X-API-Token","login_url":"https://compeller.ai/api/login","token_url":"https://compeller.ai/api/v1/auth/token","login_alias_url":"https://compeller.ai/api/v1/login","signup_url":"https://compeller.ai/api/v1/auth/signup","note":"Canonical login is POST /api/login with username/password. Compatibility aliases POST /api/v1/auth/token and POST /api/v1/login accept email or username with password. New agents can self-serve at POST /api/v1/auth/signup."},"signup_url":"https://compeller.ai/api/v1/auth/signup","signup_policy":{"verification":"deferred","one_account_per_agent":true,"installation_id_header":"X-Agent-Installation-Id","guidance":"Sign up once. Persist the token securely. Reuse the token or call /api/v1/auth/token; do not create repeated accounts.","abuse_response":"HTTP 429 or 403 application/problem+json; existing tokens are unaffected unless explicitly revoked.","reputation_model":{"rewards":"Reusing the same account and token across runs builds reputation over time. Trust ramps up automatically as your agent calls succeed without abuse signals.","penalties":"Creating multiple accounts to game free minutes -- especially with rotating X-Agent-Installation-Id values from the same network -- is throttled and may be flagged.","shared_sdk_ok":"Many agents share the same TLS handshake fingerprint, hosted-agent proxy traits, or NAT source when they use the same SDK, desktop app, or cloud agent runner. A collision alone is not a penalty signal. X-Agent-Installation-Id is stored separately from browser fingerprints; Compeller looks at combinations (TLS fingerprint + IP range + rotating install id + signup velocity), not single dimensions.","multi_user_sdks":"If your product exposes Compeller to multiple end-users, each end-user should have their own Compeller account with their own X-Agent-Installation-Id. Do not share one Compeller account across many of your customers."}},"capabilities":["compel.create","compel.get","compel.list","compel.search","compel.cancel","compel.start_render","music_video_generation","rendering.get","rendering.list_for_compel","rendering.download","media.upload","music.search","music.create_compel","account.credits","media.search","webhooks.register","webhooks.list","webhooks.update","webhooks.delete","webhooks.test","webhooks.rotate_secret"],"webhooks":{"events":["compel.completed","compel.failed"],"signature":{"header":"X-Compeller-Signature","algorithm":"HMAC-SHA256","encoding":"sha256=<hex>"},"test_event":"webhook.test","lifecycle":{"register":"POST /api/v1/webhooks","list":"GET /api/v1/webhooks","show":"GET /api/v1/webhooks/{id}","update":"PATCH /api/v1/webhooks/{id}","delete":"DELETE /api/v1/webhooks/{id}","test":"POST /api/v1/webhooks/{id}/test","rotate_secret":"POST /api/v1/webhooks/{id}/rotate-secret"}}}