{"openapi":"3.1.0","info":{"title":"AI Power Grid — Streaming API","description":"OpenAI and Anthropic compatible endpoints with real token streaming.","version":"1.0.0"},"paths":{"/v1/chat/completions":{"post":{"summary":"Chat Completions","description":"OpenAI-compatible chat completions with real streaming.","operationId":"chat_completions_v1_chat_completions_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/x402/chat/completions":{"post":{"summary":"X402 Chat Completions","description":"Accountless, non-streaming chat paid per request in Base USDC.","operationId":"x402_chat_completions_v1_x402_chat_completions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/models":{"get":{"summary":"List Models","description":"List TEXT models available from connected workers.\n\nThis is the OpenAI chat-completions model list (what UI model pickers read),\nso it returns text models only — image/video models are served via the media\njob API, not chat-completions, and must not appear in a chat picker.","operationId":"list_models_v1_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/models/{model_id}":{"get":{"summary":"Get Model","description":"Get info for a specific text model.","operationId":"get_model_v1_models__model_id__get","parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string","title":"Model Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/models/{model_id}/recipe":{"get":{"summary":"Get Model Recipe","description":"Authenticated worker inventory: canary-resolved media recipes and files.\n\nGoverned video recipes also publish their contract and separately expanded\nsource requirements. Reading/checking inventory does not submit a smoke job,\nenable admission or prove GPU execution/model fidelity.","operationId":"get_model_recipe_v1_models__model_id__recipe_get","parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string","title":"Model Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/models/{model_id}/params":{"get":{"summary":"Get Model Params","description":"The adjustable parameter schema for a model — ranges, enums, capabilities.\n\nMedia (image/video) models are recipe-governed: every knob is hard-gated to the\nband shown here (out-of-band values are rejected, not silently clamped), so this\nis the authoritative \"what can I send\" for a model. Text models report the\nstandard OpenAI sampler set plus the faithful-passthrough note. Describes the\nparameter contract, independent of live worker availability.","operationId":"get_model_params_v1_models__model_id__params_get","parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string","title":"Model Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pricing":{"get":{"summary":"Pricing Catalog","operationId":"pricing_catalog_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPricingCatalog"}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"summary":"Protected Resource Metadata","operationId":"protected_resource_metadata__well_known_oauth_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"summary":"Authorization Server Metadata","operationId":"authorization_server_metadata__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/register":{"post":{"summary":"Register Client","operationId":"register_client_v1_oauth_register_post","responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/authorize":{"get":{"summary":"Authorize","operationId":"authorize_v1_oauth_authorize_get","parameters":[{"name":"response_type","in":"query","required":true,"schema":{"type":"string","title":"Response Type"}},{"name":"client_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":96,"title":"Client Id"}},{"name":"redirect_uri","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2048,"title":"Redirect Uri"}},{"name":"scope","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"title":"Scope"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":512,"title":"State"}},{"name":"code_challenge","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Code Challenge"}},{"name":"code_challenge_method","in":"query","required":true,"schema":{"type":"string","title":"Code Challenge Method"}},{"name":"resource","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":512,"title":"Resource"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/authorization/inspect":{"post":{"summary":"Inspect Authorization","operationId":"inspect_authorization_v1_oauth_authorization_inspect_post","parameters":[{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationCapability"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/authorization/decision":{"post":{"summary":"Decide Authorization","operationId":"decide_authorization_v1_oauth_authorization_decision_post","parameters":[{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/token":{"post":{"summary":"Token","operationId":"token_v1_oauth_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/revoke":{"post":{"summary":"Revoke","description":"RFC 7009 revocation for public clients. Always 200 for a well-formed request.","operationId":"revoke_v1_oauth_revoke_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/sessions":{"get":{"summary":"List Sessions","operationId":"list_sessions_v1_oauth_sessions_get","parameters":[{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/sessions/revoke":{"post":{"summary":"Revoke Session","operationId":"revoke_session_v1_oauth_sessions_revoke_post","parameters":[{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionRevocation"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/introspect":{"post":{"summary":"Introspect","operationId":"introspect_v1_oauth_introspect_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/messages":{"post":{"summary":"Create Message","description":"Anthropic-compatible messages endpoint (raw passthrough to a capable worker).","operationId":"create_message_v1_messages_post","parameters":[{"name":"x-api-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/responses":{"post":{"summary":"Create Response","description":"OpenAI-compatible Responses endpoint (raw passthrough to a capable worker).","operationId":"create_response_v1_responses_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/images/generations":{"post":{"summary":"Create Image","description":"OpenAI-compatible image generation.","operationId":"create_image_v1_images_generations_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/media/results":{"get":{"summary":"Recover Media","operationId":"recover_media_v1_media_results_get","parameters":[{"name":"job_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Job Id"}},{"name":"client_ref","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}],"title":"Client Ref"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/videos/generations":{"post":{"summary":"Create Video","description":"Text-to-video generation (grid-native, OpenAI-style envelope).","operationId":"create_video_v1_videos_generations_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/videos/jobs":{"post":{"summary":"Submit Video Job","operationId":"submit_video_job_v1_videos_jobs_post","parameters":[{"name":"idempotency-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsyncVideoRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"summary":"Get Video Request","description":"Recover a lost submission reply without another POST or input upload.","operationId":"get_video_request_v1_videos_jobs_get","parameters":[{"name":"idempotency-key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/videos/jobs/{job_id}":{"get":{"summary":"Get Video Job","operationId":"get_video_job_v1_videos_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audio/generations":{"post":{"summary":"Create Audio","description":"Generate one WAV using a Core-governed local ACE-Step recipe.","operationId":"create_audio_v1_audio_generations_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/3d/generations":{"post":{"summary":"Create 3D","description":"Image-to-3D mesh generation (grid-native envelope).","operationId":"create_3d_v1_3d_generations_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreeDRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/enrollments":{"post":{"summary":"Create Worker Enrollment","operationId":"create_worker_enrollment_v1_workers_enrollments_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEnrollment"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/enrollments/{enrollment_id}":{"get":{"summary":"Get Worker Enrollment","operationId":"get_worker_enrollment_v1_workers_enrollments__enrollment_id__get","parameters":[{"name":"enrollment_id","in":"path","required":true,"schema":{"type":"string","title":"Enrollment Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/enrollments/{enrollment_id}/prepare":{"post":{"summary":"Prepare Worker Enrollment","operationId":"prepare_worker_enrollment_v1_workers_enrollments__enrollment_id__prepare_post","parameters":[{"name":"enrollment_id","in":"path","required":true,"schema":{"type":"string","title":"Enrollment Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepareEnrollment"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/enrollments/{enrollment_id}/approve":{"post":{"summary":"Approve Worker Enrollment","operationId":"approve_worker_enrollment_v1_workers_enrollments__enrollment_id__approve_post","parameters":[{"name":"enrollment_id","in":"path","required":true,"schema":{"type":"string","title":"Enrollment Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveEnrollment"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/enrollments/{enrollment_id}/poll":{"post":{"summary":"Poll Worker Enrollment","operationId":"poll_worker_enrollment_v1_workers_enrollments__enrollment_id__poll_post","parameters":[{"name":"enrollment_id","in":"path","required":true,"schema":{"type":"string","title":"Enrollment Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PollEnrollment"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/enrollments/{enrollment_id}/ack":{"post":{"summary":"Acknowledge Worker Enrollment","operationId":"acknowledge_worker_enrollment_v1_workers_enrollments__enrollment_id__ack_post","parameters":[{"name":"enrollment_id","in":"path","required":true,"schema":{"type":"string","title":"Enrollment Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PollEnrollment"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/self/media-jobs":{"post":{"summary":"Worker Media Status","operationId":"worker_media_status_v1_workers_self_media_jobs_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkerMediaRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkerMediaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers":{"get":{"summary":"List Workers","description":"Currently-connected workers (live, from the Redis registry).","operationId":"list_workers_v1_workers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/jobs/recent":{"get":{"summary":"Jobs Recent","description":"PUBLIC, no-auth recent-jobs feed — the live face of the grid.\n\nRedacted by design: shows THAT a job happened, on which model, by which\nworker (handle), how fast, plus its content COMMITMENT (prompt/result\nhashes + whether the worker signed it) — but NEVER the prompt or result,\nand NEVER the customer wallet/account. Private inference, public\naccountability. Source is grid_ledger (the same append-only rows settlement\npays against), so this feed and the payouts can never disagree.","operationId":"jobs_recent_v1_jobs_recent_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/progress/{token}":{"get":{"summary":"Job Progress","description":"Latest generation progress (0–100) for a client-supplied progress_token.\n\nMedia jobs run synchronously on the worker; the worker streams ComfyUI's\nper-step % to the grid, which stashes the latest value under this token so a\nclient can poll it while its (blocking) generation request is in flight.\nReturns {progress: int|null} — null when nothing has been reported yet.","operationId":"job_progress_v1_progress__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/status/models":{"get":{"summary":"Status Models","description":"Models currently served, with how many workers serve each — plus recent\nper-model performance (t/s, TTFT, avg latency) from the last 24h of ledger\ntiming. Includes recipe-backed public model names when compatible workers\nhave every required checkpoint, not just raw worker-advertised checkpoints.","operationId":"status_models_v1_status_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/status/network":{"get":{"summary":"Status Network","description":"Public, privacy-safe operational status for the whole Grid.\n\nThis is a current-state view, not an incident-history system. Component\nfailures are returned as redacted incidents while independent capacity and\ndecentralization limitations remain explicit advisories.","operationId":"status_network_v1_status_network_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/status/routing":{"get":{"summary":"Status Routing","description":"Observability for `model: \"auto\"` — performance scores + weights.\n\nValidator evidence has no routing authority. Current scores use only\nGrid-measured throughput and latency; the response states that boundary so\nscorecards cannot be mistaken for route inputs.","operationId":"status_routing_v1_status_routing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/stats/totals":{"get":{"summary":"Stats Totals","description":"Job/den totals by job type for day, month, and all time — from the\nledger, so these are exactly the numbers settlement pays on.","operationId":"stats_totals_v1_stats_totals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/stats/models":{"get":{"summary":"Stats Models","description":"Per-model job counts + den over a period (minute/hour/day/month/total).","operationId":"stats_models_v1_stats_models_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"month","title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/wallets/{address}/earnings":{"get":{"summary":"Wallet Earnings","description":"Den earnings for a wallet, straight from the ledger settlement pays on.","operationId":"wallet_earnings_v1_wallets__address__earnings_get","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","title":"Address"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/payouts/public":{"get":{"summary":"Payouts Public","description":"PUBLIC, no-auth worker-payout transparency. Aggregate only — NO account\nIDs / PII; just on-chain payout wallets + tx hashes (already public on Base).\nFeeds the /transparency page so anyone can verify what's been paid to workers.","operationId":"payouts_public_v1_payouts_public_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/styles":{"get":{"summary":"List Styles","description":"List curated styles, optionally filtered by job_type (image|video).","operationId":"list_styles_v1_styles_get","parameters":[{"name":"job_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/capabilities":{"get":{"summary":"Validator Capabilities","description":"Advertise which validator surfaces this core supports.","operationId":"validator_capabilities_v1_validator_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/validator/register":{"post":{"summary":"Register Validator","description":"Register the account's linked wallet as an active preview validator.","operationId":"register_validator_v1_validator_register_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/registration":{"get":{"summary":"Validator Registration","operationId":"validator_registration_v1_validator_registration_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/public/{validator_id}":{"get":{"summary":"Validator Public Status","description":"Return one validator's redacted public cohort and liveness status.","operationId":"validator_public_status_v1_validator_public__validator_id__get","parameters":[{"name":"validator_id","in":"path","required":true,"schema":{"type":"string","title":"Validator Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/suspend":{"post":{"summary":"Suspend Validator","description":"Stop new assignments using a fresh registered-wallet signature.","operationId":"suspend_validator_v1_validator_suspend_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/rotate":{"post":{"summary":"Rotate Validator","description":"Bind the stable validator identity to the account's newly linked wallet.","operationId":"rotate_validator_v1_validator_rotate_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/heartbeat":{"post":{"summary":"Validator Heartbeat","operationId":"validator_heartbeat_v1_validator_heartbeat_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HeartbeatForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/assignments":{"get":{"summary":"Validator Assignments","description":"Return Grid-issued assignments for this validator account.\n\nAssignments are short-lived. In sealed mode polling returns a commitment,\nwhile target, nonce, model, and challenge arrive only after probe completion.\nAn attestation becomes authoritative only if the disclosure verifies and\nthe signed evidence matches Core's stored assignment.","operationId":"validator_assignments_v1_validator_assignments_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":5,"title":"Limit"}},{"name":"modality","in":"query","required":false,"schema":{"type":"string","pattern":"^(text|text-fidelity|image|video)$","default":"text","title":"Modality"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/assignments/health":{"get":{"summary":"Validator Assignment Health","description":"Return assignment evidence health for the current validator account.","operationId":"validator_assignment_health_v1_validator_assignments_health_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}},{"name":"since_hours","in":"query","required":false,"schema":{"type":"integer","maximum":2160,"minimum":1,"default":24,"title":"Since Hours"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/probe/{assignment_id}":{"post":{"summary":"Validator Probe","description":"Run a hard-targeted probe for one Grid-issued assignment.","operationId":"validator_probe_v1_validator_probe__assignment_id__post","parameters":[{"name":"assignment_id","in":"path","required":true,"schema":{"type":"string","title":"Assignment Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/attest":{"post":{"summary":"Submit Attestation","description":"Store one validator attestation as preview or authoritative evidence.","operationId":"submit_attestation_v1_validator_attest_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validator-scorecards":{"get":{"summary":"Account Validator Scorecards","description":"Read redacted network evidence without registering a validator node.\n\nAccount-read authority grants no private assignment health, node identity,\nwork allocation, probe execution or attestation permission.","operationId":"account_validator_scorecards_v1_account_validator_scorecards_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"since_hours","in":"query","required":false,"schema":{"type":"integer","maximum":2160,"minimum":1,"default":168,"title":"Since Hours"}},{"name":"worker_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Worker Id"}},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Model"}},{"name":"authority","in":"query","required":false,"schema":{"type":"string","pattern":"^(all|preview|authoritative)$","default":"all","title":"Authority"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/scorecards":{"get":{"summary":"Validator Scorecards","description":"Return aggregate validator evidence for scorecards.\n\nRows are grouped by authority so preview evidence cannot be mistaken for\nassignment-bound evidence. Raw payloads, nonces, signatures, account IDs,\nand validator identities are intentionally omitted.","operationId":"validator_scorecards_v1_validator_scorecards_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"since_hours","in":"query","required":false,"schema":{"type":"integer","maximum":2160,"minimum":1,"default":168,"title":"Since Hours"}},{"name":"worker_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Worker Id"}},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Model"}},{"name":"authority","in":"query","required":false,"schema":{"type":"string","pattern":"^(all|preview|authoritative)$","default":"all","title":"Authority"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/workers":{"get":{"summary":"Validator Workers","description":"Return live worker inventory for validator discovery.","operationId":"validator_workers_v1_validator_workers_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/account-pairings":{"post":{"summary":"Create Pairing","operationId":"create_pairing_v1_validator_account_pairings_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/account-pairing":{"get":{"summary":"Poll Pairing","operationId":"poll_pairing_v1_validator_account_pairing_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/account-pairings/{pairing_id}/confirm":{"post":{"summary":"Confirm Pairing","operationId":"confirm_pairing_v1_validator_account_pairings__pairing_id__confirm_post","parameters":[{"name":"pairing_id","in":"path","required":true,"schema":{"type":"string","title":"Pairing Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/account-pairings/{pairing_id}/cancel":{"post":{"summary":"Cancel Pairing","operationId":"cancel_pairing_v1_validator_account_pairings__pairing_id__cancel_post","parameters":[{"name":"pairing_id","in":"path","required":true,"schema":{"type":"string","title":"Pairing Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/account-link":{"get":{"summary":"Node Link","operationId":"node_link_v1_validator_account_link_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/account-link/unlink":{"post":{"summary":"Unlink From Node","operationId":"unlink_from_node_v1_validator_account_link_unlink_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeUnlinkForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validator-pairings/{pairing_id}":{"get":{"summary":"Inspect Pairing","operationId":"inspect_pairing_v1_account_validator_pairings__pairing_id__get","parameters":[{"name":"pairing_id","in":"path","required":true,"schema":{"type":"string","title":"Pairing Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validator-pairings/{pairing_id}/approve":{"post":{"summary":"Approve Pairing","operationId":"approve_pairing_v1_account_validator_pairings__pairing_id__approve_post","parameters":[{"name":"pairing_id","in":"path","required":true,"schema":{"type":"string","title":"Pairing Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validators":{"get":{"summary":"Account Validators","operationId":"account_validators_v1_account_validators_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validators/{validator_id}/unlink":{"post":{"summary":"Unlink Validator","operationId":"unlink_validator_v1_account_validators__validator_id__unlink_post","parameters":[{"name":"validator_id","in":"path","required":true,"schema":{"type":"string","title":"Validator Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnlinkForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/compensation":{"get":{"summary":"Node Status","operationId":"node_status_v1_validator_compensation_get","parameters":[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/compensation/{allocation_hash}/requests":{"post":{"summary":"Start Request","operationId":"start_request_v1_validator_compensation__allocation_hash__requests_post","parameters":[{"name":"allocation_hash","in":"path","required":true,"schema":{"type":"string","title":"Allocation Hash"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/compensation/requests/{request_id}":{"get":{"summary":"Node Request","operationId":"node_request_v1_validator_compensation_requests__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/compensation/requests/{request_id}/confirm":{"post":{"summary":"Node Confirm","operationId":"node_confirm_v1_validator_compensation_requests__request_id__confirm_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/compensation/requests/{request_id}/cancel":{"post":{"summary":"Node Cancel","operationId":"node_cancel_v1_validator_compensation_requests__request_id__cancel_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validator-compensation/requests/{request_id}":{"get":{"summary":"Account Request","operationId":"account_request_v1_account_validator_compensation_requests__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validator-compensation/requests/{request_id}/prepare":{"post":{"summary":"Account Prepare","operationId":"account_prepare_v1_account_validator_compensation_requests__request_id__prepare_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/validator-compensation/requests/{request_id}/approve":{"post":{"summary":"Account Approve","operationId":"account_approve_v1_account_validator_compensation_requests__request_id__approve_post","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts/wallet/nonce":{"post":{"summary":"Wallet Nonce","operationId":"wallet_nonce_v1_accounts_wallet_nonce_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/accounts/wallet/challenge":{"post":{"summary":"Wallet Challenge","description":"Issue a domain-, address-, URI-, chain-, and time-bound EIP-4361 message.","operationId":"wallet_challenge_v1_accounts_wallet_challenge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletChallengeForm"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts/wallet/verify":{"post":{"summary":"Wallet Verify","description":"Verify a wallet signature and issue a short-lived Core user token.","operationId":"wallet_verify_v1_accounts_wallet_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletVerifyForm"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/identities/wallet/link":{"post":{"summary":"Link Wallet","description":"Attach a wallet to the current canonical account with proof of both sides.\n\nThe session key proves the destination account; the exact-purpose signature\nproves the wallet. If that wallet already owns a separate account, the\ntested merge path conserves balances and retires the source credentials.","operationId":"link_wallet_v1_account_identities_wallet_link_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletLinkForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/identities/wallet/link/asserted":{"post":{"summary":"Link Wallet From Assertion","description":"Link a wallet to a delegated user account with proof of both.","operationId":"link_wallet_from_assertion_v1_account_identities_wallet_link_asserted_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletLinkForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts":{"post":{"summary":"Create Account","description":"Dashboard-only account creation (email/OAuth users).\n\nRequires GRID_INTERNAL_TOKEN; the dashboard verifies the user's email or\nOAuth identity itself and calls this with the result.","operationId":"create_account_v1_accounts_post","parameters":[{"name":"x-internal-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Internal-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts/bridges":{"post":{"summary":"Create Identity Bridge","description":"Bootstrap a bounded service account. Disable after provisioning.","operationId":"create_identity_bridge_v1_accounts_bridges_post","parameters":[{"name":"x-internal-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Internal-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBridgeForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/service/exchange":{"post":{"summary":"Exchange Service Identity","description":"Exchange one service-local authenticated subject for a short user token.","operationId":"exchange_service_identity_v1_auth_service_exchange_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceExchangeForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/wallet/challenge":{"post":{"summary":"Exchange Wallet Challenge","description":"Issue a partner-, app-subject-, origin-, and wallet-bound SIWE challenge.","operationId":"exchange_wallet_challenge_v1_auth_wallet_challenge_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceWalletChallengeForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/wallet/exchange":{"post":{"summary":"Exchange Wallet Identity","description":"Verify partner SIWE, merge the app identity, and issue a canonical token.","operationId":"exchange_wallet_identity_v1_auth_wallet_exchange_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceWalletExchangeForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/google/exchange":{"post":{"summary":"Exchange Google Identity","description":"Verify Google with Google, then issue a short Core account token.","operationId":"exchange_google_identity_v1_auth_google_exchange_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleExchangeForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/service/bind":{"post":{"summary":"Bind Service Identity","description":"Bind a service-local subject after fresh Core Google/SIWE proof.","operationId":"bind_service_identity_v1_auth_service_bind_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BindServiceIdentityForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/accounts/session":{"post":{"summary":"Account Session","description":"Dashboard login hook: find-or-create the account, rotate its\ndashboard-session key, return the fresh key.\n\nInternal-token gated (the dashboard verified the user via OAuth/wallet\nitself). Exactly one active \"dashboard-session\" key exists per account —\neach login revokes the previous one, so a leaked old session key is dead\nthe moment the user logs in again.","operationId":"account_session_v1_accounts_session_post","parameters":[{"name":"x-internal-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Internal-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/ownership":{"get":{"summary":"Get Account Ownership","description":"Private canonical ownership for recovering app data after proven merges.","operationId":"get_account_ownership_v1_account_ownership_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account":{"get":{"summary":"Get Account","operationId":"get_account_v1_account_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/payout-wallet":{"post":{"summary":"Set Payout Wallet","description":"Set the Base address worker earnings are paid to. No ownership proof\n(mining-style — point earnings wherever you want); the address is only\nformat-checked. Distinct from the login wallet, so an OAuth/username\noperator can receive payouts.","operationId":"set_payout_wallet_v1_account_payout_wallet_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutWalletForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/payout-preference":{"post":{"summary":"Set Payout Preference","description":"Set the worker's payout asset (USDC/USDS/ETH/AIPG) and/or AIPG-slice\noverride. Session-gated — a leaked inference key must not be able to change\nHOW you're paid, same as payout-wallet.","operationId":"set_payout_preference_v1_account_payout_preference_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutPreferenceForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/jobs":{"get":{"summary":"Get Account Jobs","description":"The caller's own worker jobs — the operator trust view. What my workers\nserved, the den each earned, its output commitment, and whether it was\nsigned. Scoped to my payout wallet (the same key settlement pays against, so\nthis can't disagree with what I'm owed). Same privacy rule as the public\nfeed: no prompt/result content, only hashes.","operationId":"get_account_jobs_v1_account_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/workers":{"get":{"summary":"Get Account Workers","description":"Workers registered to the signed-in account, with live online status.\n\nOwnership is by account_id (workers connect with just an API key). `online`\nis the live Redis presence set; den_earned/jobs_completed are the running\ncounters (authoritative totals always derivable from the ledger).","operationId":"get_account_workers_v1_account_workers_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/self":{"get":{"summary":"Get Worker Self Status","description":"Return operational state for exactly the rig bound to a worker key.\n\nThis endpoint deliberately does not grant account.read. It exposes no\naccount identity, sibling workers, payout address, balances, payout amount,\nor transaction history.","operationId":"get_worker_self_status_v1_workers_self_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/workers/self/canary":{"post":{"summary":"Run Worker Self Canary","description":"Run one economically inert connectivity canary on the exact bound rig.","operationId":"run_worker_self_canary_v1_workers_self_canary_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/payouts":{"get":{"summary":"Get Account Payouts","description":"Custodial payout history for the signed-in account.\n\nSourced from grid_payouts (written by the hourly settlement run): what's\nbeen **paid** (with on-chain tx hashes as proof) and what's **accrued**\n(owed, but parked until a payout wallet is set). Same den source of truth\nas the ledger; AIPG is distributed pro-rata by den per period.","operationId":"get_account_payouts_v1_account_payouts_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/deposits/claim":{"post":{"summary":"Claim Deposit","description":"Credit the account for a USDC-on-Base deposit to the grid treasury.\n\nThe user sends USDC on Base, then submits the tx hash here; the grid verifies\nthe on-chain transfer (to the treasury, from the account's own wallet, enough\nconfirmations) and credits the prepaid balance 1:1. Idempotent on the tx hash.\n503 until the grid is configured with a treasury address (GRID_USDC_TREASURY).","operationId":"claim_deposit_v1_account_deposits_claim_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDepositForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/deposits/claim-aipg":{"post":{"summary":"Claim Aipg Deposit","description":"Credit a direct AIPG-on-Base deposit under the current price epoch.\n\nAIPG funding is available only while an operator-published valuation is\nfresh. Core applies a haircut and hard transaction/account/network caps\nbefore atomically writing the deposit receipt and purchased credit.","operationId":"claim_aipg_deposit_v1_account_deposits_claim_aipg_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDepositForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/deposits/claim-eth":{"post":{"summary":"Claim Eth Deposit","description":"Credit the account for a native-ETH deposit to the grid treasury.\n\nDirect ETH is disabled by default. A tightly capped ``buffered`` pilot can\nbe enabled explicitly; the target production flow swaps ETH to USDC first\nand credits the actual stablecoin received.","operationId":"claim_eth_deposit_v1_account_deposits_claim_eth_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDepositForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/deposits/claim-eth-converted":{"post":{"summary":"Claim Converted Eth Deposit","description":"Credit actual USDC delivered by a confirmed Base ETH swap transaction.","operationId":"claim_converted_eth_deposit_v1_account_deposits_claim_eth_converted_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimDepositForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/deposits/config":{"get":{"summary":"Get Deposit Config","description":"Funding assets, Base addresses, limits, and non-withdrawable terms.","operationId":"get_deposit_config_v1_account_deposits_config_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/deposits":{"get":{"summary":"Get Deposit History","description":"Immutable Base funding receipts for the authenticated account.","operationId":"get_deposit_history_v1_account_deposits_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/credits":{"get":{"summary":"Get Credits","description":"The account's spendable credits — what the front ends show as\n'X free today' + '$Y balance' + a top-up prompt.\n\nThree pockets, one USD unit (micro-USD): promotional grants (campaign-bound\nand expiring), the daily free allowance (resets UTC midnight, tiered by AIPG\nheld), and purchased balance (from on-chain deposits, never expires).\n\nThe free-first draw IS integrated into the live durable reserve path\n(authorize_request / authorize_media hold free-first with reserve/release\nsemantics), gated on GRID_FREE_SPENDABLE_LIVE. `free.active` below reflects\nthat flag: false → free is display-only and total_spendable = paid only;\ntrue → charges draw free-first and total_spendable includes it.\ncharging_enabled is the effective gate for this account. charging_mode\nexposes the operator rollout state without exposing the allowlist.","operationId":"get_credits_v1_account_credits_get","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/credits/quote":{"post":{"summary":"Quote Credits","description":"Canonical balance and non-mutating pre-dispatch price estimate.","operationId":"quote_credits_v1_account_credits_quote_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-grid-user-assertion","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Assertion"}},{"name":"x-grid-user-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Grid-User-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditQuoteForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/keys":{"post":{"summary":"Issue Key","operationId":"issue_key_v1_account_keys_post","parameters":[{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueKeyForm"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/account/keys/{key_id}":{"delete":{"summary":"Revoke Key","description":"Revoke a key by its 12-char hash prefix (from GET /v1/account).","operationId":"revoke_key_v1_account_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"apikey","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apikey"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","description":"Health check — Redis connectivity + worker status.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/metrics":{"get":{"summary":"Metrics","description":"Prometheus metrics in text exposition format.","operationId":"metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ApproveEnrollment":{"properties":{"signature":{"type":"string","format":"password","title":"Signature","writeOnly":true}},"additionalProperties":false,"type":"object","required":["signature"],"title":"ApproveEnrollment"},"AsyncVideoRequest":{"properties":{"prompt":{"type":"string","maxLength":8000,"minLength":1,"title":"Prompt"},"model":{"type":"string","maxLength":255,"minLength":1,"title":"Model","default":"LTX-2.5 Distilled BF16"},"n":{"type":"integer","maximum":1.0,"minimum":1.0,"title":"N","default":1},"size":{"type":"string","maxLength":32,"title":"Size","default":"768x512"},"seconds":{"anyOf":[{"type":"number","maximum":26.041666666666668,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Seconds"},"frames":{"anyOf":[{"type":"integer","maximum":625.0,"minimum":9.0},{"type":"null"}],"title":"Frames"},"fps":{"type":"integer","maximum":30.0,"minimum":8.0,"title":"Fps","default":24},"image":{"anyOf":[{"type":"string","maxLength":17000000,"minLength":1},{"type":"null"}],"title":"Image"},"reference_audio":{"anyOf":[{"type":"string","maxLength":16777280,"minLength":1},{"type":"null"}],"title":"Reference Audio"},"reference_video":{"anyOf":[{"type":"string","maxLength":44739308,"minLength":1},{"type":"null"}],"title":"Reference Video"},"reference_image":{"anyOf":[{"type":"string","maxLength":16777280,"minLength":1},{"type":"null"}],"title":"Reference Image"},"keyframes":{"items":{"$ref":"#/components/schemas/VideoKeyframe"},"type":"array","maxItems":16,"title":"Keyframes"},"loras":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Loras"},"response_format":{"type":"string","const":"url","title":"Response Format","default":"url"},"worker":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Worker"},"style":{"anyOf":[{"type":"string","maxLength":128,"minLength":1},{"type":"null"}],"title":"Style"},"progress_token":{"type":"null","title":"Progress Token"},"negative_prompt":{"type":"string","maxLength":8000,"title":"Negative Prompt","default":""},"seed":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"steps":{"anyOf":[{"type":"integer","maximum":40.0,"minimum":4.0},{"type":"null"}],"title":"Steps"},"cfg_scale":{"anyOf":[{"type":"number","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Cfg Scale"},"sampler":{"type":"string","const":"euler_ancestral_cfg_pp","title":"Sampler","default":"euler_ancestral_cfg_pp"},"audio":{"type":"boolean","title":"Audio","default":true},"guide_strength":{"anyOf":[{"type":"number","maximum":1.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Guide Strength"},"reference_strength":{"anyOf":[{"type":"number","maximum":1.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Reference Strength"},"reference_attention_strength":{"anyOf":[{"type":"number","maximum":1.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Reference Attention Strength"},"motion_attention_strength":{"anyOf":[{"type":"number","maximum":1.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Motion Attention Strength"},"max_cost_micro_usd":{"type":"integer","maximum":9.223372036854776e+18,"exclusiveMinimum":0.0,"title":"Max Cost Micro Usd"}},"additionalProperties":false,"type":"object","required":["prompt","max_cost_micro_usd"],"title":"AsyncVideoRequest"},"AttestationForm":{"properties":{"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"}},"additionalProperties":false,"type":"object","required":["payload"],"title":"AttestationForm"},"AudioRequest":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":1,"title":"Prompt"},"lyrics":{"type":"string","maxLength":20000,"title":"Lyrics","default":""},"model":{"anyOf":[{"type":"string","maxLength":128,"minLength":1},{"type":"null"}],"title":"Model"},"seconds":{"type":"number","maximum":300.0,"minimum":10.0,"title":"Seconds","default":30.0},"inference_steps":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Inference Steps","default":8},"bpm":{"anyOf":[{"type":"integer","maximum":300.0,"minimum":30.0},{"type":"null"}],"title":"Bpm"},"key_scale":{"anyOf":[{"type":"string","maxLength":12,"minLength":7,"pattern":"^[A-G](?:#|b)? (?:Major|minor)$"},{"type":"null"}],"title":"Key Scale"},"time_signature":{"anyOf":[{"type":"string","enum":["2/4","3/4","4/4","6/8"]},{"type":"null"}],"title":"Time Signature"},"vocal_language":{"anyOf":[{"type":"string","maxLength":2,"minLength":2,"pattern":"^[a-z]{2}$"},{"type":"null"}],"title":"Vocal Language"},"seed":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Seed"},"worker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker"},"progress_token":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Progress Token"}},"additionalProperties":false,"type":"object","required":["prompt"],"title":"AudioRequest"},"AuthorizationCapability":{"properties":{"request":{"type":"string","maxLength":256,"minLength":32,"title":"Request"}},"type":"object","required":["request"],"title":"AuthorizationCapability"},"AuthorizationDecision":{"properties":{"request":{"type":"string","maxLength":256,"minLength":32,"title":"Request"},"approve":{"type":"boolean","title":"Approve"}},"type":"object","required":["request","approve"],"title":"AuthorizationDecision"},"BindServiceIdentityForm":{"properties":{"subject":{"type":"string","title":"Subject"},"user_token":{"type":"string","title":"User Token"}},"type":"object","required":["subject","user_token"],"title":"BindServiceIdentityForm"},"ChatCompletionRequest":{"properties":{"model":{"type":"string","title":"Model"},"messages":{"items":{"$ref":"#/components/schemas/ChatMessage"},"type":"array","title":"Messages"},"temperature":{"type":"number","maximum":2.0,"minimum":0.0,"title":"Temperature","default":0.7},"top_p":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Top P","default":0.9},"max_tokens":{"anyOf":[{"type":"integer","maximum":32768.0,"minimum":1.0},{"type":"null"}],"title":"Max Tokens"},"stream":{"type":"boolean","title":"Stream","default":false},"n":{"type":"integer","title":"N","default":1},"tools":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Tools"},"tool_choice":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Choice"},"stop":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Stop"},"presence_penalty":{"anyOf":[{"type":"number","maximum":2.0,"minimum":-2.0},{"type":"null"}],"title":"Presence Penalty"},"frequency_penalty":{"anyOf":[{"type":"number","maximum":2.0,"minimum":-2.0},{"type":"null"}],"title":"Frequency Penalty"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"response_format":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Response Format"},"stream_options":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Stream Options"}},"additionalProperties":true,"type":"object","required":["model","messages"],"title":"ChatCompletionRequest","description":"OpenAI chat-completions request.\n\n`extra=\"allow\"` is deliberate: a developer should be able to send any\nparameter their local vLLM accepts (logit_bias, seed, repetition_penalty,\nguided_json, …) and have it reach the worker unchanged. We only pin down\nthe few fields the grid itself reads (model, messages, max_tokens, stream)\nplus light bounds on the common knobs."},"ChatMessage":{"properties":{"role":{"type":"string","enum":["system","user","assistant","tool","developer"],"title":"Role"},"content":{"anyOf":[{"type":"string"},{"items":{},"type":"array"},{"type":"null"}],"title":"Content"}},"additionalProperties":true,"type":"object","required":["role"],"title":"ChatMessage","description":"One OpenAI chat message.\n\nFaithful-passthrough principle: validate only what we must, let everything\nelse flow. `content` may be a string OR a list of content parts\n(multimodal: text + image_url). `role` includes \"tool\" so tool-result\nturns round-trip. `extra=\"allow\"` keeps any field we don't model\n(e.g. `name`, `tool_calls`, `tool_call_id`, `refusal`) intact end-to-end."},"ClaimDepositForm":{"properties":{"tx_hash":{"type":"string","title":"Tx Hash"}},"type":"object","required":["tx_hash"],"title":"ClaimDepositForm"},"ConfirmForm":{"properties":{"signature":{"type":"string","maxLength":132,"minLength":130,"format":"password","title":"Signature","writeOnly":true}},"additionalProperties":false,"type":"object","required":["signature"],"title":"ConfirmForm"},"CreateAccountForm":{"properties":{"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"oauth_sub":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Sub"}},"type":"object","title":"CreateAccountForm"},"CreateBridgeForm":{"properties":{"label":{"type":"string","title":"Label"},"service_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service Id"},"allowed_providers":{"items":{"type":"string"},"type":"array","title":"Allowed Providers"},"google_audiences":{"items":{"type":"string"},"type":"array","title":"Google Audiences"},"siwe_domains":{"items":{"type":"string"},"type":"array","title":"Siwe Domains"},"per_request_micro":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Request Micro"},"daily_micro":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Daily Micro"},"allow_direct_inference":{"type":"boolean","title":"Allow Direct Inference","default":false}},"type":"object","required":["label"],"title":"CreateBridgeForm"},"CreateEnrollment":{"properties":{"worker_signer":{"type":"string","maxLength":42,"minLength":42,"title":"Worker Signer"},"worker_name":{"type":"string","maxLength":120,"minLength":1,"title":"Worker Name"},"profile_id":{"type":"string","maxLength":128,"minLength":1,"title":"Profile Id"},"api_key":{"type":"string","format":"password","title":"Api Key","writeOnly":true},"poll_token_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Poll Token Hash"},"valid_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Valid Days","default":90}},"additionalProperties":false,"type":"object","required":["worker_signer","worker_name","profile_id","api_key","poll_token_hash"],"title":"CreateEnrollment"},"CreditQuoteForm":{"properties":{"model":{"type":"string","maxLength":256,"minLength":1,"title":"Model"},"modality":{"type":"string","enum":["text","image","video","audio","3d"],"title":"Modality"},"prompt_tokens":{"type":"integer","maximum":2000000.0,"minimum":0.0,"title":"Prompt Tokens","default":0},"max_tokens":{"type":"integer","maximum":1000000.0,"minimum":0.0,"title":"Max Tokens","default":0},"n":{"type":"integer","maximum":16.0,"minimum":1.0,"title":"N","default":1},"seconds":{"anyOf":[{"type":"number","maximum":3600.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Seconds"},"frames":{"anyOf":[{"type":"integer","maximum":625.0,"minimum":9.0},{"type":"null"}],"title":"Frames"}},"additionalProperties":false,"type":"object","required":["model","modality"],"title":"CreditQuoteForm"},"GoogleExchangeForm":{"properties":{"id_token":{"type":"string","title":"Id Token"},"app_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Subject"}},"type":"object","required":["id_token"],"title":"GoogleExchangeForm"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HeartbeatForm":{"properties":{"software_version":{"type":"string","maxLength":64,"minLength":1,"title":"Software Version"},"capabilities":{"items":{"type":"string"},"type":"array","maxItems":64,"minItems":1,"title":"Capabilities"}},"additionalProperties":false,"type":"object","required":["software_version","capabilities"],"title":"HeartbeatForm"},"ImageRequest":{"properties":{"prompt":{"type":"string","title":"Prompt"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"n":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"N","default":1},"max_cost_micro_usd":{"anyOf":[{"type":"integer","maximum":9.223372036854776e+18,"minimum":0.0},{"type":"null"}],"title":"Max Cost Micro Usd"},"size":{"type":"string","title":"Size","default":"1024x1024"},"quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quality","default":"standard"},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"loras":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Loras"},"output_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Output Format"},"response_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Format","default":"url"},"worker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker"},"style":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Style"},"progress_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Progress Token"}},"additionalProperties":true,"type":"object","required":["prompt"],"title":"ImageRequest"},"IssueKeyForm":{"properties":{"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"purpose":{"type":"string","enum":["inference","validator"],"title":"Purpose","default":"inference"}},"type":"object","title":"IssueKeyForm"},"NodeUnlinkForm":{"properties":{"pairing_id":{"type":"string","pattern":"^vpa_[0-9a-f]{64}$","title":"Pairing Id"},"issued_at":{"type":"integer","minimum":1.0,"title":"Issued At"},"signature":{"type":"string","maxLength":132,"minLength":130,"format":"password","title":"Signature","writeOnly":true}},"additionalProperties":false,"type":"object","required":["pairing_id","issued_at","signature"],"title":"NodeUnlinkForm"},"PayoutPreferenceForm":{"properties":{"asset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset"},"aipg_bps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Aipg Bps"}},"type":"object","title":"PayoutPreferenceForm"},"PayoutWalletForm":{"properties":{"wallet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet"}},"type":"object","title":"PayoutWalletForm"},"PollEnrollment":{"properties":{"poll_token":{"type":"string","format":"password","title":"Poll Token","writeOnly":true}},"additionalProperties":false,"type":"object","required":["poll_token"],"title":"PollEnrollment"},"PrepareEnrollment":{"properties":{"payout_wallet":{"type":"string","maxLength":42,"minLength":42,"title":"Payout Wallet"},"replace_payout_wallet":{"type":"boolean","title":"Replace Payout Wallet","default":false}},"additionalProperties":false,"type":"object","required":["payout_wallet"],"title":"PrepareEnrollment"},"PublicComparisonEvidence":{"properties":{"status":{"type":"string","enum":["not_yet_valid","current","stale"],"title":"Status"},"as_of":{"type":"string","title":"As Of"},"valid_until":{"type":"string","title":"Valid Until"},"items":{"items":{"$ref":"#/components/schemas/PublicPriceComparison"},"type":"array","title":"Items"},"scope":{"type":"string","title":"Scope"}},"type":"object","required":["status","as_of","valid_until","items","scope"],"title":"PublicComparisonEvidence"},"PublicModelPrice":{"properties":{"model":{"type":"string","title":"Model"},"rates":{"$ref":"#/components/schemas/PublicModelRates"}},"type":"object","required":["model","rates"],"title":"PublicModelPrice"},"PublicModelRates":{"properties":{"input_per_mtok_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Input Per Mtok Usd"},"output_per_mtok_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Output Per Mtok Usd"},"per_image_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Per Image Usd"},"per_video_second_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Per Video Second Usd"},"per_audio_second_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Per Audio Second Usd"},"per_3d_generation_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Per 3D Generation Usd"}},"type":"object","required":["input_per_mtok_usd","output_per_mtok_usd","per_image_usd","per_video_second_usd","per_audio_second_usd","per_3d_generation_usd"],"title":"PublicModelRates"},"PublicPriceBook":{"properties":{"version":{"type":"string","title":"Version"},"availability":{"type":"string","title":"Availability"},"models":{"items":{"$ref":"#/components/schemas/PublicModelPrice"},"type":"array","title":"Models"},"aliases":{"additionalProperties":{"type":"string"},"type":"object","title":"Aliases"},"default_text":{"$ref":"#/components/schemas/TextModelPricing"}},"type":"object","required":["version","availability","models","aliases","default_text"],"title":"PublicPriceBook"},"PublicPriceComparison":{"properties":{"id":{"type":"string","title":"Id"},"model":{"type":"string","title":"Model"},"modality":{"type":"string","enum":["text","image"],"title":"Modality"},"provider":{"type":"string","title":"Provider"},"source_url":{"type":"string","title":"Source Url"},"basis":{"type":"string","title":"Basis"},"workload":{"additionalProperties":{"type":"integer"},"type":"object","title":"Workload"},"competitor_rates":{"additionalProperties":{"type":"number"},"type":"object","title":"Competitor Rates"},"aipg_usd":{"type":"number","title":"Aipg Usd"},"competitor_usd":{"type":"number","title":"Competitor Usd"},"savings_percent":{"type":"number","title":"Savings Percent"}},"type":"object","required":["id","model","modality","provider","source_url","basis","workload","competitor_rates","aipg_usd","competitor_usd","savings_percent"],"title":"PublicPriceComparison"},"PublicPricingCatalog":{"properties":{"schema":{"type":"string","const":"aipg.pricing.v1","title":"Schema"},"currency":{"type":"string","const":"USD","title":"Currency"},"ledger_unit":{"type":"string","const":"micro_usd","title":"Ledger Unit"},"price_book":{"$ref":"#/components/schemas/PublicPriceBook"},"comparison_evidence":{"$ref":"#/components/schemas/PublicComparisonEvidence"}},"type":"object","required":["schema","currency","ledger_unit","price_book","comparison_evidence"],"title":"PublicPricingCatalog"},"RegistrationForm":{"properties":{"payload":{"additionalProperties":true,"type":"object","title":"Payload"},"signature":{"type":"string","maxLength":132,"minLength":130,"title":"Signature"}},"additionalProperties":false,"type":"object","required":["payload","signature"],"title":"RegistrationForm"},"ServiceExchangeForm":{"properties":{"subject":{"type":"string","title":"Subject"}},"type":"object","required":["subject"],"title":"ServiceExchangeForm"},"ServiceWalletChallengeForm":{"properties":{"address":{"type":"string","title":"Address"},"domain":{"type":"string","maxLength":255,"minLength":1,"title":"Domain"},"uri":{"type":"string","maxLength":2048,"minLength":1,"title":"Uri"},"chain_id":{"type":"integer","title":"Chain Id","default":8453},"app_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Subject"}},"type":"object","required":["address","domain","uri"],"title":"ServiceWalletChallengeForm"},"ServiceWalletExchangeForm":{"properties":{"message":{"type":"string","title":"Message"},"signature":{"type":"string","title":"Signature"},"address":{"type":"string","title":"Address"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"app_subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Subject"}},"type":"object","required":["message","signature","address"],"title":"ServiceWalletExchangeForm"},"SessionForm":{"properties":{"oauth_sub":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Sub"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"wallet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"email_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Email Verified","default":false}},"type":"object","title":"SessionForm"},"SessionRevocation":{"properties":{"session_id":{"type":"string","maxLength":64,"minLength":16,"title":"Session Id"}},"type":"object","required":["session_id"],"title":"SessionRevocation"},"TextModelPricing":{"properties":{"currency":{"type":"string","title":"Currency","default":"USD"},"input_per_mtok_usd":{"type":"number","title":"Input Per Mtok Usd"},"output_per_mtok_usd":{"type":"number","title":"Output Per Mtok Usd"},"source":{"type":"string","title":"Source"},"version":{"type":"string","title":"Version"}},"type":"object","required":["input_per_mtok_usd","output_per_mtok_usd","source","version"],"title":"TextModelPricing"},"ThreeDRequest":{"properties":{"image":{"type":"string","title":"Image"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed"},"steps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Steps"},"guidance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Guidance"},"target_faces":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target Faces"},"response_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Format","default":"url"},"worker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker"},"progress_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Progress Token"}},"additionalProperties":true,"type":"object","required":["image"],"title":"ThreeDRequest"},"UnlinkForm":{"properties":{"pairing_id":{"type":"string","pattern":"^vpa_[0-9a-f]{64}$","title":"Pairing Id"}},"additionalProperties":false,"type":"object","required":["pairing_id"],"title":"UnlinkForm"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VideoKeyframe":{"properties":{"image":{"type":"string","maxLength":17000000,"minLength":1,"title":"Image"},"frame":{"type":"integer","maximum":624.0,"minimum":0.0,"title":"Frame"},"strength":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Strength","default":1.0}},"additionalProperties":false,"type":"object","required":["image","frame"],"title":"VideoKeyframe"},"VideoRequest":{"properties":{"prompt":{"type":"string","title":"Prompt"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"n":{"type":"integer","maximum":2.0,"minimum":1.0,"title":"N","default":1},"size":{"type":"string","title":"Size","default":"768x512"},"seconds":{"anyOf":[{"type":"number","maximum":26.041666666666668,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Seconds"},"frames":{"anyOf":[{"type":"integer","maximum":625.0,"minimum":9.0},{"type":"null"}],"title":"Frames"},"fps":{"type":"integer","maximum":30.0,"minimum":8.0,"title":"Fps","default":24},"image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image"},"reference_audio":{"anyOf":[{"type":"string","maxLength":16777280,"minLength":1},{"type":"null"}],"title":"Reference Audio"},"reference_video":{"anyOf":[{"type":"string","maxLength":44739308,"minLength":1},{"type":"null"}],"title":"Reference Video"},"reference_image":{"anyOf":[{"type":"string","maxLength":16777280,"minLength":1},{"type":"null"}],"title":"Reference Image"},"keyframes":{"items":{"$ref":"#/components/schemas/VideoKeyframe"},"type":"array","maxItems":16,"title":"Keyframes"},"loras":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Loras"},"response_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Response Format","default":"url"},"worker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker"},"style":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Style"},"progress_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Progress Token"}},"additionalProperties":true,"type":"object","required":["prompt"],"title":"VideoRequest"},"WalletChallengeForm":{"properties":{"address":{"type":"string","title":"Address"},"domain":{"type":"string","maxLength":255,"minLength":1,"title":"Domain"},"uri":{"type":"string","maxLength":2048,"minLength":1,"title":"Uri"},"chain_id":{"type":"integer","title":"Chain Id","default":8453}},"type":"object","required":["address","domain","uri"],"title":"WalletChallengeForm"},"WalletLinkForm":{"properties":{"message":{"type":"string","title":"Message"},"signature":{"type":"string","title":"Signature"},"address":{"type":"string","title":"Address"}},"type":"object","required":["message","signature","address"],"title":"WalletLinkForm"},"WalletVerifyForm":{"properties":{"message":{"type":"string","title":"Message"},"signature":{"type":"string","title":"Signature"},"address":{"type":"string","title":"Address"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"}},"type":"object","required":["message","signature","address"],"title":"WalletVerifyForm"},"WorkerMediaRequest":{"properties":{"job_ids":{"items":{"type":"string"},"type":"array","maxItems":32,"minItems":1,"title":"Job Ids"}},"additionalProperties":false,"type":"object","required":["job_ids"],"title":"WorkerMediaRequest"},"WorkerMediaResponse":{"properties":{"schema":{"type":"string","const":"aipg.worker.media-journal.v1","title":"Schema"},"worker_id":{"type":"string","title":"Worker Id"},"jobs":{"items":{"$ref":"#/components/schemas/WorkerMediaState"},"type":"array","title":"Jobs"}},"type":"object","required":["schema","worker_id","jobs"],"title":"WorkerMediaResponse"},"WorkerMediaState":{"properties":{"job_id":{"type":"string","title":"Job Id"},"state":{"type":"string","enum":["held","closed","unknown"],"title":"State"}},"type":"object","required":["job_id","state"],"title":"WorkerMediaState"}}}}