{"openapi":"3.1.0","info":{"title":"Emerald Trust Engine","version":"1.0.0"},"paths":{"/api/billing/subscriptions/{subscription_id}/resume":{"post":{"summary":"Resume","operationId":"resume_api_billing_subscriptions__subscription_id__resume_post","parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","title":"Subscription Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/billing/subscribe":{"post":{"summary":"Subscribe","operationId":"subscribe_api_billing_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/billing/subscriptions/{subscription_id}/cancel":{"post":{"summary":"Cancel","operationId":"cancel_api_billing_subscriptions__subscription_id__cancel_post","parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","title":"Subscription Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/billing/paypal/webhook":{"post":{"summary":"Webhook","operationId":"webhook_api_billing_paypal_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/playground":{"get":{"summary":"Playground Info","operationId":"playground_info_api_playground_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/playground/moderate-text":{"post":{"summary":"Moderate Playground Text","operationId":"moderate_playground_text_api_playground_moderate_text_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextModerationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/playground/analyze":{"post":{"summary":"Analyze Photo","operationId":"analyze_photo_api_playground_analyze_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaygroundPhoto"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/moderate-video":{"post":{"tags":["Video moderation beta"],"summary":"Upload Video","operationId":"upload_video_v1_moderate_video_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_video_v1_moderate_video_post"}}},"required":true},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"decision":"review","reasons":["possible_explicit_nudity_in_one_frame"],"policyVersion":"dating-photo-v1","scope":"sampled_frames","durationMs":5000,"framesAnalyzed":10,"sampling":{"regularIntervalMs":500,"regularFrames":10,"sceneFrames":0},"evidence":[{"atMs":1500,"decision":"reject","score":0.98}],"operation":"moderate-video","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"moderation":{"decision":"review","reviewRequired":true,"reasons":["possible_explicit_nudity_in_one_frame"]},"scores":{},"error":null,"jobId":"d2893b02-37a9-428f-84ed-283589cf784b","created":1794000000,"result":{"ok":true,"decision":"review","reasons":["possible_explicit_nudity_in_one_frame"],"policyVersion":"dating-photo-v1","scope":"sampled_frames","durationMs":5000,"framesAnalyzed":10,"sampling":{"regularIntervalMs":500,"regularFrames":10,"sceneFrames":0},"evidence":[{"atMs":1500,"decision":"reject","score":0.98}],"operation":"moderate-video","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"moderation":{"decision":"review","reviewRequired":true,"reasons":["possible_explicit_nudity_in_one_frame"]},"scores":{},"error":null}}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"202":{"description":"Queued or processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"operation":"moderate-video","status":"queued","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"moderation":{"decision":"pending","reviewRequired":false,"reasons":[]},"scores":{},"error":null,"jobId":"d2893b02-37a9-428f-84ed-283589cf784b","statusUrl":"/v1/moderate-video/d2893b02-37a9-428f-84ed-283589cf784b"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}},"parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}]}},"/v1/moderate-video/{job_id}":{"get":{"tags":["Video moderation beta"],"summary":"Video Status","operationId":"video_status_v1_moderate_video__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"}],"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"decision":"review","reasons":["possible_explicit_nudity_in_one_frame"],"policyVersion":"dating-photo-v1","scope":"sampled_frames","durationMs":5000,"framesAnalyzed":10,"sampling":{"regularIntervalMs":500,"regularFrames":10,"sceneFrames":0},"evidence":[{"atMs":1500,"decision":"reject","score":0.98}],"operation":"moderate-video","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"moderation":{"decision":"review","reviewRequired":true,"reasons":["possible_explicit_nudity_in_one_frame"]},"scores":{},"error":null,"jobId":"d2893b02-37a9-428f-84ed-283589cf784b","created":1794000000,"result":{"ok":true,"decision":"review","reasons":["possible_explicit_nudity_in_one_frame"],"policyVersion":"dating-photo-v1","scope":"sampled_frames","durationMs":5000,"framesAnalyzed":10,"sampling":{"regularIntervalMs":500,"regularFrames":10,"sceneFrames":0},"evidence":[{"atMs":1500,"decision":"reject","score":0.98}],"operation":"moderate-video","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"moderation":{"decision":"review","reviewRequired":true,"reasons":["possible_explicit_nudity_in_one_frame"]},"scores":{},"error":null}}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"202":{"description":"Queued or processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"operation":"moderate-video","status":"queued","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"moderation":{"decision":"pending","reviewRequired":false,"reasons":[]},"scores":{},"error":null,"jobId":"d2893b02-37a9-428f-84ed-283589cf784b","statusUrl":"/v1/moderate-video/d2893b02-37a9-428f-84ed-283589cf784b"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}}}},"/api/playground/moderate-video":{"post":{"summary":"Playground Video","operationId":"playground_video_api_playground_moderate_video_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_playground_video_api_playground_moderate_video_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/playground/moderate-video/{job_id}":{"get":{"summary":"Playground Video Status","operationId":"playground_video_status_api_playground_moderate_video__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/forgot-password":{"post":{"summary":"Forgot","operationId":"forgot_api_auth_forgot_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/reset-password":{"post":{"summary":"Reset","operationId":"reset_api_auth_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/verify-email":{"post":{"summary":"Verify Email","operationId":"verify_email_api_auth_verify_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/resend-verification":{"post":{"summary":"Resend","operationId":"resend_api_auth_resend_verification_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/preferences":{"post":{"summary":"Preferences","operationId":"preferences_api_account_preferences_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Preferences"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/deletion-request":{"post":{"summary":"Deletion","operationId":"deletion_api_account_deletion_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/security":{"get":{"summary":"Customer Security","operationId":"customer_security_api_account_security_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/account/security/mfa/setup":{"post":{"summary":"Customer Mfa Setup","operationId":"customer_mfa_setup_api_account_security_mfa_setup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerMFAAction"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/security/mfa/confirm":{"post":{"summary":"Customer Mfa Confirm","operationId":"customer_mfa_confirm_api_account_security_mfa_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerMFAAction"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/security/mfa/recovery-codes":{"post":{"summary":"Customer Mfa Recovery Codes","operationId":"customer_mfa_recovery_codes_api_account_security_mfa_recovery_codes_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerMFAAction"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/account/security/mfa/disable":{"post":{"summary":"Customer Mfa Disable","operationId":"customer_mfa_disable_api_account_security_mfa_disable_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerMFAAction"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/security":{"get":{"summary":"Admin Security","operationId":"admin_security_api_admin_security_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/security/mfa/setup":{"post":{"summary":"Mfa Setup","operationId":"mfa_setup_api_admin_security_mfa_setup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFASetup"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/security/mfa/confirm":{"post":{"summary":"Mfa Confirm","operationId":"mfa_confirm_api_admin_security_mfa_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MFASetup"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/audit":{"get":{"summary":"Audit Events","operationId":"audit_events_api_admin_audit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/pilot/apply":{"post":{"summary":"Apply","operationId":"apply_api_pilot_apply_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Application"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/pilot-requests":{"get":{"summary":"Requests","operationId":"requests_api_admin_pilot_requests_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/pilot-requests/{application_id}/invite":{"post":{"summary":"Invite","operationId":"invite_api_admin_pilot_requests__application_id__invite_post","parameters":[{"name":"application_id","in":"path","required":true,"schema":{"type":"string","title":"Application Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invite"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/signup":{"post":{"summary":"Signup","operationId":"signup_api_auth_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Credentials"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/login":{"post":{"summary":"Login","operationId":"login_api_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Credentials"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/admin":{"post":{"summary":"Admin Login","operationId":"admin_login_api_auth_admin_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Credentials"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/logout":{"post":{"summary":"Logout","operationId":"logout_api_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/dashboard":{"get":{"summary":"Dashboard Data","operationId":"dashboard_data_api_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/usage/stats":{"get":{"summary":"Usage Stats","operationId":"usage_stats_api_usage_stats_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":7,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/usage/{request_id}":{"get":{"summary":"Usage Detail","operationId":"usage_detail_api_usage__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Request Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/keys":{"post":{"summary":"Create Key","operationId":"create_key_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/keys/{key_id}/revoke":{"post":{"summary":"Revoke Key","operationId":"revoke_key_api_keys__key_id__revoke_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/customers":{"get":{"summary":"Customers","operationId":"customers_api_admin_customers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/customers/{customer_id}/credits":{"post":{"summary":"Grant","operationId":"grant_api_admin_customers__customer_id__credits_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"integer","title":"Customer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditGrant"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/customers/{customer_id}/status":{"post":{"summary":"Account Status","operationId":"account_status_api_admin_customers__customer_id__status_post","parameters":[{"name":"customer_id","in":"path","required":true,"schema":{"type":"integer","title":"Customer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountStatus"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/status":{"get":{"summary":"Public Status","operationId":"public_status_api_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/health":{"get":{"summary":"Model Health","operationId":"model_health_api_admin_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/moderate-text":{"post":{"tags":["Text moderation beta"],"summary":"Moderate Text","operationId":"moderate_text_v1_moderate_text_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TextModerationRequest"}}},"required":true},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"beta":true,"decision":"allow","reasons":[],"policyVersion":"dating-text-beta-v2","language":"en","context":"message","scores":{"toxicity":0.01,"severeToxicity":0.001,"profanity":0.002,"hate":0.001,"harassment":0.003,"threats":0.001,"sexual":0.002},"signals":{"email":false,"phone":false,"link":false,"paymentSolicitation":false,"sexualSolicitation":false,"underageReference":false,"selfHarmReference":false,"unsupportedScript":false},"coverage":"declared_english","reviewRequired":false,"automaticRejection":false,"tokenCount":12,"elapsedMs":125.4,"creditsCharged":0,"operation":"moderate-text","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","moderation":{"decision":"allow","reviewRequired":false,"reasons":[]},"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}},"parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}]}},"/v1/analyze-face":{"post":{"tags":["Moderation"],"summary":"Face detection","operationId":"analyze_face","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisRequest"}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"faceDetected":true,"faceCount":1,"confidence":0.9876,"elapsedMs":125.4,"creditsCharged":1,"operation":"analyze-face","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","moderation":{"decision":"not_applicable","reviewRequired":false,"reasons":[]},"scores":{"faceDetection":0.9876},"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}}}},"/v1/compare-faces":{"post":{"tags":["Moderation"],"summary":"Face comparison","operationId":"compare_faces","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisRequest"}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"facesMatch":true,"similarity":0.72,"distance":0.28,"comparedCount":2,"elapsedMs":125.4,"creditsCharged":5,"operation":"compare-faces","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","moderation":{"decision":"not_applicable","reviewRequired":false,"reasons":[]},"scores":{"faceSimilarity":0.72},"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}}}},"/v1/analyze-nudity":{"post":{"tags":["Moderation"],"summary":"Nudity detection","operationId":"analyze_nudity","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisRequest"}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"nudityDetected":true,"explicitNudityDetected":false,"reviewRequired":true,"moderationStatus":"pending_review","detections":[{"label":"BUTTOCKS_EXPOSED","score":0.82,"box":[10,20,100,150]}],"elapsedMs":125.4,"creditsCharged":2,"operation":"analyze-nudity","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","moderation":{"decision":"review","reviewRequired":true,"reasons":[]},"scores":{"BUTTOCKS_EXPOSED":0.82},"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}}}},"/v1/analyze-minor-safety":{"post":{"tags":["Moderation"],"summary":"Age safety","operationId":"analyze_minor_safety","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisRequest"}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"decision":"pending_review","estimates":[{"estimatedAge":16.4,"source":"face","index":0}],"elapsedMs":125.4,"creditsCharged":3,"operation":"analyze-minor-safety","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","moderation":{"decision":"review","reviewRequired":true,"reasons":[]},"scores":{},"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}}}},"/v1/analyze-text":{"post":{"tags":["Moderation"],"summary":"Photo text detection","operationId":"analyze_text","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisRequest"}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"textDetected":true,"rawText":"Hello world","phoneNumberDetected":false,"phoneNumbersDetected":[],"lines":[{"text":"Hello world","confidence":0.96}],"threshold":0.8,"elapsedMs":125.4,"creditsCharged":2,"operation":"analyze-text","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","moderation":{"decision":"not_applicable","reviewRequired":false,"reasons":[]},"scores":{},"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}}}},"/v1/moderate-photo":{"post":{"tags":["Moderation"],"summary":"Photo moderation","operationId":"moderate_photo","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisRequest"}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"},"example":{"ok":true,"decision":"reject","reasons":["explicit_nudity"],"policyVersion":"dating-photo-v1","score":0.98,"explicitScore":0.98,"reviewScore":0.12,"threshold":0.45,"decisionMode":"three_way","thresholdSource":"account","checksCharged":1,"elapsedMs":125.4,"creditsCharged":1,"operation":"moderate-photo","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","moderation":{"decision":"reject","reviewRequired":false,"reasons":["explicit_nudity"]},"scores":{"nudity":0.98,"explicitNudity":0.98,"reviewNudity":0.12},"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisResponse"}}}}}}},"/v1/detect-ai-image":{"post":{"tags":["Moderation"],"summary":"AI-generated image detection","operationId":"detect_ai_image","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["imageBase64"],"properties":{"imageBase64":{"type":"string","maxLength":16777216,"description":"Raw base64 JPEG, PNG or WebP image."},"filename":{"type":"string","maxLength":160}},"example":{"imageBase64":"BASE64_ENCODED_IMAGE"}}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageResponse"},"example":{"ok":true,"confidence":77.45,"elapsedMs":125.4,"operation":"detect-ai-image","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}}},"description":"Returns only the AI-generation confidence percentage and request metadata, without review/reject decisions. 90% or higher means most likely AI-generated; lower scores do not establish authenticity. Model confidence is not a calibrated probability."}},"/v1/profile-photo":{"post":{"tags":["Moderation"],"summary":"Profile photo classification","operationId":"profile_photo","parameters":[{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer YOUR_API_KEY"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["imageBase64"],"properties":{"imageBase64":{"type":"string","maxLength":16777216,"description":"Raw base64 JPEG, PNG or WebP image."},"filename":{"type":"string","maxLength":160}},"example":{"imageBase64":"BASE64_ENCODED_IMAGE"}}}}},"responses":{"200":{"description":"Analysis result (video jobs may also be failed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilePhotoResponse"},"example":{"nudity":{"passed":true,"confidence":0,"threshold":45,"reasons":[],"policyVersion":"dating-photo-v1"},"ageEstimates":[],"possibleMinor":null,"textDetected":true,"rawText":"Contact: hello@example.com","contactDataDetected":true,"contactSignals":{"phone":false,"email":true,"link":false,"socialHandle":false},"ok":true,"category":"clothing_merchandise","confidence":82.5,"scores":{"personal_photo":1.2,"clothing_merchandise":82.5,"footwear_merchandise":1.2,"product":1.2,"animal":1.2,"cartoon":1.2,"meme":1.2,"poster":1.2,"screenshot":1.2,"landscape_or_object":1.2},"policyVersion":"profile-photo-v6","elapsedMs":125.4,"faceDetected":false,"faceCount":0,"isProfilePhoto":false,"aiGeneratedConfidence":77.45,"operation":"profile-photo","status":"completed","requestId":"d2893b02-37a9-428f-84ed-283589cf784b","creditsCharged":0,"error":null}}}},"422":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"400":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"401":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"402":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"403":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"404":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"408":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"409":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"410":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"413":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"429":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}},"503":{"description":"Request failed; no credits charged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIImageEnvelope"}}}}},"description":"Classifies the image into personal_photo, merchandise and other image categories. Returns the strongest category, its confidence percentage, and all independent percentage scores. No automatic accept/reject decision or identity verification is performed. Requires PROFILE_PHOTO_ENABLED."}}},"components":{"schemas":{"AccountStatus":{"properties":{"disabled":{"type":"boolean","title":"Disabled"}},"type":"object","required":["disabled"],"title":"AccountStatus"},"AnalysisRequest":{"properties":{"imageBase64":{"anyOf":[{"type":"string","maxLength":16777216},{"type":"null"}],"title":"Imagebase64"},"filename":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Filename"},"minConfidence":{"type":"number","maximum":0.99,"minimum":0.01,"title":"Minconfidence","default":0.5},"selfieBase64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selfiebase64"},"profilePhotosBase64":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":6},{"type":"null"}],"title":"Profilephotosbase64"},"profilePhotoBase64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profilephotobase64"},"threshold":{"anyOf":[{"type":"number","maximum":0.99,"minimum":0.01},{"type":"null"}],"title":"Threshold"},"variant":{"anyOf":[{"type":"string","enum":["tiny","small"]},{"type":"null"}],"title":"Variant"},"decisionMode":{"anyOf":[{"type":"string","enum":["review","auto_reject"]},{"type":"null"}],"title":"Decisionmode","description":"Legacy AI-image option; accepted for compatibility and ignored."},"rejectThreshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rejectthreshold","description":"Legacy AI-image option; accepted for compatibility and ignored."}},"type":"object","title":"AnalysisRequest"},"Application":{"properties":{"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"},"appUrl":{"type":"string","maxLength":300,"minLength":8,"title":"Appurl"},"volume":{"type":"string","maxLength":40,"minLength":1,"title":"Volume"},"message":{"type":"string","maxLength":1000,"title":"Message","default":""},"consent":{"type":"boolean","title":"Consent"},"website":{"type":"string","maxLength":300,"title":"Website","default":""}},"type":"object","required":["email","appUrl","volume","consent"],"title":"Application"},"Body_playground_video_api_playground_moderate_video_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_playground_video_api_playground_moderate_video_post"},"Body_upload_video_v1_moderate_video_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_video_v1_moderate_video_post"},"Credentials":{"properties":{"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"},"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"},"name":{"type":"string","maxLength":120,"title":"Name","default":""},"code":{"type":"string","maxLength":32,"title":"Code","default":""}},"type":"object","required":["email","password"],"title":"Credentials"},"CreditGrant":{"properties":{"amount":{"type":"integer","maximum":10000000.0,"exclusiveMinimum":0.0,"title":"Amount"},"note":{"type":"string","maxLength":200,"minLength":3,"title":"Note"},"reference":{"type":"string","maxLength":80,"minLength":8,"title":"Reference"}},"type":"object","required":["amount","note","reference"],"title":"CreditGrant"},"CustomerMFAAction":{"properties":{"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"},"code":{"type":"string","maxLength":32,"title":"Code","default":""}},"type":"object","required":["password"],"title":"CustomerMFAAction"},"DeletionRequest":{"properties":{"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"}},"type":"object","required":["password"],"title":"DeletionRequest"},"EmailRequest":{"properties":{"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"}},"type":"object","required":["email"],"title":"EmailRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Invite":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"}},"type":"object","required":["name","password"],"title":"Invite"},"KeyRequest":{"properties":{"name":{"type":"string","maxLength":80,"minLength":1,"title":"Name"}},"type":"object","required":["name"],"title":"KeyRequest"},"MFASetup":{"properties":{"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"},"code":{"type":"string","maxLength":6,"title":"Code","default":""}},"type":"object","required":["password"],"title":"MFASetup"},"PlanRequest":{"properties":{"plan":{"type":"string","title":"Plan"}},"type":"object","required":["plan"],"title":"PlanRequest"},"PlaygroundPhoto":{"properties":{"imageBase64":{"type":"string","maxLength":16777216,"minLength":1,"title":"Imagebase64"},"comparisonBase64":{"anyOf":[{"type":"string","maxLength":16777216},{"type":"null"}],"title":"Comparisonbase64"},"tool":{"type":"string","enum":["nudity","face","compare","age","text","ocr","ai-image","profile-photo"],"title":"Tool","default":"nudity"},"textThreshold":{"type":"number","maximum":0.99,"minimum":0.1,"title":"Textthreshold","default":0.8},"ocrVariant":{"type":"string","enum":["tiny","small"],"title":"Ocrvariant","default":"small"},"nudityThreshold":{"type":"number","maximum":0.99,"minimum":0.25,"title":"Nuditythreshold","default":0.45},"repeats":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Repeats","default":1}},"type":"object","required":["imageBase64"],"title":"PlaygroundPhoto"},"Preferences":{"properties":{"monthlyCap":{"anyOf":[{"type":"integer","maximum":10000000.0,"minimum":0.0},{"type":"null"}],"title":"Monthlycap"},"allowExternalFallback":{"type":"boolean","title":"Allowexternalfallback","default":false},"photoDecisionMode":{"anyOf":[{"type":"string","enum":["three_way","binary"]},{"type":"null"}],"title":"Photodecisionmode"},"photoThreshold":{"anyOf":[{"type":"number","maximum":0.75,"minimum":0.25},{"type":"null"}],"title":"Photothreshold"},"password":{"type":"string","maxLength":128,"minLength":12,"title":"Password"}},"type":"object","required":["password"],"title":"Preferences"},"TextModerationRequest":{"properties":{"text":{"type":"string","maxLength":4000,"minLength":1,"title":"Text"},"language":{"type":"string","const":"en","title":"Language","default":"en"},"context":{"type":"string","enum":["profile","message","username"],"title":"Context","default":"profile"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"otherCountry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Othercountry"},"blockContactDetails":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Blockcontactdetails"},"blockLinks":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Blocklinks"}},"additionalProperties":false,"type":"object","required":["text"],"title":"TextModerationRequest"},"TokenRequest":{"properties":{"token":{"type":"string","maxLength":100,"minLength":20,"title":"Token"},"password":{"anyOf":[{"type":"string","maxLength":128,"minLength":12},{"type":"null"}],"title":"Password"}},"type":"object","required":["token"],"title":"TokenRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"AnalysisResponse":{"type":"object","required":["ok","operation","status","requestId","creditsCharged","moderation","scores","error"],"properties":{"ok":{"type":"boolean","description":"Request accepted or analysis succeeded; check status before using a result."},"operation":{"type":"string"},"status":{"type":"string","enum":["completed","failed","queued","processing"]},"requestId":{"type":"string"},"creditsCharged":{"type":"integer","minimum":0},"moderation":{"type":"object","required":["decision","reviewRequired","reasons"],"properties":{"decision":{"type":"string","enum":["allow","review","reject","inconclusive","unavailable","pending","not_applicable"]},"reviewRequired":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}}}},"scores":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":1},"description":"Named model signals, not calibrated probabilities. Empty when no aggregate score is available; OCR confidence is per line."},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"detail":{"type":"string"}},"additionalProperties":true},"AIImageEnvelope":{"type":"object","required":["ok","operation","status","requestId","creditsCharged","error"],"properties":{"ok":{"type":"boolean","description":"Request accepted or analysis succeeded; check status before using a result."},"operation":{"type":"string"},"status":{"type":"string","enum":["completed","failed","queued","processing"]},"requestId":{"type":"string"},"creditsCharged":{"type":"integer","minimum":0},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"detail":{"type":"string"}},"additionalProperties":true},"AIImageResponse":{"allOf":[{"$ref":"#/components/schemas/AIImageEnvelope"},{"type":"object","required":["confidence"],"properties":{"confidence":{"type":"number","minimum":0,"maximum":100,"example":77.45,"description":"AI-generation confidence as a percentage: 77.45 means 77.45%. Higher means a stronger AI-generation signal, not a calibrated probability of correctness. This is the only AI confidence field."}}}]},"ProfilePhotoResponse":{"allOf":[{"$ref":"#/components/schemas/AIImageEnvelope"},{"type":"object","required":["category","confidence","scores","policyVersion","elapsedMs"],"allOf":[{"if":{"properties":{"policyVersion":{"enum":["profile-photo-v6","profile-photo-v5","profile-photo-v4","profile-photo-v3"]}}},"then":{"required":["faceDetected","faceCount","isProfilePhoto"]}},{"if":{"properties":{"policyVersion":{"enum":["profile-photo-v6","profile-photo-v5","profile-photo-v4"]}}},"then":{"required":["aiGeneratedConfidence"]}},{"if":{"properties":{"policyVersion":{"enum":["profile-photo-v6","profile-photo-v5"]}}},"then":{"required":["nudity"]}},{"if":{"properties":{"policyVersion":{"const":"profile-photo-v6"}}},"then":{"required":["ageEstimates","possibleMinor","textDetected","rawText","contactDataDetected","contactSignals"]}}],"properties":{"ageEstimates":{"type":"array","maxItems":256,"items":{"type":"object","required":["estimatedAge","source","index"],"properties":{"estimatedAge":{"type":"number","minimum":0,"maximum":120},"source":{"type":"string","enum":["face","person"]},"index":{"type":"integer","minimum":0}}},"description":"Model age estimates for detected faces/unmatched bodies, not verified ages or identity."},"possibleMinor":{"type":["boolean","null"],"description":"Any estimate below 18; null when no age estimate is available. Does not alter isProfilePhoto."},"textDetected":{"type":"boolean"},"rawText":{"type":"string","maxLength":32768,"description":"Recognized image text above the fixed 80% recognition threshold, including possible contact details."},"contactDataDetected":{"type":"boolean","description":"Contact candidates in recognized text; does not alter isProfilePhoto. Not a complete contact-data guarantee."},"contactSignals":{"type":"object","required":["phone","email","link","socialHandle"],"additionalProperties":false,"properties":{"phone":{"type":"boolean"},"email":{"type":"boolean"},"link":{"type":"boolean"},"socialHandle":{"type":"boolean"}}},"nudity":{"type":"object","required":["passed","confidence","threshold","reasons","policyVersion"],"properties":{"passed":{"type":"boolean"},"confidence":{"type":"number","minimum":0,"maximum":100,"description":"Highest local nudity-policy detector score as a percentage, not a calibrated probability."},"threshold":{"type":"number","minimum":25,"maximum":99,"description":"Account screening threshold as a percentage; playground trials use the test slider."},"reasons":{"type":"array","items":{"type":"string","enum":["explicit_nudity","possible_nudity"]}},"policyVersion":{"type":"string","const":"dating-photo-v1"}}},"aiGeneratedConfidence":{"type":"number","minimum":0,"maximum":100,"example":77.45,"description":"AI-generation confidence percentage from the separate local AI model. 90+ means most likely AI-generated; a lower score does not prove authenticity. Independent of category confidence and isProfilePhoto."},"faceDetected":{"type":"boolean","description":"A face was detected at the fixed 50% detector threshold; not identity or age verification."},"faceCount":{"type":"integer","minimum":0},"isProfilePhoto":{"type":"boolean","description":"True only for personal_photo with at least one detected face and passed nudity screening. Not a safety or authenticity guarantee."},"category":{"type":"string","enum":["personal_photo","clothing_merchandise","footwear_merchandise","product","animal","cartoon","meme","poster","screenshot","landscape_or_object"]},"confidence":{"type":"number","minimum":0,"maximum":100,"description":"Highest category match score as a percentage, not a calibrated probability."},"scores":{"type":"object","required":["personal_photo","clothing_merchandise","footwear_merchandise","product","animal","cartoon","meme","poster","screenshot","landscape_or_object"],"additionalProperties":false,"properties":{"personal_photo":{"type":"number","minimum":0,"maximum":100},"clothing_merchandise":{"type":"number","minimum":0,"maximum":100},"footwear_merchandise":{"type":"number","minimum":0,"maximum":100},"product":{"type":"number","minimum":0,"maximum":100},"animal":{"type":"number","minimum":0,"maximum":100},"cartoon":{"type":"number","minimum":0,"maximum":100},"meme":{"type":"number","minimum":0,"maximum":100},"poster":{"type":"number","minimum":0,"maximum":100},"screenshot":{"type":"number","minimum":0,"maximum":100},"landscape_or_object":{"type":"number","minimum":0,"maximum":100}},"description":"Independent category match percentages. They do not sum to 100."},"policyVersion":{"type":"string","enum":["profile-photo-v6","profile-photo-v5","profile-photo-v4","profile-photo-v3","profile-photo-v2","profile-photo-v1"],"description":"Current policy for new results; historical replays retain their original result; v1/v2 omit face fields and v1/v2/v3 omit AI confidence; v1/v2/v3/v4 omit nudity; v1/v2/v3/v4/v5 omit age and OCR/contact fields."},"elapsedMs":{"type":"number","minimum":0}}}]}}}}