{"object":"capabilities","api_version":"2026-10-10","output_languages":["ar","en"],"dialects":["classical","emirati","egyptian","gulf","saudi","levantine","iraqi"],"speech_dialects":["saudi","gulf","emirati","egyptian","classical","levantine"],"speech_output_languages":["ar","en"],"speech_localization":{"default_output_language":"ar","default_arabic_dialect":"saudi","english_dialect_supported":false,"campaign_language_source":"brief.output_language"},"localization":{"arabic_dialect_field":"dialect","english_dialect_supported":false,"market_field":"market","market_to_dialect":{"SA":"saudi","AE":"emirati","EG":"egyptian","IQ":"iraqi","KW":"gulf","QA":"gulf","BH":"gulf","OM":"gulf","JO":"levantine","LB":"levantine","SY":"levantine","PS":"levantine"},"precedence":["explicit_dialect","market_mapping","classical_for_unmapped_market","saudi_legacy_fallback"]},"platforms":["instagram","tiktok","linkedin","snapchat","google_search","twitter","whatsapp","facebook","telegram","website_landing_page","ecommerce_product_page","app_store_listing","email_subject_line"],"asset_types":{"copy":["ad_copy","headlines","dialect_conversion"],"image":["campaign_visual","product_showcase","lifestyle","offer_announcement","brand_awareness"],"speech":["marketing","general"],"campaign":["whatsapp_campaign"],"whatsapp_template":["MARKETING","UTILITY","AUTHENTICATION"]},"copy_types":["ad_copy","headlines","dialect_conversion"],"copy_frameworks":["none","aida","pas","fab","story"],"audiences":["everyone","specific","all_genders","female","male","children","teenagers","young_adults","families","professionals","adults","seniors","beginners","experts","students","customers","employees","developers","managers"],"recommended_tones":["friendly","formal","excited","informative","urgent","humorous","luxurious","persuasive","empathetic","inspirational","nostalgic","authoritative"],"voices":[{"id":"Zephyr","label":"Zephyr","style":"Bright"},{"id":"Puck","label":"Puck","style":"Upbeat"},{"id":"Charon","label":"Charon","style":"Informative"},{"id":"Kore","label":"Kore","style":"Firm"},{"id":"Fenrir","label":"Fenrir","style":"Excitable"},{"id":"Leda","label":"Leda","style":"Youthful"},{"id":"Orus","label":"Orus","style":"Firm"},{"id":"Aoede","label":"Aoede","style":"Breezy"},{"id":"Callirrhoe","label":"Callirrhoe","style":"Easy-going"},{"id":"Autonoe","label":"Autonoe","style":"Bright"},{"id":"Enceladus","label":"Enceladus","style":"Breathy"},{"id":"Iapetus","label":"Iapetus","style":"Clear"},{"id":"Umbriel","label":"Umbriel","style":"Easy-going"},{"id":"Algieba","label":"Algieba","style":"Smooth"},{"id":"Despina","label":"Despina","style":"Smooth"},{"id":"Erinome","label":"Erinome","style":"Clear"},{"id":"Algenib","label":"Algenib","style":"Gravelly"},{"id":"Rasalgethi","label":"Rasalgethi","style":"Informative"},{"id":"Laomedeia","label":"Laomedeia","style":"Upbeat"},{"id":"Achernar","label":"Achernar","style":"Soft"},{"id":"Alnilam","label":"Alnilam","style":"Firm"},{"id":"Schedar","label":"Schedar","style":"Even"},{"id":"Gacrux","label":"Gacrux","style":"Mature"},{"id":"Pulcherrima","label":"Pulcherrima","style":"Forward"},{"id":"Achird","label":"Achird","style":"Friendly"},{"id":"Zubenelgenubi","label":"Zubenelgenubi","style":"Casual"},{"id":"Vindemiatrix","label":"Vindemiatrix","style":"Gentle"},{"id":"Sadachbia","label":"Sadachbia","style":"Lively"},{"id":"Sadaltager","label":"Sadaltager","style":"Knowledgeable"},{"id":"Sulafat","label":"Sulafat","style":"Warm"}],"voice_profiles":[{"id":"bright_presenter","label":"Voiceover","label_ar":"تعليق صوتي","description":"Lively, clear delivery for ads, social videos, and brand stories.","description_ar":"أداء حيوي وواضح للإعلانات ومقاطع التواصل وقصص العلامة.","provider_voice":"Fenrir"},{"id":"voiceover_female","label":"Voiceover · Female","label_ar":"تعليق صوتي · نسائي","description":"Lively, clear female delivery for ads, social videos, and brand stories.","description_ar":"أداء نسائي حيوي وواضح للإعلانات ومقاطع التواصل وقصص العلامة.","provider_voice":"Zephyr"},{"id":"modern_narrator","label":"Instructional","label_ar":"إرشادي","description":"Calm, structured delivery for tutorials, explainers, and step-by-step guidance.","description_ar":"أداء هادئ ومنظم للشروحات والتعليمات والإرشاد خطوة بخطوة.","provider_voice":"Iapetus"},{"id":"instructional_female","label":"Instructional · Female","label_ar":"إرشادي · نسائي","description":"Calm, structured female delivery for tutorials, explainers, and step-by-step guidance.","description_ar":"أداء نسائي هادئ ومنظم للشروحات والتعليمات والإرشاد خطوة بخطوة.","provider_voice":"Erinome"},{"id":"premium_narrator","label":"Podcast","label_ar":"بودكاست","description":"Natural, intimate delivery for podcast intros, interviews, and conversational shows.","description_ar":"أداء طبيعي وحميم لمقدمات البودكاست والمقابلات والبرامج الحوارية.","provider_voice":"Algieba"},{"id":"podcast_female","label":"Podcast · Female","label_ar":"بودكاست · نسائي","description":"Natural, intimate female delivery for podcast intros, interviews, and conversational shows.","description_ar":"أداء نسائي طبيعي وحميم لمقدمات البودكاست والمقابلات والبرامج الحوارية.","provider_voice":"Aoede"},{"id":"warm_storyteller","label":"Storyteller","label_ar":"راوي قصصي","description":"Warm, expressive delivery for stories, documentaries, and human brand moments.","description_ar":"أداء دافئ ومعبر للقصص والوثائقيات واللحظات الإنسانية للعلامة.","provider_voice":"Enceladus"},{"id":"storyteller_female","label":"Storyteller · Female","label_ar":"راوي قصصي · نسائي","description":"Warm, expressive female delivery for stories, documentaries, and human brand moments.","description_ar":"أداء نسائي دافئ ومعبر للقصص والوثائقيات واللحظات الإنسانية للعلامة.","provider_voice":"Sulafat"},{"id":"confident_announcer","label":"Professional","label_ar":"احترافي","description":"Polished, decisive delivery for business, announcements, and calls to action.","description_ar":"أداء مصقول وحازم للأعمال والإعلانات والدعوات إلى الإجراء.","provider_voice":"Orus"},{"id":"professional_female","label":"Professional · Female","label_ar":"احترافي · نسائي","description":"Polished, decisive female delivery for business, announcements, and calls to action.","description_ar":"أداء نسائي مصقول وحازم للأعمال والإعلانات والدعوات إلى الإجراء.","provider_voice":"Kore"}],"speech_deliveries":["auto","natural","reel_voiceover","conversational","professional","energetic","storytelling"],"speech_content_types":["marketing","general"],"image_types":["campaign_visual","product_showcase","lifestyle","offer_announcement","brand_awareness"],"image_styles":["photorealistic","illustration","flat-design","3d-render","watercolor","minimalist"],"image_aspect_ratios":["1:1","1:4","1:8","2:3","3:2","3:4","4:1","4:3","4:5","5:4","8:1","9:16","16:9","21:9"],"image_resolutions":["1K","2K"],"copy_controls":{"type_field":"type","framework_field":"framework","audience_field":"audience","specific_audience_field":"specific_audience","freeform_audience_field":"target_audience","brand_profile_field":"brand_profile_id","campaign_copy_path":"deliverables.copy"},"keyword_controls":{"preferred_field":"keywords","required_field":"required_keywords","excluded_field":"excluded_keywords","maximum_per_field":20,"deterministic_enforcement":true,"applies_to":["ad_copy","headlines","campaign_copy"]},"image_controls":{"overlay_text_languages":["auto","ar","en"],"text_modes":["text_free","model_rendered"],"text_renderer":"image_model","exact_text_guaranteed":false,"overlay_text_verified":true,"ad_check":true,"uses_composer_prompt_pipeline":true,"visual_keywords_field":"visual_keywords","excluded_visuals_field":"excluded_visuals","image_type_field":"type","style_field":"style","aspect_ratio_field":"aspect_ratio","resolution_field":"resolution","credits_by_resolution":{"1K":5,"2K":8},"deprecated_resolution_aliases":{"512":"1K"},"brand_profile_field":"brand_profile_id","maximum_visual_items_per_field":20},"image_edits":{"endpoint":"/image-edits","scope":"images:write","credits":5,"credits_by_resolution":{"1K":5,"2K":8},"source_field":"source_request_id","editable_source_operations":["image.generate","image.edit","ad_library.generate","campaign.generate"],"instruction_field":"instruction","instruction_max_length":1000,"max_references":2,"logo_modes":["model","overlay","none"],"defaults":{"aspect_ratio":"source","resolution":"source_or_1K","output_language":"source_or_unchanged"},"prompt_optimizer":false,"exact_text_guaranteed":false,"watermark":"applied_without_paid_access","quote_operation":"image_edit","resize":{"field":"resize","aspect_ratios":["4:5","1:1","9:16"],"instruction":"omitted","copy_verified":true,"ad_check":true}},"speech_controls":{"output_language_field":"output_language","dialect_applies_to":"ar","voice_profile_field":"voice_profile","provider_voice_field":"voice","content_type_field":"content_type","delivery_field":"delivery","mutually_exclusive_voice_fields":true},"credit_costs":{"copy":2,"headline":2,"conversion":1,"whatsapp_template":2,"image":5,"image_2k":8,"image_edit":5,"image_edit_2k":8,"speech":5},"campaign_cost_formula":"copy + enabled image (at its resolution) + enabled speech","whatsapp_templates":{"categories":["MARKETING","UTILITY","AUTHENTICATION"],"language_codes":["ar","en","en_GB","en_US"],"outcomes":["SUBMITTED","APPROVED","REJECTED","RECLASSIFIED","PAUSED","DISABLED"],"approval_owner":"META","submission_owner":"PARTNER","unchanged_rejection_refund":true,"refund_verification_required":true,"partner_outcome_reports_are_proof":false},"scopes":["copy:write","images:write","speech:write","campaigns:write","templates:write","usage:read","context:read","brands:read","ad-library:read","ad-library:write"],"ad_library":{"search":"/ad-library","detail":"/ad-library/{id}","prepare":"/ad-library/{id}/prepare","generate":"/ad-library/{id}/generations","read_scope":"ad-library:read","prepare_upload_scope":"ad-library:write","generation_scope":"images:write","analysis_credits":1,"generation_credits":5,"generation_credits_by_resolution":{"1K":5,"2K":8},"resolution_field":"resolution","exact_id_lookup":true,"brief_max_length":2000,"search_filters":{"sectors":["all","saas","ai","ecommerce","apps","fintech","health","beauty","food","education","b2b","local","travel","automotive","general"],"industries":["SaaS & Cloud Software","AI Tools","E-commerce & Physical Products","Mobile Apps & Games","Finance & FinTech","Health, Fitness & Wellness","Beauty & Skincare","Food & Beverage","Info-Products & Courses","Professional B2B Services","Local & Home Services","Travel & Hospitality","Automotive","Other / General"],"styles":["all","product","offer","launch","proof","problem","comparison","educational","story","hook"]},"search_guidance":"Prefer brief for natural requests. Filters are strict catalog values; use sector food for cafes. q first matches all words, then returns labeled related metadata matches if none exist. City and audience context need not appear in a reusable reference ad.","ranking":"Multilingual catalog metadata relevance, with editorial tie breaks; not measured ad performance.","uploads":{"endpoint":"/ad-library/uploads","input":"HTTPS attachment URL","roles":["reference","logo"],"max_references":2,"expires_in_seconds":86400}},"rate_limits":{"scope":"account","default_per_minute":60,"media_per_minute":10},"idempotency":{"terminal_outcomes_cached":["2xx","4xx"],"retryable_outcomes":["5xx"],"retention_days":30}}