Hydracept
Execution control plane for agents: capabilities, durable jobs, budgets, receipts, and BYOK.
사용해야 할까요
품질 및 안전성
발견 사항 (12)
- LOWhydracept_status에서
- LOWhydracept_quote_capability에서
- LOWestimate_capability에서
- LOWhydracept_manifest_create에서
- LOWhydracept_clear_adapter_default에서
- LOWhydracept_project_request_operation에서
- LOWhydracept_project_get_operation에서
- LOWhydracept_prepare_adapter_selection에서
- LOWhydracept_promote_adapter_alias에서
- LOWhydracept_clear_adapter_default에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"hydracept": {
"command": "uvx",
"args": [
"hydracept"
]
}
}
}실행 가능한 패키지
0.4.4stdio원격 엔드포인트
https://api.hydracept.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (38)
⚪hydracept_status(refresh)
Session diagnostics for the authenticated API key.
입력 스키마
{
"type": "object",
"properties": {
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
}
},
"title": "hydracept_statusArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_statusDictOutput"
}🟢hydracept_capabilities(key, query)
List, find, or describe capabilities. Includes one-shot readiness facts. Text job_async descriptors may include features.deferredProcessing (50% off standard token rates).
입력 스키마
{
"type": "object",
"properties": {
"key": {
"default": "",
"title": "Key",
"type": "string"
},
"query": {
"default": "",
"title": "Query",
"type": "string"
}
},
"title": "hydracept_capabilitiesArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_capabilitiesDictOutput"
}⚪resolve_capability(intent, requirements)
Determine whether Hydracept already provides a suitable capability. Does not spend money.
입력 스키마
{
"type": "object",
"properties": {
"intent": {
"title": "Intent",
"type": "string"
},
"requirements": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Requirements"
}
},
"required": [
"intent"
],
"title": "resolve_capabilityArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "resolve_capabilityDictOutput"
}🟡hydracept_quote_capability(capability_key, body, input)
POST /v1/capabilities/{key}/quote. Does not reserve or charge funds. 'input' is an alias for 'body'.
입력 스키마
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_quote_capabilityArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_quote_capabilityDictOutput"
}⚪estimate_capability(capability_key, body, input)
HTTP alias of hydracept_quote_capability. Same 0.3 retail quote. 'input' is an alias for 'body'.
입력 스키마
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "estimate_capabilityArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "estimate_capabilityDictOutput"
}⚪hydracept_invoke(capability_key, body, input)
Invoke a synchronous capability (read-only domain/DNS and text). 'input' is an alias for 'body'.
입력 스키마
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_invokeArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_invokeDictOutput"
}⚪hydracept_run(capability_key, body, wait, timeout, max_cost, ...)
hydracept.run-result.v1 over hosted HTTP. Artifact persist requires stdio MCP in a checkout. 'input' is an alias for 'body'.
입력 스키마
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"wait": {
"default": true,
"title": "Wait",
"type": "boolean"
},
"timeout": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Timeout"
},
"max_cost": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Max Cost"
},
"idempotency_key": {
"default": "",
"title": "Idempotency Key",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_runArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_runDictOutput"
}🟡request_capability_quote(body)
Create a capability REQUEST. Commission quotes are human-paid and must not be used as execution.quoteId.
입력 스키마
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "request_capability_quoteArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "request_capability_quoteDictOutput"
}🟢get_capability_request_quote(request_id)
Read the human-paid commission quote for a capability request. Never an execution.quoteId.
입력 스키마
{
"type": "object",
"properties": {
"request_id": {
"title": "Request Id",
"type": "string"
}
},
"required": [
"request_id"
],
"title": "get_capability_request_quoteArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "get_capability_request_quoteDictOutput"
}🟡hydracept_submit_job(capability_key, body, idempotency_key, input)
Submit a capability job. Omit quoteId; the API seals pricing at admission. Eligible durable text jobs use deferred processing at 50% of standard token rates. Returns nextAction. 'input' is an alias for 'body'.
입력 스키마
{
"type": "object",
"properties": {
"capability_key": {
"title": "Capability Key",
"type": "string"
},
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
},
"idempotency_key": {
"default": "",
"title": "Idempotency Key",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
}
},
"required": [
"capability_key"
],
"title": "hydracept_submit_jobArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_submit_jobDictOutput"
}🟢hydracept_job_status(job_id)
GET /v1/jobs/{jobId} once. If nextAction is poll, wait pollAfterSeconds and call again.
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_statusArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_job_statusDictOutput"
}🟢hydracept_get_receipt(job_id)
Fetch sealed receipt summary for a job.
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_get_receiptArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_get_receiptDictOutput"
}🟡hydracept_download_artifact(job_id, artifact_id)
Return artifact download metadata and content hash (hosted MCP does not write local files).
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
},
"artifact_id": {
"title": "Artifact Id",
"type": "string"
}
},
"required": [
"job_id",
"artifact_id"
],
"title": "hydracept_download_artifactArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_download_artifactDictOutput"
}⚪hydracept_smoke(capability, prompt, poll_seconds, output_path)
Explicit managed-trial smoke. Same contract as stdio: generation, pricing, SHA-256, PNG alpha.
입력 스키마
{
"type": "object",
"properties": {
"capability": {
"default": "image.generate.v1",
"title": "Capability",
"type": "string"
},
"prompt": {
"default": "flat 2D game icon of a slime, no plate, no ground, no shadow, centered, simple silhouette",
"title": "Prompt",
"type": "string"
},
"poll_seconds": {
"default": 90,
"title": "Poll Seconds",
"type": "integer"
},
"output_path": {
"default": "",
"title": "Output Path",
"type": "string"
}
},
"title": "hydracept_smokeArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_smokeDictOutput"
}🟡hydracept_pinned_run(body)
POST /v1/inference/pinned — exact pin, scientific receipt. Standard processing by default. Opt in with processing=deferred on eligible OpenAI Responses pins (50% Flex). One logical model execution, no truncation rewrite, no Flex→Standard fallback. Pre-inference capacity 429s may retry.
입력 스키마
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_runArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_runDictOutput"
}🟡hydracept_pinned_bulk(body)
POST /v1/inference/pinned/bulk — concurrent pinned items, one logical execution each.
입력 스키마
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_pinned_bulkArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulkDictOutput"
}🟢hydracept_pinned_get(receipt_id)
GET /v1/inference/pinned/{receipt_id}.
입력 스키마
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_pinned_getArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_getDictOutput"
}🟢hydracept_pinned_bulk_get(bulk_id)
GET /v1/inference/pinned/bulk/{bulk_id} once. If nextAction is poll, wait pollAfterSeconds and call again.
입력 스키마
{
"type": "object",
"properties": {
"bulk_id": {
"title": "Bulk Id",
"type": "string"
}
},
"required": [
"bulk_id"
],
"title": "hydracept_pinned_bulk_getArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_pinned_bulk_getDictOutput"
}🟡hydracept_manifest_create(body)
POST /v1/provenance/manifests.
입력 스키마
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_manifest_createArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_createDictOutput"
}🟡hydracept_manifest_verify(manifest_id)
POST /v1/provenance/manifests/{manifest_id}/verify.
입력 스키마
{
"type": "object",
"properties": {
"manifest_id": {
"title": "Manifest Id",
"type": "string"
}
},
"required": [
"manifest_id"
],
"title": "hydracept_manifest_verifyArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_manifest_verifyDictOutput"
}🟢hydracept_lockfile_emit(receipt_id)
GET /v1/provenance/lockfile?receipt_id=.
입력 스키마
{
"type": "object",
"properties": {
"receipt_id": {
"title": "Receipt Id",
"type": "string"
}
},
"required": [
"receipt_id"
],
"title": "hydracept_lockfile_emitArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_lockfile_emitDictOutput"
}🟡hydracept_verify_lockfile(body)
POST /v1/provenance/lockfile/verify.
입력 스키마
{
"type": "object",
"properties": {
"body": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Body"
}
},
"title": "hydracept_verify_lockfileArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_verify_lockfileDictOutput"
}🟢hydracept_jobs_find(intent, capability_key, limit, project_id)
Find a prior job in the workspace-bound project when you do not have its id. intent is recent, failed, or reusable. This list never includes prompt text. To read the prompt that was executed, call hydracept_job_inspect and read executedPrompt (requestSnapshot.input.prompt). Bind the project that owns the job before searching.
입력 스키마
{
"type": "object",
"properties": {
"intent": {
"default": "recent",
"title": "Intent",
"type": "string"
},
"capability_key": {
"default": "",
"title": "Capability Key",
"type": "string"
},
"limit": {
"default": 10,
"title": "Limit",
"type": "integer"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"title": "hydracept_jobs_findArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_jobs_findDictOutput"
}🟢hydracept_job_inspect(job_id)
Read one prior job, including the prompt that was executed. executedPrompt is that prompt, also stored at requestSnapshot.input.prompt. Text jobs return it when a prompt record was kept and no input payload was stored. Also returns error, diagnostics, receipt summary, and a reuse candidate. Pass job_id from hydracept_jobs_find or an earlier run.
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "hydracept_job_inspectArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_job_inspectDictOutput"
}🟡hydracept_project_request_operation(command, action_key, project_id, input, context)
POST a project operation. Hosted MCP does not run the customer repo; a local watcher must execute it.
입력 스키마
{
"type": "object",
"properties": {
"command": {
"title": "Command",
"type": "string"
},
"action_key": {
"default": "",
"title": "Action Key",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"input": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Input"
},
"context": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Context"
}
},
"required": [
"command"
],
"title": "hydracept_project_request_operationArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_project_request_operationDictOutput"
}🟢hydracept_project_get_operation(operation_id, project_id)
Poll a project operation. Execution happens in the game checkout, not on this host.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"title": "Operation Id",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
}
},
"required": [
"operation_id"
],
"title": "hydracept_project_get_operationArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_project_get_operationDictOutput"
}🟢hydracept_model_adapters(project_id, environment)
List the bound project's registered model adapters, semantic aliases, image-generation default, and static routing readiness. To use one LoRA, call hydracept_use_lora with its alias or name. To suggest a new public LoRA, call hydracept_suggest_lora with a Hugging Face link. Do not assemble adapter ids, weight filenames, or base-model families. Omitted project/environment arguments inherit the authenticated workspace binding. A registered adapter is not necessarily executable; require routingReadiness.routeCompatible before selecting it for generation. credentialAvailability=not_checked means credentials/capacity are still quote-time concerns. The project default is not applied unless the caller sends input.adapters. Trigger words are stored and are not added to the prompt.
입력 스키마
{
"type": "object",
"properties": {
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"title": "hydracept_model_adaptersArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_model_adaptersDictOutput"
}🟡hydracept_prepare_adapter_selection(adapters)
Normalize several LoRA selections into the exact image.generate.v1 input.adapters contract. For one named LoRA, call hydracept_use_lora instead. This does not submit or spend money. Select only route-compatible entries.
입력 스키마
{
"type": "object",
"properties": {
"adapters": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Adapters"
}
},
"title": "hydracept_prepare_adapter_selectionArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_prepare_adapter_selectionDictOutput"
}🟡hydracept_create_adapter_alias(alias, adapter_id, weight, project_id, environment)
Create a stable semantic project alias for a registered adapter. Omitted project/environment arguments inherit the authenticated workspace binding. Catalog aliases may reference registrations that are not yet executable. Does not generate or spend money.
입력 스키마
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"adapter_id": {
"title": "Adapter Id",
"type": "string"
},
"weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Weight"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias",
"adapter_id"
],
"title": "hydracept_create_adapter_aliasArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_create_adapter_aliasDictOutput"
}⚪hydracept_promote_adapter_alias(alias, adapter_id, weight, project_id, environment)
Explicitly move a semantic alias to a new registered adapter/weight by creating a new immutable alias version. Omitted project/environment arguments inherit the authenticated workspace binding. Existing recipe bindings do not move. An alias serving as an active generation default must remain route-compatible unless the default is cleared first.
입력 스키마
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"adapter_id": {
"title": "Adapter Id",
"type": "string"
},
"weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Weight"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias",
"adapter_id"
],
"title": "hydracept_promote_adapter_aliasArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_promote_adapter_aliasDictOutput"
}⚪hydracept_bind_adapter_alias(alias, version_id, project_id, environment)
Resolve a project alias to an immutable alias-version binding for persistence in a project recipe. Omitted project/environment arguments inherit the authenticated workspace binding. Omit version_id to pin the current version. Recipe pinning is allowed for catalog-only adapters; generation still requires a compatible route.
입력 스키마
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"version_id": {
"default": "",
"title": "Version Id",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias"
],
"title": "hydracept_bind_adapter_aliasArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_bind_adapter_aliasDictOutput"
}🟡hydracept_set_adapter_default(alias, capability_key, project_id, environment)
Set a route-compatible semantic alias preselected for future image.generate.v1 work. Omitted project/environment arguments inherit the authenticated workspace binding. The default is not silently injected by the API; agents still send the resolved adapters[] selection.
입력 스키마
{
"type": "object",
"properties": {
"alias": {
"title": "Alias",
"type": "string"
},
"capability_key": {
"default": "image.generate.v1",
"title": "Capability Key",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"alias"
],
"title": "hydracept_set_adapter_defaultArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_set_adapter_defaultDictOutput"
}🔴hydracept_clear_adapter_default(capability_key, project_id, environment)
Clear the project/environment image adapter default. Omitted project/environment arguments inherit the authenticated workspace binding. This does not alter the alias or its immutable history; clearing an environment override may reveal an inherited project-wide default.
입력 스키마
{
"type": "object",
"properties": {
"capability_key": {
"default": "image.generate.v1",
"title": "Capability Key",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"title": "hydracept_clear_adapter_defaultArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_clear_adapter_defaultDictOutput"
}🟢hydracept_suggest_lora(query, project_id, environment)
Suggest a LoRA without registering it or spending money. query can be a project alias, a registered LoRA name, an adapter id, or a public Hugging Face link. Show the user the say field. If intent is use, pass inputPatch.adapters on image.generate.v1. If intent is suggest, wait for the user to agree, then call hydracept_use_lora with accept.arguments. If intent is choose, ask the question in say, then call hydracept_use_lora with file_path or base_model_family. Do not invent repository paths, commits, weight filenames, or base-model families.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_suggest_loraArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_suggest_loraDictOutput"
}🟡hydracept_use_lora(query, file_path, base_model_family, refresh, project_id, ...)
Use one LoRA on image generation, or add an unambiguous public Hugging Face LoRA and then use it. Does not generate an image or spend money. Pass a project alias, registered name, adapter id, or the same query hydracept_suggest_lora returned. Pass file_path only after a suggestion says to choose a weights file. Pass base_model_family only after a suggestion says the base model is missing. Pass refresh=true only when the suggestion says a newer commit is available. When inputPatch is present, pass inputPatch.adapters on image.generate.v1. Do not fill adapter ids, file paths, or base-model families yourself.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"file_path": {
"default": "",
"title": "File Path",
"type": "string"
},
"base_model_family": {
"default": "",
"title": "Base Model Family",
"type": "string"
},
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_use_loraArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_use_loraDictOutput"
}🟢hydracept_register_model_adapter(display_name, source_kind, source_ref, base_model_family, source_revision, ...)
Register a reusable project LoRA without generating or spending money. Prefer hydracept_suggest_lora and hydracept_use_lora for a project name or a public Hugging Face link. Use this tool for provider_ref or hydracept_artifact sources, or when the caller already has every source field. source_kind must be provider_ref, huggingface, or hydracept_artifact. source_ref is namespace/repository; source_file_path may identify an explicit public .safetensors file. If file path is omitted the repository is cataloged but remains non-executable. When a file path is supplied, Hydracept validates it and freezes the Hub commit. For hydracept_artifact, source_ref is a project artifactId and Hydracept binds its immutable content hash. For provider_ref, source_provider is required. Omitted project/environment arguments inherit the authenticated workspace binding. Inspect sourceHealth and routingReadiness.routeCompatible in the result before quoting generation.
입력 스키마
{
"type": "object",
"properties": {
"display_name": {
"title": "Display Name",
"type": "string"
},
"source_kind": {
"title": "Source Kind",
"type": "string"
},
"source_ref": {
"title": "Source Ref",
"type": "string"
},
"base_model_family": {
"default": "flux",
"title": "Base Model Family",
"type": "string"
},
"source_revision": {
"default": "",
"title": "Source Revision",
"type": "string"
},
"source_file_path": {
"default": "",
"title": "Source File Path",
"type": "string"
},
"source_provider": {
"default": "",
"title": "Source Provider",
"type": "string"
},
"recommended_weight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Recommended Weight"
},
"trigger_words": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Trigger Words"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"display_name",
"source_kind",
"source_ref"
],
"title": "hydracept_register_model_adapterArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_register_model_adapterDictOutput"
}🟡hydracept_preview_lora_source(query, project_id, environment)
Low-level lookup for a public Hugging Face LoRA link. Prefer hydracept_suggest_lora, which also matches project aliases and returns a generation patch or a confirmation. Returns the pinned commit, weight files, detected base-model family, suggested name, strength, and trigger words. Does not register an adapter, download weight tensors, or spend money. A detected family with executable=false can be saved but current image routes cannot run it.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"title": "Query",
"type": "string"
},
"project_id": {
"default": "",
"title": "Project Id",
"type": "string"
},
"environment": {
"default": "",
"title": "Environment",
"type": "string"
}
},
"required": [
"query"
],
"title": "hydracept_preview_lora_sourceArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_preview_lora_sourceDictOutput"
}🟢hydracept_revalidate_model_adapter(adapter_id)
Re-check the frozen source identity for a registered adapter without generating or spending money. For Hugging Face this checks the already-pinned commit and file; it never advances a branch or tag. For Hydracept artifacts it rechecks immutable content and safetensors structure. Provider-native refs are opaque and remain declared. Use this when sourceHealth is stale, unavailable, or invalid.
입력 스키마
{
"type": "object",
"properties": {
"adapter_id": {
"title": "Adapter Id",
"type": "string"
}
},
"required": [
"adapter_id"
],
"title": "hydracept_revalidate_model_adapterArguments"
}출력 스키마
{
"type": "object",
"additionalProperties": true,
"title": "hydracept_revalidate_model_adapterDictOutput"
}커뮤니티
증거