{ "name": "Cartesia (Sonic)", "slug": "cartesia", "website_url": "https://cartesia.ai", "vendor_description": "\"The fastest and most natural text to speech model\"", "categories": [ "text-to-speech" ], "summary": "Cartesia's Sonic API is a text-to-speech service built for low-latency voice applications such as conversational AI agents, customer support, dubbing, and audiobook narration, with a reported first-audio-byte latency of 90ms on Sonic 3.5. Pricing starts at $50 per million characters with a free tier of 20,000 characters per month, and self-serve signup is available without a sales call. The API supports REST and WebSocket streaming, instant voice cloning on all plans, and deploys across cloud regions, on-premises, and on-device. Cartesia holds SOC 2 Type II, HIPAA, GDPR, and PCI DSS certifications, and counts Quora, Cresta, and Rasa among its customers.", "capabilities": { "supported_actions": [ "synthesize_speech", "streaming_tts", "websocket_tts", "instant_voice_cloning", "professional_voice_cloning", "word_timestamps", "phoneme_timestamps", "speech_to_speech", "multilingual_synthesis", "emotion_control", "speed_control", "volume_control", "pronunciation_dictionaries", "voice_design", "voice_localization", "voice_infill", "voice_changer" ], "supported_regions": [ "US", "EU", "global (cloud)", "on-premises", "on-device" ], "supported_languages": [ "American English", "British English", "Australian English", "French (France)", "French (Canada)", "German", "Spanish (Castilian)", "Spanish (Mexican)", "Italian", "Portuguese (Brazilian)", "Russian", "Japanese", "Korean", "Mandarin Chinese", "Dutch", "Hindi", "Bengali", "Bulgarian", "Croatian", "Czech", "Danish", "Finnish", "Georgian", "Greek", "Gujarati", "Hebrew", "Hungarian", "Indonesian", "Kannada", "Malayalam", "Marathi", "Norwegian", "Polish", "Punjabi", "Romanian", "Slovak", "Swedish", "Tagalog", "Tamil", "Telugu", "Thai", "Turkish", "Ukrainian", "Vietnamese", "Emirati Arabic", "Malay", "Arabic" ], "input_types": [ "plain text" ], "output_types": [ "pcm_f32le", "pcm_s16le", "pcm_mulaw", "pcm_alaw", "wav", "mp3", "streaming chunks (SSE)", "streaming chunks (WebSocket)" ], "webhooks_supported": false, "sandbox_available": false, "sdk_languages": [ "Python", "JavaScript/TypeScript" ], "mcp_server_available": true }, "integration": { "api_style": "rest", "base_url": "https://api.cartesia.ai", "api_version": "2026-03-01", "versioning_scheme": "date", "stability": "ga", "deprecation_policy_url": "https://docs.cartesia.ai/use-the-api/api-conventions.md", "auth_methods": [ "api_key", "jwt" ], "auth_docs_url": "https://docs.cartesia.ai/get-started/authenticate-your-client-applications.md", "idempotency_supported": null, "error_format": "vendor-specific", "webhook_signing": null, "webhook_events_url": null, "rate_limit_requests": 2, "rate_limit_window": "concurrent", "sdk_packages": [ { "package": "cartesia", "language": "Python", "official": true, "repo_url": "https://github.com/cartesia-ai/cartesia-python" }, { "package": "@cartesia/cartesia-js", "language": "JavaScript/TypeScript", "official": true, "repo_url": "https://github.com/cartesia-ai/cartesia-js" } ], "mcp_url": "https://github.com/cartesia-ai/cartesia-mcp", "quickstart_url": "https://docs.cartesia.ai/get-started/realtime-text-to-speech-quickstart.md" }, "pricing": { "pricing_model": "hybrid", "has_published_pricing": true, "starting_price_usd": "50.0000", "price_basis": "1M characters", "free_tier_available": true, "free_tier_limit": "20,000 characters/month", "free_tier_details": "Free plan at $0/month includes 20,000 credits/month (approximately 20,000 characters of TTS at 1 credit per character). Includes instant voice cloning. Does not include professional voice cloning or commercial use license.", "minimum_commitment": null, "self_serve_signup": true, "requires_sales_call": false, "requires_verification": false, "enterprise_plan_available": true, "price_points": [ { "plan": "Free", "item": "Monthly subscription", "amount_usd": "0.0000", "amount_percent": null, "per": "month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": "Free", "item": "TTS credits included", "amount_usd": "0.0000", "amount_percent": null, "per": "20,000 credits/month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": "Pro", "item": "Monthly subscription", "amount_usd": "5.0000", "amount_percent": null, "per": "month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": "Pro", "item": "TTS credits included", "amount_usd": "5.0000", "amount_percent": null, "per": "100,000 credits/month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": "Startup", "item": "Monthly subscription", "amount_usd": "49.0000", "amount_percent": null, "per": "month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": "Startup", "item": "TTS credits included", "amount_usd": "49.0000", "amount_percent": null, "per": "1,250,000 credits/month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": "Scale", "item": "Monthly subscription", "amount_usd": "299.0000", "amount_percent": null, "per": "month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": "Scale", "item": "TTS credits included", "amount_usd": "299.0000", "amount_percent": null, "per": "8,000,000 credits/month", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": null, "item": "Standard Sonic TTS — credit consumption rate", "amount_usd": null, "amount_percent": null, "per": "~1 credit per character", "currency": "USD", "source_url": "https://docs.cartesia.ai/pricing" }, { "plan": null, "item": "TTS with Professional voice clone — credit consumption rate", "amount_usd": null, "amount_percent": null, "per": "~1.5 credits per character", "currency": "USD", "source_url": "https://docs.cartesia.ai/pricing" }, { "plan": "Startup", "item": "Professional voice clone fine-tuning (one-time per clone)", "amount_usd": null, "amount_percent": null, "per": "1,000,000 credits per fine-tune", "currency": "USD", "source_url": "https://docs.cartesia.ai/pricing" }, { "plan": null, "item": "Voice localization (one-time per voice)", "amount_usd": null, "amount_percent": null, "per": "225 credits per voice", "currency": "USD", "source_url": "https://cartesia.ai/pricing" }, { "plan": null, "item": "Voice changer — credit consumption rate", "amount_usd": null, "amount_percent": null, "per": "15 credits per second of audio", "currency": "USD", "source_url": "https://cartesia.ai/pricing" } ] }, "compliance": { "soc2": "type_2", "hipaa": true, "gdpr": true, "iso_27001": null, "pci_dss": true, "sla_published": false, "sla_url": null, "data_retention_policy_url": "https://cartesia.ai/legal/privacy.html", "documented_rate_limits": "TTS concurrent requests: Free=2, Pro=3, Startup=5, Scale=15, Enterprise=custom. WebSocket connections limited to 10x concurrency limit. Idle WebSocket connections closed after 5 minutes. Exceeding limits returns HTTP 429. First audio byte latency: 90ms (Sonic 3.5).", "known_restrictions": [ "Voice cloning requires explicit consent from the voice owner per Acceptable Use Policy", "Cannot post audio of deceased persons, political candidates, or others without express permission", "No SSML support documented", "Professional voice cloning available on Startup plan and above only; instant voice cloning available on all plans including Free", "Free plan does not include commercial use license", "Infinite request length supported (no per-request character cap documented)", "Voice sample recordings may be retained by Cartesia solely for voice cloning functionality" ] }, "developer": { "docs_url": "https://docs.cartesia.ai/get-started/overview", "api_reference_url": null, "openapi_spec_url": null, "postman_collection_url": null, "changelog_url": null, "status_page_url": "https://status.cartesia.ai", "llms_txt_url": null, "markdown_docs_url": null, "rendering": "static" }, "adoption": { "launched_at": "2023-01-01", "ga_date": null, "github_stars": null, "github_stars_at": null, "notable_customers": [ "Quora", "Cresta", "Rasa" ] }, "scores": { "agent_friendliness": 50, "pricing_transparency": 100, "setup_speed": 80, "docs_quality": 15, "procurement_friction": 100, "trust_readiness": 65, "best_for": [ "Prototypes and side projects - free to start, no sales call", "Regulated or enterprise workloads - compliance attestations and an enterprise plan", "AI agents and automation - an agent-ready surface (MCP / llms.txt)" ], "avoid_if": [] }, "sources": [ { "field": "pci_dss", "url": "https://cartesia.ai/blog/gdpr-compliance", "excerpt": "SOC 2 Type II, PCI-DSS (service level provider), HIPAA, and optional Zero Data Retention", "confidence": "high" }, { "field": "vendor_description", "url": "https://cartesia.ai/sonic", "excerpt": "The fastest and most natural text to speech model", "confidence": "high" }, { "field": "categories", "url": "https://cartesia.ai", "excerpt": "Sonic (Text-to-Speech): The fastest and most realistic speech generation model; Ink (Speech-to-Text): The fastest and most accurate streaming transcription model; Line (Voice Agents Platform): The fastest, most customizable platform for building and shipping enterprise voice agents", "confidence": "high" }, { "field": "primary_use_cases", "url": "https://cartesia.ai", "excerpt": "Financial services (fraud detection, customer support, loan assistance, collections, account opening, compliance)", "confidence": "high" }, { "field": "supported_actions", "url": "https://docs.cartesia.ai/api-reference/tts/websocket", "excerpt": "Word-level and phoneme-level timestamps; Flush acknowledgments; Completion signals", "confidence": "high" }, { "field": "supported_languages", "url": "https://docs.cartesia.ai/build-with-cartesia/tts-models/latest", "excerpt": "Ranked #1 for naturalness, with sub-90ms latency and native support for 42 languages", "confidence": "high" }, { "field": "output_types", "url": "https://docs.cartesia.ai/api-reference/tts/sse", "excerpt": "Encoding options: pcm_f32le, pcm_s16le, pcm_mulaw, pcm_alaw; Sample rates: 8000, 16000, 22050, 24000, 44100, 48000 Hz", "confidence": "high" }, { "field": "mcp_server_available", "url": "https://docs.cartesia.ai/integrations/mcp", "excerpt": "Run cartesia-mcp with uvx to use Cartesia TTS, STT, voices, and pronunciation dictionaries from MCP clients like Cursor and Claude Code.", "confidence": "high" }, { "field": "sdk_languages", "url": "https://docs.cartesia.ai/tools/client-libraries", "excerpt": "JavaScript/TypeScript: @cartesia/cartesia-js (https://github.com/cartesia-ai/cartesia-js). Python: cartesia (https://github.com/cartesia-ai/cartesia-python)", "confidence": "high" }, { "field": "free_tier_available", "url": "https://cartesia.ai/pricing", "excerpt": "Free - $0/month; 20K credits/month; Text to Speech & Speech to Text included; Instant voice cloning included", "confidence": "high" }, { "field": "enterprise_plan_available", "url": "https://cartesia.ai/pricing", "excerpt": "Enterprise - Custom pricing; Custom credits & agent usage with volume pricing; Includes: Custom concurrency, DPAs/BAAs, Shared Slack, SSO, Security questionnaires", "confidence": "high" }, { "field": "soc2", "url": "https://cartesia.ai/blog/gdpr-compliance", "excerpt": "SOC 2 Type II, PCI-DSS (service level provider), HIPAA, and optional Zero Data Retention", "confidence": "high" }, { "field": "hipaa", "url": "https://cartesia.ai/blog/gdpr-compliance", "excerpt": "SOC 2 Type II, PCI-DSS (service level provider), HIPAA, and optional Zero Data Retention", "confidence": "high" }, { "field": "gdpr", "url": "https://cartesia.ai/legal/dpa", "excerpt": "The DPA explicitly incorporates GDPR requirements, defining 'European Data Protection Laws' as 'the General Data Protection Regulation (EU) 2016/679'", "confidence": "high" }, { "field": "vendor_description", "url": "https://docs.cartesia.ai/build-with-cartesia/tts-models/latest", "excerpt": "Ranked #1 for naturalness, with sub-90ms latency and native support for 42 languages", "confidence": "high" }, { "field": "primary_use_cases", "url": "https://cartesia.ai/sonic", "excerpt": "Applications: conversational AI, dubbing, narration, avatars", "confidence": "high" }, { "field": "supported_actions", "url": "https://docs.cartesia.ai/api-reference/tts/sse", "excerpt": "timestamps, phoneme_timestamps, pronunciation dictionary, generation config (volume, speed, emotion), context_id", "confidence": "high" }, { "field": "supported_languages", "url": "https://cartesia.ai/languages", "excerpt": "47 languages and regional variants: American English, British English, Australian English, French (France), French (Canada), German, Castilian Spanish, Mexican Spanish, Italian, Brazilian Portuguese, Russian, Japanese, Korean, Mandarin Chinese, Dutch, Hindi, Bengali, Bulgarian, Croatian, Czech, Danish, Finnish, Georgian, Greek, Gujarati, Hebrew, Hungarian, Indonesian, Kannada, Malayalam, Marathi, Norwegian, Polish, Punjabi, Romanian, Slovak, Swedish, Tagalog, Tamil, Telugu, Thai, Turkish, Ukrainian, Vietnamese, Emirati Arabic, Malay, Arabic", "confidence": "high" }, { "field": "output_types", "url": "https://docs.cartesia.ai/api-reference/tts/bytes", "excerpt": "RAW: PCM with custom encoding/sample rate; WAV: PCM with header wrapper; MP3: compressed with bitrate selection", "confidence": "high" }, { "field": "webhooks_supported", "url": "https://docs.cartesia.ai/line/infrastructure/observability", "excerpt": "Cartesia sends five types of webhook events throughout the call lifecycle: call_started, call_completed, call_failed, call_turn, post_call_analysis", "confidence": "high" }, { "field": "mcp_server_available", "url": "https://github.com/cartesia-ai/cartesia-mcp", "excerpt": "The official Cartesia MCP Server — exposes Cartesia APIs over the Model Context Protocol (MCP) so clients such as Cursor, Claude Desktop, and OpenAI Agents can list voices, run TTS, clone voices, infill audio, and more.", "confidence": "high" }, { "field": "pricing_model", "url": "https://cartesia.ai/pricing", "excerpt": "Free $0/month 20K credits/month; Pro $5/month 100K credits/month; Startup $49/month 1.25M credits/month; Scale $299/month 8M credits/month", "confidence": "high" }, { "field": "free_tier_details", "url": "https://cartesia.ai/pricing", "excerpt": "Free & Pro: Instant voice cloning available. Startup & Scale: Professional voice cloning added.", "confidence": "high" }, { "field": "soc2", "url": "https://cartesia.ai/sonic", "excerpt": "SOC 2 Type 2 certified", "confidence": "high" }, { "field": "hipaa", "url": "https://cartesia.ai/sonic", "excerpt": "HIPAA compliant", "confidence": "high" }, { "field": "gdpr", "url": "https://cartesia.ai/blog/gdpr-compliance", "excerpt": "our text-to-speech platform is now GDPR compliant", "confidence": "high" }, { "field": "iso_27001", "url": "https://cartesia.ai/sonic", "excerpt": "SOC 2 Type 2 certified, HIPAA compliant, PCI certified, GDPR", "confidence": "high" }, { "field": "pci_dss", "url": "https://cartesia.ai/sonic", "excerpt": "PCI certified", "confidence": "high" }, { "field": "sla_published", "url": "https://cartesia.ai/vs/cartesia-vs-elevenlabs", "excerpt": "Enterprise-grade reliability with 99.9% uptime, SOC2 compliance, and full on-premises support.", "confidence": "medium" }, { "field": "documented_rate_limits", "url": "https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts", "excerpt": "We limit the number of parallel TTS WebSocket connections to 10X your concurrency limit.", "confidence": "high" }, { "field": "known_restrictions", "url": "https://cartesia.ai/pricing", "excerpt": "Free & Pro: Instant voice cloning available. Startup & Scale: Professional voice cloning added.", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.cartesia.ai/get-started/authenticate-your-client-applications.md", "excerpt": "Tokens are generated server-side by posting to https://api.cartesia.ai/access-token with a Cartesia API key in Authorization header, specifying grants and expiration, returning a short-lived token", "confidence": "high" }, { "field": "api_style", "url": "https://docs.cartesia.ai/api-reference/tts/websocket", "excerpt": "Base URL: wss://api.cartesia.ai — WebSocket Endpoint: /tts/websocket", "confidence": "high" }, { "field": "api_version", "url": "https://docs.cartesia.ai/use-the-api/api-conventions.md", "excerpt": "Cartesia-Version header required on all requests; current version: 2026-03-01", "confidence": "high" }, { "field": "versioning_scheme", "url": "https://docs.cartesia.ai/use-the-api/api-conventions.md", "excerpt": "Inspired by Anthropic's approach, using calendar dates (YYYY-MM-DD format). HTTP: Cartesia-Version header required on all requests. WebSocket: ?cartesia_version query parameter (takes precedence over header)", "confidence": "high" }, { "field": "sdk_packages", "url": "https://docs.cartesia.ai/tools/client-libraries.md", "excerpt": "JavaScript/TypeScript: @cartesia/cartesia-js (https://github.com/cartesia-ai/cartesia-js). Python: cartesia (https://github.com/cartesia-ai/cartesia-python)", "confidence": "high" }, { "field": "mcp_url", "url": "https://docs.cartesia.ai/integrations/mcp", "excerpt": "Run cartesia-mcp with uvx to use Cartesia TTS, STT, voices, and pronunciation dictionaries from MCP clients like Cursor and Claude Code.", "confidence": "high" }, { "field": "quickstart_url", "url": "https://docs.cartesia.ai/get-started/realtime-text-to-speech-quickstart.md", "excerpt": "Stream text via WebSocket for real-time audio. Prerequisites: API Key from https://play.cartesia.ai/keys. Install: pip install 'cartesia[websockets]' or npm install @cartesia/cartesia-js ws", "confidence": "high" }, { "field": "rate_limit_window", "url": "https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts.md", "excerpt": "The documentation contains no requests-per-second rate limits—only concurrency limits based on simultaneous active connections. Exceeding limits triggers a 429 Too Many Requests error response.", "confidence": "high" }, { "field": "starting_price_usd", "url": "https://cartesia.ai/pricing", "excerpt": "Pro: $5/month — 100K credits/month. Startup: $49/month — 1.25M credits/month. Scale: $299/month — 8M credits/month.", "confidence": "medium" }, { "field": "price_basis", "url": "https://cartesia.ai/pricing", "excerpt": "1 credit per character for Text to Speech (Sonic). Pro Voice Cloning: 1.5 credits per character after a one-time training fee.", "confidence": "medium" }, { "field": "launched_at", "url": "https://cartesia.ai/company/", "excerpt": "Founding team of four PhDs (Karan Goel, Albert Gu, Arjun Desai, and Brandon Yang) who developed State Space Models at Stanford. Backed by Index Ventures, Kleiner Perkins, General Catalyst, and others.", "confidence": "medium" }, { "field": "data_retention_policy_url", "url": "https://cartesia.ai/legal/privacy.html", "excerpt": "Once we've processed your request, we will no longer use the selected categories of Content to train our models in the future.", "confidence": "medium" }, { "field": "stability", "url": "https://docs.cartesia.ai/use-the-api/api-conventions.md", "excerpt": "For a given Cartesia-Version, we will preserve existing input and output fields, but we may make non-breaking changes. Breaking changes trigger deprecation notices with backwards compatibility where feasible.", "confidence": "high" }, { "field": "documented_rate_limits", "url": "https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts", "excerpt": "Free: 2 TTS concurrent connections; Pro: 3 TTS; Startup: 5 TTS; Scale: 15 TTS; Enterprise: Custom", "confidence": "high" }, { "field": "known_restrictions", "url": "https://cartesia.ai/legal/acceptable-use.html", "excerpt": "You may only submit your own voice and audio recordings or those of others with explicit consent", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.cartesia.ai/use-the-api/api-conventions.md", "excerpt": "API keys (server-side): Authorization: Bearer . Client apps: short-lived access tokens via Authorization: Bearer (HTTP) or ?access_token= query parameter (WebSocket)", "confidence": "high" }, { "field": "api_style", "url": "https://docs.cartesia.ai/api-reference/tts/bytes", "excerpt": "Base URL: https://api.cartesia.ai — POST /tts/bytes generates audio from complete transcript text", "confidence": "high" }, { "field": "base_url", "url": "https://docs.cartesia.ai/use-the-api/api-conventions.md", "excerpt": "Base URL: https://api.cartesia.ai (WebSocket: wss://)", "confidence": "high" }, { "field": "api_version", "url": "https://docs.cartesia.ai/api-reference/tts/bytes", "excerpt": "API Version Header: Cartesia-Version (required header). Format: Date string. Current version: 2026-03-01", "confidence": "high" }, { "field": "error_format", "url": "https://docs.cartesia.ai/use-the-api/api-conventions.md", "excerpt": "For versions 2026-03-01+, structured JSON errors include error_code, title, message, request_id, and optional doc_url. WebSocket/SSE errors add status_code and context_id.", "confidence": "high" }, { "field": "sdk_packages", "url": "https://github.com/cartesia-ai/cartesia-python", "excerpt": "The official Cartesia client for Python. The library provides convenient access to the Cartesia REST API from any Python 3.9+ application. Distributed under Apache-2.0 license.", "confidence": "high" }, { "field": "mcp_url", "url": "https://github.com/cartesia-ai/cartesia-mcp", "excerpt": "The official Cartesia MCP Server — exposes Cartesia APIs over the Model Context Protocol (MCP) so clients such as Cursor, Claude Desktop, and OpenAI Agents can list voices, run TTS, clone voices, infill audio, and more.", "confidence": "high" }, { "field": "rate_limit_requests", "url": "https://docs.cartesia.ai/use-the-api/concurrency-limits-and-timeouts.md", "excerpt": "Free: 2 TTS concurrent connections, 8 STT concurrent connections. Pro: 3 TTS, 12 STT. Startup: 5 TTS, 20 STT. Scale: 15 TTS, 60 STT. Enterprise: Custom.", "confidence": "high" }, { "field": "free_tier_limit", "url": "https://cartesia.ai/pricing", "excerpt": "Free tier: $0/month — 20K credits/month (Text to Speech), 2 concurrent TTS requests, 8 concurrent STT requests, 1 agent slot. Text to Speech & Speech to Text only.", "confidence": "high" }, { "field": "starting_price_usd", "url": "https://awesomeagents.ai/pricing/voice-tts-pricing/", "excerpt": "Cartesia Sonic launched at $50/1M characters; Cartesia Sonic 3 has an effective rate of ~$35/M (credit-based billing: 1 credit = 1 character)", "confidence": "medium" }, { "field": "notable_customers", "url": "https://tracxn.com/d/companies/cartesia/__ViCPaxy5xjTcNRZb2Njd3bZbE5VNNFrxFvBA3r6pavM", "excerpt": "10,000+ customers signed up including Quora, Cresta, Rasa, and others in 2024", "confidence": "medium" }, { "field": "launched_at", "url": "https://crunchbase.com/organization/cartesia", "excerpt": "Founded 2023 — first funding round was a Seed round raised on Dec 12, 2024", "confidence": "medium" }, { "field": "data_retention_policy_url", "url": "https://www.cartesia.ai/legal/dpa", "excerpt": "Where the Zero Data Retention setting is enabled, Cartesia does not store any customer content, including audio inputs, transcripts, or outputs.", "confidence": "medium" } ], "fields_not_found": [ "iso_27001", "sla_published (uptime of 99.9% mentioned in marketing copy but no formal SLA document found)", "voices_count (described as library but no exact number on official pages)", "ga_date", "sla_url", "idempotency_supported", "webhook_signing", "webhook_events_url", "deprecation_policy_url" ], "source_confidence": "high", "last_verified_at": "2026-06-21T00:00:00.000Z", "contribute": { "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.", "endpoints": [ { "action": "review", "label": "Leave a review or comment", "method": "POST", "url": "https://apio.sh/api/feedback/cartesia", "example_body": { "kind": "review", "rating": 5, "body": "Your experience with this API…" } }, { "action": "field_edit", "label": "Suggest a correction to a field (cite a source)", "method": "POST", "url": "https://apio.sh/api/suggest/cartesia/{field}", "example_body": { "value": "corrected value", "citations": [ { "url": "https://source.example/page", "excerpt": "supporting quote" } ], "note": "what changed and why" } }, { "action": "new_api", "label": "Suggest a new API to add (only name is required - send as much as you can cite)", "method": "POST", "url": "https://apio.sh/api/suggest/api", "example_body": { "value": { "name": "Acme Email API", "website_url": "https://acme.example", "vendor_name": "Acme", "categories": [ "email" ], "pricing_model": "usage_based", "has_published_pricing": true, "free_tier_available": true, "price_points": [ { "plan": "Pay as you go", "item": "1,000 emails", "amount_usd": 1, "per": "1,000 emails", "source_url": "https://acme.example/pricing" } ], "soc2": "type_2", "docs_url": "https://docs.acme.example" }, "citations": [ { "url": "https://acme.example/pricing", "excerpt": "$1 per 1,000 emails" } ] }, "value_schema": [ { "field": "name", "type": "string", "label": "Product name (the only required field)" }, { "field": "website_url", "type": "string", "label": "Marketing website URL" }, { "field": "vendor_name", "type": "string", "label": "Company/vendor name behind the product" }, { "field": "vendor_description", "type": "string", "label": "One-line description, quoted from the vendor" }, { "field": "categories", "type": "string[]", "label": "Category/leaf slugs it belongs to, e.g. [\"email\",\"sms\"]" }, { "field": "primary_use_cases", "type": "string[]", "label": "What it's used for" }, { "field": "supported_actions", "type": "string[]", "label": "Concrete API actions/capabilities" }, { "field": "supported_regions", "type": "string[]", "label": "Countries/regions/data-residency" }, { "field": "supported_languages", "type": "string[]", "label": "Human/spoken languages supported" }, { "field": "input_types", "type": "string[]", "label": "Accepted input types/formats" }, { "field": "output_types", "type": "string[]", "label": "Produced output types/formats" }, { "field": "webhooks_supported", "type": "bool", "label": "Supports webhooks?" }, { "field": "sandbox_available", "type": "bool", "label": "Dedicated sandbox/test mode?" }, { "field": "sdk_languages", "type": "string[]", "label": "Languages with an official SDK" }, { "field": "mcp_server_available", "type": "bool", "label": "Official MCP server?" }, { "field": "pricing_model", "type": "enum", "label": "Pricing model", "values": [ "usage_based", "subscription", "seat_based", "hybrid", "contact_sales" ] }, { "field": "has_published_pricing", "type": "bool", "label": "Concrete prices published publicly?" }, { "field": "free_tier_available", "type": "bool", "label": "Recurring/perpetual free tier (not a trial)?" }, { "field": "free_tier_details", "type": "string", "label": "What the free tier includes" }, { "field": "minimum_commitment", "type": "string", "label": "Any stated minimum spend/commitment" }, { "field": "self_serve_signup", "type": "bool", "label": "Get an API key without talking to sales?" }, { "field": "requires_sales_call", "type": "bool", "label": "Does going live require sales?" }, { "field": "enterprise_plan_available", "type": "bool", "label": "Named enterprise tier?" }, { "field": "starting_price_usd", "type": "number", "label": "Lowest published paid entry price (USD number)" }, { "field": "price_basis", "type": "string", "label": "Unit the starting price is per, e.g. '1,000 emails'" }, { "field": "free_tier_limit", "type": "string", "label": "Free-tier ceiling in literal terms" }, { "field": "price_points", "type": "object[]", "label": "Structured prices: [{plan,item,amount_usd,amount_percent,per,source_url}]" }, { "field": "soc2", "type": "enum", "label": "SOC 2 status", "values": [ "type_2", "type_1", "in_progress", "none", "unknown" ] }, { "field": "hipaa", "type": "bool", "label": "HIPAA (e.g. BAA available)?" }, { "field": "gdpr", "type": "bool", "label": "GDPR compliance stated?" }, { "field": "iso_27001", "type": "bool", "label": "ISO 27001 certified?" }, { "field": "pci_dss", "type": "bool", "label": "PCI DSS compliant?" }, { "field": "sla_published", "type": "bool", "label": "Published SLA / uptime commitment?" }, { "field": "documented_rate_limits", "type": "string", "label": "Documented rate limits, quoted" }, { "field": "known_restrictions", "type": "string[]", "label": "Notable documented restrictions/limits" }, { "field": "auth_methods", "type": "string[]", "label": "Auth methods", "values": [ "api_key", "oauth2", "jwt", "basic", "hmac_signature", "mtls", "session" ] }, { "field": "api_style", "type": "enum", "label": "Primary API style", "values": [ "rest", "graphql", "grpc", "soap", "websocket" ] }, { "field": "base_url", "type": "string", "label": "API root/base URL" }, { "field": "api_version", "type": "string", "label": "Current API version string" }, { "field": "quickstart_url", "type": "string", "label": "Quickstart / hello-world URL" }, { "field": "docs_url", "type": "string", "label": "Developer docs URL" }, { "field": "api_reference_url", "type": "string", "label": "API reference URL" }, { "field": "openapi_spec_url", "type": "string", "label": "OpenAPI spec URL" }, { "field": "changelog_url", "type": "string", "label": "Changelog URL" }, { "field": "status_page_url", "type": "string", "label": "Status page URL" }, { "field": "notable_customers", "type": "string[]", "label": "Named public customers" }, { "field": "launched_at", "type": "string", "label": "Launch date (ISO date or year)" } ] }, { "action": "token", "label": "Optional - raise your rate limit", "method": "GET", "url": "https://apio.sh/api/feedback/token" } ] } }