{"components":{"responses":{"BadRequest":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"Conflict":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Job state conflict"},"Forbidden":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing scope, role, or model policy"},"InternalError":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal failure"},"NotFound":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Model, job, artifact, or resource not found"},"PaymentRequired":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Insufficient credits or token spend limit"},"RateLimited":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Token request limit exceeded"},"Unauthorized":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Missing or invalid credential"},"UpstreamFailure":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Sanitized provider or storage failure"}},"schemas":{"AccountAdminView":{"properties":{"active_devices":{"format":"int64","type":"integer"},"balance_micredits":{"format":"int64","type":"integer"},"created_at":{"format":"date-time","type":"string"},"device_cap":{"format":"int32","type":"integer"},"display_name":{"type":"string"},"email":{"type":"string"},"email_verified_at":{"format":"date-time","type":["string","null"]},"entitlement_status":{"type":"string"},"id":{"format":"uuid","type":"string"},"plan":{"type":"string"},"reserved_micredits":{"format":"int64","type":"integer"},"status":{"type":"string"},"stripe_customer_id":{"type":["string","null"]},"stripe_subscription_id":{"type":["string","null"]},"subscription_current_period_end":{"format":"date-time","type":["string","null"]},"trial_expires_at":{"format":"date-time","type":["string","null"]},"user_id":{"format":"uuid","type":"string"}},"required":["active_devices","balance_micredits","created_at","device_cap","display_name","email","entitlement_status","id","plan","reserved_micredits","status","user_id"],"title":"AccountAdminView","type":"object"},"AccountLoginRequest":{"properties":{"email":{"type":"string"},"password":{"type":"string"}},"required":["email","password"],"title":"LoginRequest","type":"object"},"AccountSessionResponse":{"properties":{"account":{"$ref":"#/components/schemas/CustomerAccount"},"expires_at":{"format":"date-time","type":"string"},"token":{"type":"string"}},"required":["account","expires_at","token"],"title":"AccountSessionResponse","type":"object"},"AdminAccount":{"properties":{"created_at":{"format":"date-time","type":"string"},"email":{"type":"string"},"enabled":{"type":"boolean"},"id":{"format":"uuid","type":"string"},"last_login_at":{"format":"date-time","type":["string","null"]},"role":{"type":"string"}},"required":["created_at","email","enabled","id","role"],"title":"AdminAccount","type":"object"},"AdminJobView":{"properties":{"attempts":{"format":"int32","type":"integer"},"capability":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"error_code":{"type":["string","null"]},"id":{"format":"uuid","type":"string"},"max_attempts":{"format":"int32","type":"integer"},"model":{"type":"string"},"status":{"type":"string"},"updated_at":{"format":"date-time","type":"string"},"user_email":{"type":"string"}},"required":["attempts","capability","created_at","id","max_attempts","model","status","updated_at","user_email"],"title":"AdminJobView","type":"object"},"AdminPrincipal":{"properties":{"email":{"type":"string"},"id":{"format":"uuid","type":"string"},"role":{"type":"string"}},"required":["email","id","role"],"title":"AdminPrincipal","type":"object"},"AdminRole":{"enum":["owner","operator","viewer"],"type":"string"},"AdminSession":{"properties":{"admin":{"$ref":"#/components/schemas/AdminPrincipal"},"expires_at":{"format":"date-time","type":"string"},"token":{"type":"string"}},"required":["admin","expires_at","token"],"title":"AdminSession","type":"object"},"AudioForm":{"properties":{"file":{"format":"binary","type":"string"},"language":{"type":"string"},"model":{"type":"string"},"prompt":{"type":"string"},"response_format":{"type":"string"},"temperature":{"type":"number"}},"required":["file","model"],"type":"object"},"AuditEntry":{"properties":{"action":{"type":"string"},"admin_email":{"type":["string","null"]},"admin_id":{"format":"uuid","type":["string","null"]},"created_at":{"format":"date-time","type":"string"},"details":true,"id":{"format":"int64","type":"integer"},"request_id":{"format":"uuid","type":["string","null"]},"resource_id":{"type":["string","null"]},"resource_type":{"type":"string"},"succeeded":{"type":"boolean"}},"required":["action","created_at","details","id","resource_type","succeeded"],"title":"AuditEntry","type":"object"},"Balance":{"properties":{"balance_micredits":{"format":"int64","type":"integer"},"reserved_micredits":{"format":"int64","type":"integer"}},"required":["balance_micredits","reserved_micredits"],"title":"Balance","type":"object"},"ChatMessage":{"properties":{"content":{"type":"string"},"role":{"type":"string"}},"required":["content","role"],"type":"object"},"ChatRequest":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array"},"model":{"type":"string"},"stream":{"default":false,"type":"boolean"}},"required":["messages","model"],"title":"ChatRequest","type":"object"},"ChatResponse":{"description":"The response returned to the client: always carries complete usage.","properties":{"choices":{"items":true,"type":"array"},"created":{"format":"int64","type":"integer"},"id":{"type":"string"},"model":{"type":"string"},"object":{"type":"string"},"usage":{"$ref":"#/components/schemas/Usage"}},"required":["choices","created","id","model","object","usage"],"title":"ChatResponse","type":"object"},"CheckoutResponse":{"properties":{"url":{"type":"string"}},"required":["url"],"title":"CheckoutResponse","type":"object"},"CreateAdminRequest":{"properties":{"email":{"type":"string"},"password":{"type":"string"},"role":{"$ref":"#/components/schemas/AdminRole"}},"required":["email","password","role"],"title":"CreateAdminRequest","type":"object"},"CreateUserRequest":{"properties":{"credits":{"default":0,"format":"int64","type":"integer"},"email":{"type":"string"}},"required":["email"],"title":"CreateUserRequest","type":"object"},"CreditsRequest":{"properties":{"adjustment":{"default":false,"type":"boolean"},"amount":{"format":"int64","type":"integer"}},"required":["amount"],"title":"CreditsRequest","type":"object"},"CustomerAccount":{"properties":{"balance_micredits":{"format":"int64","type":"integer"},"device_cap":{"format":"int32","type":"integer"},"display_name":{"type":"string"},"email":{"type":"string"},"email_verified_at":{"format":"date-time","type":["string","null"]},"entitlement_status":{"type":"string"},"id":{"format":"uuid","type":"string"},"plan":{"type":"string"},"reserved_micredits":{"format":"int64","type":"integer"},"status":{"type":"string"},"subscription_current_period_end":{"format":"date-time","type":["string","null"]},"trial_expires_at":{"format":"date-time","type":["string","null"]}},"required":["balance_micredits","device_cap","display_name","email","entitlement_status","id","plan","reserved_micredits","status"],"title":"CustomerAccount","type":"object"},"CustomerDevice":{"properties":{"created_at":{"format":"date-time","type":"string"},"id":{"format":"uuid","type":"string"},"label":{"type":["string","null"]},"last_seen_at":{"format":"date-time","type":"string"},"platform":{"type":"string"},"token_expires_at":{"format":"date-time","type":["string","null"]},"token_prefix":{"type":["string","null"]}},"required":["created_at","id","last_seen_at","platform"],"title":"CustomerDevice","type":"object"},"DashboardSummary":{"properties":{"active_users":{"format":"int64","type":"integer"},"average_latency_ms":{"format":"int64","type":"integer"},"credits_24h":{"format":"int64","type":"integer"},"enabled_providers":{"format":"int64","type":"integer"},"failed_24h":{"format":"int64","type":"integer"},"pending_reservations":{"format":"int64","type":"integer"},"requests_24h":{"format":"int64","type":"integer"},"successful_24h":{"format":"int64","type":"integer"}},"required":["active_users","average_latency_ms","credits_24h","enabled_providers","failed_24h","pending_reservations","requests_24h","successful_24h"],"title":"DashboardSummary","type":"object"},"DeviceAdminView":{"properties":{"created_at":{"format":"date-time","type":"string"},"id":{"format":"uuid","type":"string"},"install_id":{"format":"uuid","type":"string"},"label":{"type":["string","null"]},"last_seen_at":{"format":"date-time","type":"string"},"platform":{"type":"string"},"revoked_at":{"format":"date-time","type":["string","null"]},"token_expires_at":{"format":"date-time","type":["string","null"]},"token_prefix":{"type":["string","null"]}},"required":["created_at","id","install_id","last_seen_at","platform"],"title":"DeviceAdminView","type":"object"},"DirectProviderPayload":{"additionalProperties":true,"description":"Provider-native JSON or multipart fields forwarded only to the selected saved provider.","type":"object"},"DirectProviderResponse":{"additionalProperties":true,"description":"Provider-native diagnostic response. Binary provider responses retain their upstream content type.","type":"object"},"EmbeddingInput":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"items":{"format":"int64","type":"integer"},"type":"array"},{"items":{"items":{"format":"int64","type":"integer"},"type":"array"},"type":"array"}]},"EmbeddingItem":{"properties":{"embedding":true,"index":{"format":"uint","minimum":0.0,"type":"integer"},"object":{"type":"string"}},"required":["embedding","index","object"],"type":"object"},"EmbeddingRequest":{"properties":{"dimensions":{"format":"uint32","minimum":0.0,"type":["integer","null"]},"encoding_format":{"type":["string","null"]},"input":{"$ref":"#/components/schemas/EmbeddingInput"},"model":{"type":"string"},"user":{"type":["string","null"]}},"required":["input","model"],"title":"EmbeddingRequest","type":"object"},"EmbeddingResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EmbeddingItem"},"type":"array"},"model":{"type":"string"},"object":{"type":"string"},"usage":{"$ref":"#/components/schemas/EmbeddingUsage"}},"required":["data","model","object","usage"],"title":"EmbeddingResponse","type":"object"},"EmbeddingUsage":{"properties":{"prompt_tokens":{"format":"int64","type":"integer"},"total_tokens":{"format":"int64","type":"integer"}},"required":["prompt_tokens","total_tokens"],"type":"object"},"Error":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"type":{"type":"string"}},"required":["code","message","type"],"type":"object"}},"required":["error"],"type":"object"},"GoogleCallbackRequest":{"properties":{"code":{"type":"string"},"code_verifier":{"type":"string"},"state":{"type":"string"}},"required":["code","code_verifier","state"],"title":"GoogleCallbackRequest","type":"object"},"GoogleStartResponse":{"properties":{"authorization_url":{"type":"string"},"code_verifier":{"type":"string"},"expires_at":{"format":"date-time","type":"string"},"state":{"type":"string"}},"required":["authorization_url","code_verifier","expires_at","state"],"title":"GoogleStartResponse","type":"object"},"HealthResponse":{"properties":{"status":{"type":"string"}},"required":["status"],"title":"HealthResponse","type":"object"},"ImageEditForm":{"properties":{"image":{"format":"binary","type":"string"},"mask":{"format":"binary","type":"string"},"model":{"type":"string"},"n":{"maximum":10,"minimum":1,"type":"integer"},"prompt":{"type":"string"},"size":{"type":"string"}},"required":["model","prompt","image"],"type":"object"},"ImageGenerationRequest":{"properties":{"model":{"type":"string"},"n":{"default":1,"format":"int64","type":"integer"},"prompt":{"type":"string"},"quality":{"default":null,"type":["string","null"]},"size":{"default":"1024x1024","type":"string"}},"required":["model","prompt"],"title":"ImageGenerationRequest","type":"object"},"ImageResponse":{"description":"The normalized image response returned to the client.","properties":{"created":{"format":"int64","type":"integer"},"data":{"items":true,"type":"array"}},"required":["created","data"],"title":"ImageResponse","type":"object"},"JobView":{"properties":{"attempts":{"format":"int32","type":"integer"},"capability":{"type":"string"},"completed_at":{"format":"date-time","type":["string","null"]},"created_at":{"format":"date-time","type":"string"},"error_code":{"type":["string","null"]},"id":{"format":"uuid","type":"string"},"max_attempts":{"format":"int32","type":"integer"},"model":{"type":"string"},"result":true,"settled_charge_micredits":{"format":"int64","type":["integer","null"]},"settled_usage":true,"status":{"type":"string"},"updated_at":{"format":"date-time","type":"string"}},"required":["attempts","capability","created_at","id","max_attempts","model","status","updated_at"],"title":"JobView","type":"object"},"LedgerEntry":{"description":"One append-only ledger row, without any prompt or response content.","properties":{"amount_micredits":{"format":"int64","type":"integer"},"balance_after_micredits":{"format":"int64","type":"integer"},"created_at":{"format":"date-time","type":"string"},"id":{"format":"int64","type":"integer"},"input_tokens":{"format":"int64","type":["integer","null"]},"meter_quantity_milliunits":{"format":"int64","type":["integer","null"]},"meter_unit":{"type":["string","null"]},"output_tokens":{"format":"int64","type":["integer","null"]},"provider":{"type":["string","null"]},"public_model":{"type":["string","null"]},"transaction_type":{"type":"string"},"usage":true},"required":["amount_micredits","balance_after_micredits","created_at","id","transaction_type"],"title":"LedgerEntry","type":"object"},"LicenseResponse":{"properties":{"license_key":{"type":"string"},"tier":{"type":"string"}},"required":["license_key","tier"],"title":"LicenseResponse","type":"object"},"LoginRequest":{"properties":{"email":{"type":"string"},"password":{"type":"string"}},"required":["email","password"],"title":"LoginRequest","type":"object"},"MintTokenRequest":{"properties":{"allowed_models":{"default":[],"items":{"type":"string"},"type":"array"},"expires_at":{"format":"date-time","type":["string","null"]},"name":{"type":"string"},"requests_per_minute":{"format":"int32","type":["integer","null"]},"scopes":{"default":[],"items":{"type":"string"},"type":"array"},"spend_limit_micredits":{"format":"int64","type":["integer","null"]},"spend_window_seconds":{"format":"int64","type":["integer","null"]}},"required":["name"],"title":"MintTokenRequest","type":"object"},"MintedToken":{"properties":{"allowed_models":{"items":{"type":"string"},"type":"array"},"expires_at":{"format":"date-time","type":["string","null"]},"id":{"format":"uuid","type":"string"},"requests_per_minute":{"format":"int32","type":["integer","null"]},"spend_limit_micredits":{"format":"int64","type":["integer","null"]},"spend_window_seconds":{"format":"int64","type":["integer","null"]},"token":{"type":"string"},"token_prefix":{"type":"string"}},"required":["allowed_models","id","token","token_prefix"],"title":"MintedToken","type":"object"},"ModelItem":{"properties":{"id":{"type":"string"},"object":{"type":"string"},"owned_by":{"type":"string"}},"required":["id","object","owned_by"],"type":"object"},"ModelsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ModelItem"},"type":"array"},"object":{"type":"string"}},"required":["data","object"],"title":"ModelsResponse","type":"object"},"ModerationContent":{"oneOf":[{"properties":{"text":{"type":"string"},"type":{"enum":["text"],"type":"string"}},"required":["text","type"],"type":"object"},{"properties":{"image_url":{"$ref":"#/components/schemas/ModerationImageUrl"},"type":{"enum":["image_url"],"type":"string"}},"required":["image_url","type"],"type":"object"}]},"ModerationImageUrl":{"properties":{"url":{"type":"string"}},"required":["url"],"type":"object"},"ModerationInput":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"items":{"$ref":"#/components/schemas/ModerationContent"},"type":"array"}]},"ModerationRequest":{"properties":{"input":{"$ref":"#/components/schemas/ModerationInput"},"model":{"type":"string"}},"required":["input","model"],"title":"ModerationRequest","type":"object"},"ModerationResponse":{"properties":{"id":{"type":"string"},"model":{"type":"string"},"results":{"items":true,"type":"array"}},"required":["id","model","results"],"title":"ModerationResponse","type":"object"},"MutationResponse":{"properties":{"changed":{"type":"boolean"}},"required":["changed"],"title":"MutationResponse","type":"object"},"OperationCheckpointRequest":{"properties":{"details":{"default":null},"succeeded":{"type":"boolean"}},"required":["succeeded"],"title":"OperationCheckpointRequest","type":"object"},"OperationalStatus":{"properties":{"active_maintenance_leases":{"format":"int64","type":"integer"},"active_workers":{"format":"int64","type":"integer"},"backup_last_success_at":{"format":"date-time","type":["string","null"]},"degraded_providers":{"format":"int64","type":"integer"},"down_providers":{"format":"int64","type":"integer"},"failed_jobs_24h":{"format":"int64","type":"integer"},"failed_maintenance_operations":{"format":"int64","type":"integer"},"healthy_providers":{"format":"int64","type":"integer"},"last_reconciliation_at":{"format":"date-time","type":["string","null"]},"last_request_at":{"format":"date-time","type":["string","null"]},"last_retention_cleanup_at":{"format":"date-time","type":["string","null"]},"last_worker_activity_at":{"format":"date-time","type":["string","null"]},"last_worker_heartbeat_at":{"format":"date-time","type":["string","null"]},"oldest_queue_age_seconds":{"format":"int64","type":"integer"},"pending_reservations":{"format":"int64","type":"integer"},"pending_reserved_micredits":{"format":"int64","type":"integer"},"queued_jobs":{"format":"int64","type":"integer"},"restore_last_success_at":{"format":"date-time","type":["string","null"]},"retrying_jobs":{"format":"int64","type":"integer"},"running_jobs":{"format":"int64","type":"integer"},"settled_micredits_24h":{"format":"int64","type":"integer"},"settlements_24h":{"format":"int64","type":"integer"},"stale_workers":{"format":"int64","type":"integer"},"unknown_providers":{"format":"int64","type":"integer"}},"required":["active_maintenance_leases","active_workers","degraded_providers","down_providers","failed_jobs_24h","failed_maintenance_operations","healthy_providers","oldest_queue_age_seconds","pending_reservations","pending_reserved_micredits","queued_jobs","retrying_jobs","running_jobs","settled_micredits_24h","settlements_24h","stale_workers","unknown_providers"],"title":"OperationalStatus","type":"object"},"PricingItem":{"properties":{"capability":{"type":"string"},"currency":{"type":"string"},"effective_from":{"format":"date-time","type":"string"},"image_micredits":{"format":"int64","type":"integer"},"input_micredits_per_million":{"format":"int64","type":"integer"},"meter_unit":{"type":"string"},"minimum_charge_micredits":{"format":"int64","type":"integer"},"model":{"type":"string"},"output_micredits_per_million":{"format":"int64","type":"integer"},"price_config":true,"unit_micredits_per_million":{"format":"int64","type":"integer"}},"required":["capability","currency","effective_from","image_micredits","input_micredits_per_million","meter_unit","minimum_charge_micredits","model","output_micredits_per_million","price_config","unit_micredits_per_million"],"title":"PricingItem","type":"object"},"ProviderConnection":{"properties":{"base_url":{"type":"string"},"circuit_open_until":{"format":"date-time","type":["string","null"]},"consecutive_failures":{"format":"int32","type":"integer"},"discovered_models":true,"enabled":{"type":"boolean"},"health_status":{"type":"string"},"id":{"format":"uuid","type":"string"},"last_error_category":{"type":["string","null"]},"last_success_at":{"format":"date-time","type":["string","null"]},"last_tested_at":{"format":"date-time","type":["string","null"]},"name":{"type":"string"},"provider_type":{"type":"string"},"timeout_seconds":{"format":"int32","type":"integer"}},"required":["base_url","consecutive_failures","discovered_models","enabled","health_status","id","name","provider_type","timeout_seconds"],"title":"ProviderConnection","type":"object"},"ProviderRequest":{"properties":{"base_url":{"type":"string"},"enabled":{"default":true,"type":"boolean"},"id":{"format":"uuid","type":["string","null"]},"name":{"type":"string"},"provider_type":{"type":"string"},"secret":{"type":["string","null"]},"secret_reference":{"type":["string","null"]},"timeout_seconds":{"default":120,"format":"int32","type":"integer"}},"required":["base_url","name","provider_type"],"title":"ProviderRequest","type":"object"},"ProviderTestResponse":{"properties":{"assigned_models":{"items":{"type":"string"},"type":"array"},"changed":{"type":"boolean"},"credential_valid":{"type":"boolean"},"discovered_models":{"items":{"type":"string"},"type":"array"},"health_status":{"type":"string"},"tested_at":{"format":"date-time","type":"string"},"unavailable_assigned_models":{"items":{"type":"string"},"type":"array"}},"required":["assigned_models","changed","credential_valid","discovered_models","health_status","tested_at","unavailable_assigned_models"],"title":"ProviderTestResponse","type":"object"},"ProvisionRequest":{"additionalProperties":false,"properties":{"install_id":{"format":"uuid","type":["string","null"]},"license_key":{"type":["string","null"]}},"title":"ProvisionRequest","type":"object"},"ProvisionResponse":{"properties":{"token":{"type":"string"}},"required":["token"],"title":"ProvisionResponse","type":"object"},"RecommendedRoutesResponse":{"properties":{"enabled":{"type":"boolean"},"installed":{"items":{"type":"string"},"type":"array"},"pricing_review_required":{"items":{"type":"string"},"type":"array"}},"required":["enabled","installed","pricing_review_required"],"title":"RecommendedRoutesResponse","type":"object"},"RegisterRequest":{"properties":{"email":{"type":"string"},"name":{"type":"string"},"password":{"type":"string"}},"required":["email","name","password"],"title":"RegisterRequest","type":"object"},"RegisterResponse":{"properties":{"account_id":{"format":"uuid","type":"string"},"verification_required":{"type":"boolean"}},"required":["account_id","verification_required"],"title":"RegisterResponse","type":"object"},"RequestEvent":{"properties":{"capability":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"credits_micredits":{"format":"int64","type":["integer","null"]},"error_category":{"type":["string","null"]},"image_count":{"format":"int32","type":["integer","null"]},"input_tokens":{"format":"int64","type":["integer","null"]},"latency_ms":{"format":"int64","type":"integer"},"output_tokens":{"format":"int64","type":["integer","null"]},"provider":{"type":["string","null"]},"public_model":{"type":["string","null"]},"request_id":{"format":"uuid","type":"string"},"status_code":{"format":"int32","type":"integer"},"usage_estimated":{"type":"boolean"}},"required":["capability","created_at","latency_ms","request_id","status_code","usage_estimated"],"title":"RequestEvent","type":"object"},"ResendVerificationRequest":{"properties":{"email":{"type":"string"}},"required":["email"],"title":"ResendVerificationRequest","type":"object"},"ResendVerificationResponse":{"properties":{"accepted":{"type":"boolean"}},"required":["accepted"],"title":"ResendVerificationResponse","type":"object"},"ResponsesRequest":{"additionalProperties":true,"properties":{"background":{"default":false,"type":"boolean"},"input":true,"model":{"type":"string"},"stream":{"default":false,"type":"boolean"}},"required":["input","model"],"title":"ResponsesRequest","type":"object"},"ResponsesResponse":{"additionalProperties":true,"properties":{"id":{"type":"string"},"model":{"type":"string"},"object":{"type":"string"},"output":{"items":true,"type":"array"},"status":{"type":"string"},"usage":{"anyOf":[{"$ref":"#/components/schemas/ResponsesUsage"},{"type":"null"}]}},"required":["id","model","object","output","status"],"title":"ResponsesResponse","type":"object"},"ResponsesUsage":{"additionalProperties":true,"properties":{"input_tokens":{"format":"int64","type":"integer"},"output_tokens":{"format":"int64","type":"integer"},"total_tokens":{"format":"int64","type":"integer"}},"required":["input_tokens","output_tokens","total_tokens"],"type":"object"},"RetentionCleanup":{"properties":{"artifacts":{"format":"uint64","minimum":0.0,"type":"integer"},"events":{"format":"uint64","minimum":0.0,"type":"integer"},"jobs":{"format":"uint64","minimum":0.0,"type":"integer"}},"required":["artifacts","events","jobs"],"title":"RetentionCleanup","type":"object"},"RetentionCleanupRequest":{"properties":{"max_age_seconds":{"format":"int64","type":"integer"}},"required":["max_age_seconds"],"title":"RetentionCleanupRequest","type":"object"},"RouteListing":{"description":"A full route definition plus its effective prices, used by admin listing.","properties":{"base_url":{"type":"string"},"capability":{"type":"string"},"credential_env":{"type":"string"},"enabled":{"type":"boolean"},"fallback_public_model":{"type":["string","null"]},"image_micredits":{"format":"int64","type":"integer"},"input_micredits_per_million":{"format":"int64","type":"integer"},"max_reservation_micredits":{"format":"int64","type":"integer"},"meter_unit":{"type":"string"},"minimum_charge_micredits":{"format":"int64","type":"integer"},"output_micredits_per_million":{"format":"int64","type":"integer"},"price_config":true,"priority":{"format":"int32","type":"integer"},"provider_connection_id":{"format":"uuid","type":["string","null"]},"provider_id":{"type":"string"},"public_model":{"type":"string"},"unit_micredits_per_million":{"format":"int64","type":"integer"},"upstream_model":{"type":"string"}},"required":["base_url","capability","credential_env","enabled","image_micredits","input_micredits_per_million","max_reservation_micredits","meter_unit","minimum_charge_micredits","output_micredits_per_million","price_config","priority","provider_id","public_model","unit_micredits_per_million","upstream_model"],"title":"RouteListing","type":"object"},"RouteRequest":{"properties":{"base_url":{"type":"string"},"capability":{"type":"string"},"credential_env":{"type":"string"},"fallback_public_model":{"default":null,"type":["string","null"]},"image_micredits":{"default":0,"format":"int64","type":"integer"},"input_micredits_per_million":{"default":0,"format":"int64","type":"integer"},"max_reservation_micredits":{"format":"int64","type":"integer"},"meter_unit":{"default":"token","type":"string"},"minimum_charge_micredits":{"default":0,"format":"int64","type":"integer"},"output_micredits_per_million":{"default":0,"format":"int64","type":"integer"},"price_config":{"default":null},"priority":{"default":0,"format":"int32","type":"integer"},"provider_connection_id":{"default":null,"format":"uuid","type":["string","null"]},"provider_id":{"type":"string"},"public_model":{"type":"string"},"unit_micredits_per_million":{"default":0,"format":"int64","type":"integer"},"upstream_model":{"type":"string"}},"required":["base_url","capability","credential_env","max_reservation_micredits","provider_id","public_model","upstream_model"],"title":"RouteRequest","type":"object"},"SpeechRequest":{"properties":{"model_id":{"type":"string"},"text":{"type":"string"}},"required":["model_id","text"],"title":"SpeechRequest","type":"object"},"StripeWebhookResponse":{"properties":{"duplicate":{"type":"boolean"},"received":{"type":"boolean"}},"required":["received"],"type":"object"},"SubmitJob":{"properties":{"capability":{"type":"string"},"input":true,"max_attempts":{"default":3,"format":"int32","type":"integer"},"model":{"type":"string"},"webhook_url":{"type":["string","null"]}},"required":["capability","input","model"],"title":"SubmitJob","type":"object"},"TokenSummary":{"description":"One access token's non-secret metadata. The token hash is never selected.","properties":{"allowed_models":{"items":{"type":"string"},"type":"array"},"created_at":{"format":"date-time","type":"string"},"expires_at":{"format":"date-time","type":["string","null"]},"id":{"format":"uuid","type":"string"},"last_used_at":{"format":"date-time","type":["string","null"]},"name":{"type":"string"},"requests_per_minute":{"format":"int32","type":["integer","null"]},"revoked_at":{"format":"date-time","type":["string","null"]},"scopes":{"items":{"type":"string"},"type":"array"},"spend_limit_micredits":{"format":"int64","type":["integer","null"]},"spend_window_seconds":{"format":"int64","type":["integer","null"]},"token_prefix":{"type":"string"}},"required":["allowed_models","created_at","id","name","scopes","token_prefix"],"title":"TokenSummary","type":"object"},"TranscriptionResponse":{"additionalProperties":true,"description":"OpenAI-compatible transcription or translation response.","properties":{"text":{"type":"string"}},"type":"object"},"TrialSetupRequest":{"properties":{"install_id":{"format":"uuid","type":"string"}},"required":["install_id"],"title":"TrialSetupRequest","type":"object"},"TrialSetupResponse":{"properties":{"client_secret":{"type":"string"}},"required":["client_secret"],"title":"TrialSetupResponse","type":"object"},"UpdateAccountRequest":{"properties":{"device_cap":{"format":"int32","type":["integer","null"]},"entitlement_status":{"type":["string","null"]},"status":{"type":["string","null"]}},"title":"UpdateAccountRequest","type":"object"},"UpdateAdminRequest":{"properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"title":"UpdateAdminRequest","type":"object"},"UpdateRouteRequest":{"properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"title":"UpdateRouteRequest","type":"object"},"UpdateUserRequest":{"properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"title":"UpdateUserRequest","type":"object"},"Usage":{"description":"Final, always-complete usage returned to the client and used for billing.","properties":{"completion_tokens":{"format":"int64","type":"integer"},"prompt_tokens":{"format":"int64","type":"integer"},"total_tokens":{"format":"int64","type":"integer"}},"required":["completion_tokens","prompt_tokens","total_tokens"],"type":"object"},"UsageSummary":{"properties":{"credits_micredits":{"format":"int64","type":"integer"},"meter_quantity_milliunits":{"format":"int64","type":"integer"},"meter_unit":{"type":"string"},"provider":{"type":"string"},"public_model":{"type":"string"},"requests":{"format":"int64","type":"integer"},"user_email":{"type":"string"},"user_id":{"format":"uuid","type":"string"}},"required":["credits_micredits","meter_quantity_milliunits","meter_unit","provider","public_model","requests","user_email","user_id"],"title":"UsageSummary","type":"object"},"UserSummary":{"description":"One row of the administrative user listing (identity plus live balance).","properties":{"balance_micredits":{"format":"int64","type":"integer"},"email":{"type":"string"},"id":{"format":"uuid","type":"string"},"reserved_micredits":{"format":"int64","type":"integer"},"status":{"type":"string"}},"required":["balance_micredits","email","id","reserved_micredits","status"],"title":"UserSummary","type":"object"},"VerifyEmailRequest":{"properties":{"token":{"type":"string"}},"required":["token"],"title":"VerifyEmailRequest","type":"object"},"VoiceCatalog":{"additionalProperties":true,"description":"Provider-compatible voice catalog. ElevenLabs responses include voices and pagination metadata.","type":"object"},"WebhookDelivery":{"properties":{"attempts":{"format":"int32","type":"integer"},"created_at":{"format":"date-time","type":"string"},"delivered_at":{"format":"date-time","type":["string","null"]},"event_type":{"type":"string"},"id":{"format":"uuid","type":"string"},"job_id":{"format":"uuid","type":"string"},"last_error":{"type":["string","null"]},"max_attempts":{"format":"int32","type":"integer"},"status":{"type":"string"},"updated_at":{"format":"date-time","type":"string"},"url":{"type":"string"},"user_id":{"format":"uuid","type":"string"}},"required":["attempts","created_at","event_type","id","job_id","max_attempts","status","updated_at","url","user_id"],"title":"DeliveryView","type":"object"}},"securitySchemes":{"AccountSession":{"bearerFormat":"customer account session","scheme":"bearer","type":"http"},"AdminSession":{"bearerFormat":"administrator session","scheme":"bearer","type":"http"},"ConsumerToken":{"bearerFormat":"alw_*","scheme":"bearer","type":"http"}}},"info":{"description":"Multi-user AI routing, durable execution, metering, provider administration, and operations.","title":"Alwafi AI Router API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/admin/v1/accounts":{"get":{"operationId":"get__admin_v1_accounts","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AccountAdminView"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List customer accounts","tags":["Accounts and licensing"]}},"/admin/v1/accounts/{account_id}/devices/{device_id}":{"delete":{"operationId":"delete__admin_v1_accounts__account_id__devices__device_id","parameters":[{"in":"path","name":"account_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"device_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Revoke provisioned device","tags":["Accounts and licensing"]}},"/admin/v1/accounts/{id}":{"get":{"operationId":"get__admin_v1_accounts__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountAdminView"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Get customer account","tags":["Accounts and licensing"]},"patch":{"operationId":"patch__admin_v1_accounts__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Update customer account controls","tags":["Accounts and licensing"]}},"/admin/v1/accounts/{id}/devices":{"get":{"operationId":"get__admin_v1_accounts__id__devices","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DeviceAdminView"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List provisioned devices","tags":["Accounts and licensing"]}},"/admin/v1/admins":{"get":{"operationId":"get__admin_v1_admins","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_id","required":false,"schema":{"format":"uuid","type":"string"}},{"in":"query","name":"enabled","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AdminAccount"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List administrators","tags":["Administration"]},"post":{"operationId":"post__admin_v1_admins","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAdminRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminAccount"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Create administrator","tags":["Administration"]}},"/admin/v1/admins/{id}":{"patch":{"operationId":"patch__admin_v1_admins__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Update administrator","tags":["Administration"]}},"/admin/v1/audit":{"get":{"operationId":"get__admin_v1_audit","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_number","required":false,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AuditEntry"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List audit entries","tags":["Administration"]}},"/admin/v1/dashboard":{"get":{"operationId":"get__admin_v1_dashboard","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashboardSummary"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Get dashboard summary","tags":["Operations"]}},"/admin/v1/jobs":{"get":{"operationId":"get__admin_v1_jobs","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_created_at","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"cursor_id","required":false,"schema":{"format":"uuid","type":"string"}},{"in":"query","name":"capability","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AdminJobView"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List durable jobs","tags":["Durable jobs"]}},"/admin/v1/me":{"get":{"operationId":"get__admin_v1_me","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminPrincipal"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Get administrator identity","tags":["Administration"]}},"/admin/v1/operations/checkpoints/{kind}":{"post":{"operationId":"post__admin_v1_operations_checkpoints__kind","parameters":[{"in":"path","name":"kind","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationCheckpointRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Report a verified backup or restore checkpoint","tags":["Operations"]}},"/admin/v1/operations/reconcile":{"post":{"operationId":"post__admin_v1_operations_reconcile","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Reconcile stale reservations","tags":["Operations"]}},"/admin/v1/operations/retention-cleanup":{"post":{"operationId":"post__admin_v1_operations_retention-cleanup","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionCleanupRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionCleanup"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Erase expired durable content","tags":["Operations"]}},"/admin/v1/operations/status":{"get":{"operationId":"get__admin_v1_operations_status","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationalStatus"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Inspect distributed operational status","tags":["Operations"]}},"/admin/v1/providers":{"get":{"operationId":"get__admin_v1_providers","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_id","required":false,"schema":{"format":"uuid","type":"string"}},{"in":"query","name":"enabled","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ProviderConnection"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List provider connections","tags":["Providers and routes"]},"post":{"operationId":"post__admin_v1_providers","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderConnection"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Create or replace provider","tags":["Providers and routes"]}},"/admin/v1/providers/{id}":{"delete":{"operationId":"delete__admin_v1_providers__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Delete provider","tags":["Providers and routes"]}},"/admin/v1/providers/{id}/invoke/{capability}":{"post":{"operationId":"post__admin_v1_providers__id__invoke__capability","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"path","name":"capability","required":true,"schema":{"type":"string"}},{"description":"Required for direct ElevenLabs speech diagnostics","in":"query","name":"voice_id","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectProviderPayload"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectProviderResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Invoke a saved provider directly for diagnostics","tags":["Providers and routes"]}},"/admin/v1/providers/{id}/recommended-routes":{"post":{"operationId":"post__admin_v1_providers__id__recommended-routes","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendedRoutesResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Install disabled DigitalOcean route templates","tags":["Providers and routes"]}},"/admin/v1/providers/{id}/test":{"post":{"operationId":"post__admin_v1_providers__id__test","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderTestResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Test credentials and discover models","tags":["Providers and routes"]}},"/admin/v1/requests":{"get":{"operationId":"get__admin_v1_requests","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_created_at","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"cursor_id","required":false,"schema":{"format":"uuid","type":"string"}},{"in":"query","name":"capability","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/RequestEvent"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List request telemetry","tags":["Operations"]}},"/admin/v1/routes":{"get":{"operationId":"get__admin_v1_routes","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_model","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_capability","required":false,"schema":{"type":"string"}},{"in":"query","name":"capability","required":false,"schema":{"type":"string"}},{"in":"query","name":"enabled","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/RouteListing"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List model routes","tags":["Providers and routes"]},"post":{"operationId":"post__admin_v1_routes","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Create or replace route","tags":["Providers and routes"]}},"/admin/v1/routes/{capability}/{model}":{"patch":{"operationId":"patch__admin_v1_routes__capability___model","parameters":[{"in":"path","name":"capability","required":true,"schema":{"type":"string"}},{"in":"path","name":"model","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRouteRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Enable or disable route","tags":["Providers and routes"]}},"/admin/v1/session":{"delete":{"operationId":"delete__admin_v1_session","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Delete administrator session","tags":["Administration"]},"post":{"operationId":"post__admin_v1_session","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminSession"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Create administrator session","tags":["Administration"]}},"/admin/v1/tokens/{id}":{"delete":{"operationId":"delete__admin_v1_tokens__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Revoke access token","tags":["Users and credits"]}},"/admin/v1/usage":{"get":{"operationId":"get__admin_v1_usage","parameters":[{"in":"query","name":"from","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"to","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/UsageSummary"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Summarize native usage and charged credits","tags":["Users and credits"]}},"/admin/v1/users":{"get":{"operationId":"get__admin_v1_users","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_id","required":false,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/UserSummary"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List users","tags":["Users and credits"]},"post":{"operationId":"post__admin_v1_users","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserSummary"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Create user","tags":["Users and credits"]}},"/admin/v1/users/{id}":{"patch":{"operationId":"patch__admin_v1_users__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Update user","tags":["Users and credits"]}},"/admin/v1/users/{id}/credits":{"post":{"operationId":"post__admin_v1_users__id__credits","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Balance"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Grant or adjust credits","tags":["Users and credits"]}},"/admin/v1/users/{id}/ledger":{"get":{"operationId":"get__admin_v1_users__id__ledger","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_number","required":false,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/LedgerEntry"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List credit ledger","tags":["Users and credits"]}},"/admin/v1/users/{id}/tokens":{"get":{"operationId":"get__admin_v1_users__id__tokens","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_id","required":false,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/TokenSummary"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List access tokens","tags":["Users and credits"]},"post":{"operationId":"post__admin_v1_users__id__tokens","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintTokenRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MintedToken"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"Mint access token","tags":["Users and credits"]}},"/admin/v1/voices":{"get":{"operationId":"get__admin_v1_voices","parameters":[{"in":"query","name":"search","required":false,"schema":{"type":"string"}},{"in":"query","name":"page_size","required":false,"schema":{"type":"integer"}},{"in":"query","name":"next_page_token","required":false,"schema":{"type":"string"}},{"in":"query","name":"voice_type","required":false,"schema":{"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"in":"query","name":"sort_direction","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceCatalog"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List voices as administrator","tags":["Discovery"]}},"/admin/v1/webhooks":{"get":{"operationId":"get__admin_v1_webhooks","parameters":[{"in":"query","name":"limit","required":false,"schema":{"maximum":500,"minimum":1,"type":"integer"}},{"description":"Case-insensitive search","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Resource-specific state filter","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor_created_at","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"cursor_id","required":false,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookDelivery"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AdminSession":[]}],"summary":"List durable webhook deliveries","tags":["Durable jobs"]}},"/health":{"get":{"operationId":"get__health","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Gateway liveness","tags":["Operations"]}},"/health/ready":{"get":{"operationId":"get__health_ready","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Gateway readiness","tags":["Operations"]}},"/metrics":{"get":{"operationId":"get__metrics","parameters":[],"responses":{"200":{"content":{"text/plain":{"schema":{"type":"string"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Prometheus metrics","tags":["Operations"]}},"/v1/accounts/devices":{"get":{"operationId":"get__v1_accounts_devices","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CustomerDevice"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"List active customer devices","tags":["Accounts and licensing"]}},"/v1/accounts/devices/{id}":{"delete":{"operationId":"delete__v1_accounts_devices__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Revoke a customer device and its token","tags":["Accounts and licensing"]}},"/v1/accounts/google/callback":{"post":{"operationId":"post__v1_accounts_google_callback","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCallbackRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSessionResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Exchange Google authorization code","tags":["Customer accounts"]}},"/v1/accounts/google/start":{"post":{"operationId":"post__v1_accounts_google_start","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleStartResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Start Google OIDC with state and PKCE","tags":["Customer accounts"]}},"/v1/accounts/license":{"get":{"operationId":"get__v1_accounts_license","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LicenseResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Download current signed license","tags":["Accounts and licensing"]}},"/v1/accounts/licenses/subscription":{"post":{"operationId":"post__v1_accounts_licenses_subscription","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LicenseResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Issue another subscription device license","tags":["Accounts and licensing"]}},"/v1/accounts/me":{"get":{"operationId":"get__v1_accounts_me","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerAccount"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Get customer account","tags":["Customer accounts"]}},"/v1/accounts/plan/byok":{"post":{"operationId":"post__v1_accounts_plan_byok","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LicenseResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Select BYOK and issue signed license","tags":["Accounts and licensing"]}},"/v1/accounts/register":{"post":{"operationId":"post__v1_accounts_register","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Register email and password account","tags":["Customer accounts"]}},"/v1/accounts/resend-verification":{"post":{"operationId":"post__v1_accounts_resend-verification","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendVerificationRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendVerificationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Send a replacement email verification link","tags":["Customer accounts"]}},"/v1/accounts/session":{"delete":{"operationId":"delete__v1_accounts_session","parameters":[],"responses":{"204":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Revoke customer session","tags":["Customer accounts"]},"post":{"operationId":"post__v1_accounts_session","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountLoginRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSessionResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Create customer session","tags":["Customer accounts"]}},"/v1/accounts/verify-email":{"post":{"operationId":"post__v1_accounts_verify-email","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerAccount"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Verify customer email","tags":["Customer accounts"]}},"/v1/audio/transcriptions":{"post":{"operationId":"post__v1_audio_transcriptions","parameters":[],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/AudioForm"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Transcribe audio","tags":["Consumer AI"]}},"/v1/audio/translations":{"post":{"operationId":"post__v1_audio_translations","parameters":[],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/AudioForm"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Translate audio to English","tags":["Consumer AI"]}},"/v1/billing/stripe/webhook":{"post":{"operationId":"post__v1_billing_stripe_webhook","parameters":[{"description":"Stripe timestamped HMAC signature over the unmodified request body","in":"header","name":"Stripe-Signature","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeWebhookResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Process signed Stripe lifecycle event","tags":["Billing"]}},"/v1/billing/subscription/checkout":{"post":{"operationId":"post__v1_billing_subscription_checkout","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Create Stripe subscription Checkout","tags":["Billing"]}},"/v1/billing/trial/setup-intent":{"post":{"operationId":"post__v1_billing_trial_setup-intent","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialSetupRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrialSetupResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"AccountSession":[]}],"summary":"Create card-verification SetupIntent","tags":["Billing"]}},"/v1/chat/completions":{"post":{"operationId":"post__v1_chat_completions","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatResponse"}},"text/event-stream":{"description":"OpenAI-compatible chunks; [DONE] is emitted only after usage settlement","schema":{"type":"string"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Create chat completion","tags":["Consumer AI"]}},"/v1/embeddings":{"post":{"operationId":"post__v1_embeddings","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Create vector embeddings","tags":["Consumer AI"]}},"/v1/images/edits":{"post":{"operationId":"post__v1_images_edits","parameters":[],"requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/ImageEditForm"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Edit images","tags":["Consumer AI"]}},"/v1/images/generations":{"post":{"operationId":"post__v1_images_generations","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Generate images","tags":["Consumer AI"]}},"/v1/jobs":{"post":{"operationId":"post__v1_jobs","parameters":[{"description":"Stable client key for lossless duplicate submission","in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitJob"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobView"}}},"description":"Successful response","headers":{"Location":{"description":"Polling URL for the accepted durable job","schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Submit durable job","tags":["Durable jobs"]}},"/v1/jobs/{id}":{"delete":{"operationId":"delete__v1_jobs__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobView"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Cancel durable job","tags":["Durable jobs"]},"get":{"operationId":"get__v1_jobs__id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobView"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Get durable job","tags":["Durable jobs"]}},"/v1/jobs/{id}/events":{"get":{"operationId":"get__v1_jobs__id__events","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Resume after the last processed durable event","in":"header","name":"Last-Event-ID","required":false,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"text/event-stream":{"examples":{"event":{"value":"id: 42\nevent: succeeded\ndata: {\"status\":\"succeeded\"}\n\n"}},"schema":{"type":"string"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Stream durable job events","tags":["Durable jobs"]}},"/v1/jobs/{job_id}/artifacts/{artifact_id}":{"get":{"operationId":"get__v1_jobs__job_id__artifacts__artifact_id","parameters":[{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"artifact_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Download durable artifact","tags":["Durable jobs"]}},"/v1/me/balance":{"get":{"operationId":"get__v1_me_balance","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Balance"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Get credit balance","tags":["Discovery"]}},"/v1/models":{"get":{"operationId":"get__v1_models","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelsResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"List available models","tags":["Discovery"]}},"/v1/moderations":{"post":{"operationId":"post__v1_moderations","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModerationResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Classify potentially harmful content","tags":["Consumer AI"]}},"/v1/pricing":{"get":{"operationId":"get__v1_pricing","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PricingItem"},"type":"array"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"List capability pricing","tags":["Discovery"]}},"/v1/provision":{"post":{"operationId":"post__v1_provision","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvisionResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[],"summary":"Provision or rotate an Expressly device token","tags":["Provisioning"]}},"/v1/responses":{"post":{"operationId":"post__v1_responses","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponsesRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponsesResponse"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Create a tool-capable model response","tags":["Consumer AI"]}},"/v1/text-to-speech/{voice_id}":{"post":{"operationId":"post__v1_text-to-speech__voice_id","parameters":[{"in":"path","name":"voice_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpeechRequest"}}},"required":true},"responses":{"200":{"content":{"audio/mpeg":{"schema":{"format":"binary","type":"string"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"Synthesize speech","tags":["Consumer AI"]}},"/v1/voices":{"get":{"operationId":"get__v1_voices","parameters":[{"in":"query","name":"search","required":false,"schema":{"type":"string"}},{"in":"query","name":"page_size","required":false,"schema":{"type":"integer"}},{"in":"query","name":"next_page_token","required":false,"schema":{"type":"string"}},{"in":"query","name":"voice_type","required":false,"schema":{"type":"string"}},{"in":"query","name":"category","required":false,"schema":{"type":"string"}},{"in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"in":"query","name":"sort_direction","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoiceCatalog"}}},"description":"Successful response"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"$ref":"#/components/responses/UpstreamFailure"}},"security":[{"ConsumerToken":[]}],"summary":"List provider voices","tags":["Discovery"]}}},"servers":[{"description":"Current Alwafi deployment","url":"/"}],"tags":[{"name":"Consumer AI"},{"name":"Durable jobs"},{"name":"Discovery"},{"name":"Users and credits"},{"name":"Providers and routes"},{"name":"Administration"},{"name":"Operations"},{"name":"Customer accounts"},{"name":"Accounts and licensing"},{"name":"Billing"},{"name":"Provisioning"}]}