akash

Akash — 部署工作负载

本技能涵盖在 Akash Network 上部署和运行工作负载所需的一切：编写 SDL、选择部署方式、进行身份验证、创建部署、接受出价，以及读取运行中部署的日志和事件。

如需运行 Akash provider，请使用 akash-network:akash-provider 技能。如需运行全节点或验证者，请使用 akash-network:akash-node。

关键规则

**绝不要使用 :latest 或省略镜像标签。**始终指定明确的版本标签，以确保部署可复现。

# CORRECT
image: nginx:1.25.3
image: postgres:16

# WRONG
image: nginx:latest
image: nginx          # implies :latest

Akash 有两种代币，切勿混淆。

• AKT（uakt，1 AKT = 1,000,000 uakt）是链上代币。用于支付 Gas 费用（--gas-prices、minimum-gas-prices、SDK WithGasPrices）、质押（自我委托、验证者债券、罚没）以及验证者奖励。自托管钱包持有 AKT。
• ACT（uact，1 ACT = 1,000,000 uact）是部署付款代币。用于 SDL 定价（denom: uact）、部署托管资金、出价价格（provider 提供的费率）以及租约付款。注意：provider 侧的出价保证金（MsgCreateBid 上用于防垃圾信息的抵押金，即 bidMinDeposit 配置）使用的是 uakt，而不是 uact——provider 在链上操作中只使用 AKT，并通过租约赚取 ACT。部署者无需直接处理此项。

**对于自托管部署者：在为部署充值之前，必须先通过销毁 AKT 来铸造 ACT。**先获取 AKT（通过交易所购买／在测试网上使用水龙头获取），然后通过销毁／铸造机制将一部分兑换为 ACT。Console API 用户无需进行此操作——添加 USD 额度后，Console 会自动使用这些额度为每个部署提供资金（由服务端完成 Stripe → USD → ACT 的转换）。

看到 --gas-prices 0.025uakt 时，这是正确的（Gas 使用 AKT 支付）。在 SDL 中看到 denom: uact, amount: 1000 时，这也是正确的（租约定价使用 ACT）。正常命令中这两种面额可以同时存在。

选择部署方式

这是本技能中最重要的决定，也是最容易选错的决定。

默认行为：推荐并继续，不要盘问。 如果用户给出了任何合理线索（见下方的线索表），就直接选择对应路径并开始编写代码，不必特意说明。如果必须询问，只问一个简短的问题，给出推荐方案，并表示可以切换；不要在用户看到任何命令之前就构建多步骤决策树。目标是尽快让他们运行代码，而不是让他们回答测验题。

只有当提示确实没有提供任何线索时（没有语言线索、钱包线索或 CI 线索），才停下来询问。即便如此，也应先给出推荐并表示可以切换，而不是把一组同等选项摆在用户面前。

选定路径后，在对话剩余部分坚持使用该路径。不要悄悄切换。如果用户之后明确要求切换，就妥善切换。

共有五种部署路径（由你托管工作负载），以及一种使用路径（调用托管模型）：

#	方式	钱包模式	身份验证	适用场景
1	Console API	托管（Console 持有密钥所属个人账户或团队的钱包）	x-api-key header	CI/CD、服务器间调用，以及任何需要 HTTP + API 密钥的后端。不必处理私钥。
2	akt CLI	通过 Console API 密钥托管，或通过本地密钥环自行保管	AKT_CONSOLE_API_KEY 或上下文凭据；或本地密钥	终端和 Agent 会话：只需运行一次 akt deploy，即可从 SDL 部署并启动服务；akt console 可读取日志、状态并打开 shell。
3	Akash CLI (provider-services)	自行保管（由你持有密钥）	本地密钥 + 签名	现有的 provider-services 脚本和手动链上工作流。官方文档现在建议 CLI 新用户使用 akt。
4	TypeScript SDK	自行保管（浏览器钱包、硬件钱包或本地密钥）	SDK 在本地签名	dApp、Node.js 服务，以及任何需要通过 JS/TS 代码部署的场景。
5	Go SDK	自行保管	SDK 在本地签名	Go 后端服务、自定义工具。
6	AkashML (使用，不是部署)	托管（AkashML 账户、美元额度）	Authorization: Bearer	你想要调用大模型，而不是托管大模型。兼容 OpenAI/Anthropic 的 REST 接口。不需要 SDL、钱包或 ACT。

第 1–5 行是用于在 Akash 上托管自己的工作负载的路径。用户想要使用推理服务时，应选择第 6 行——这是不同的问题，对应不同的接口。完整区别见 @rules/deploy/akashml/overview.md。

最容易让人踩坑的概念

Console 持有钱包，密钥仅在一个范围内生效。 每位 Console 用户都有个人账户，也可以加入团队；个人账户和团队各自拥有托管钱包和额度。API 密钥是在其中一个账户或团队中创建的，只在该范围内生效，并使用创建者的角色；密钥还可能受限于某个项目。部署费用从该钱包中扣除。不存在单独的“Console API + 自带钱包”模式。

因此，密钥并不总是拥有账户的全部权限：团队中的 viewer 或 billing 成员所创建的密钥无法部署；项目密钥只能访问所属项目（访问其他项目时会返回 403 project_forbidden）；密钥也绝不会从创建它的个人账户或团队之外的钱包扣款。应通过 GET /v1/organizations 和 GET /v1/projects 确认密钥的权限范围，而不是自行假定；参见 rules/deploy/console-api/teams-and-projects.md。

如果用户使用自行保管的钱包（Keplr 或 Ledger），并且想要从该钱包部署，就需要使用 CLI 或 SDK。Console API 不会使用外部钱包签名。

Console 有两种形式——请加以区分

• 标准版 Console 位于 console.akash.network——使用托管钱包。本技能操作的 Console API 就是它。
• Console Air（github.com/akash-network/console-air）——适用于 Keplr 或硬件钱包的自托管 UI。可自托管——没有官方托管网址 console-air.akash.network；用户需要克隆仓库，并在本地或自己的基础设施上运行。不在本技能的范围内（它是 UI，而不是 API）。如果用户想要使用自托管钱包的 UI，请将他们引导至该仓库，然后停止；需要以编程方式使用自托管钱包的用户应使用 CLI 或 SDK。

识别线索——并积极据此采取行动

只要看到以下任一线索，就静默选择相应路径并开始编写代码。不要请求确认；线索本身就是确认。

如果用户提到……	选择……
"akt"、"akt deploy"、"akt redeploy"、"akt console"、"akt context"、AKT_CONSOLE_API_KEY、"akash-network/tap/akt"，或者用户希望通过当前终端完成操作，且 command -v akt 能找到它	akt CLI（其 context 决定使用 Console 还是自托管方式）
"I have an API key"、以 ac.sk. 开头的密钥、"$AKASH_API_KEY"、"x-api-key"、"x-project-id"、"x-organization-id"、Console 团队或项目、"curl"、"CI/CD"、"GitHub Actions"、"backend"、"server-to-server"、"deploy from CI"、"automate"	Console API
"Keplr"、"Ledger"、"hardware wallet"、"my wallet"、"self-custody"、"provider-services keys add"、"my mnemonic"	CLI 或 SDK（只有在用户未同时表明编程语言时才提问）
"React app"、"Next.js"、"akashjs"（旧版）、"@akashnetwork/chain-sdk"、"my dApp"、"in the browser"	TypeScript SDK
"Go service"、"golang"、"cosmos-sdk Go"、"my Go backend"	Go SDK
"AkashML"、"akml-..."、"managed inference"、"call an LLM"、"hosted LLM on Akash"、"OpenAI-compatible"、"Anthropic-compatible"、"playground.akashml.com"、"api.akashml.com"、指向 AkashML 的 ANTHROPIC_BASE_URL	AkashML（调用路径）
"Console Air"、"web UI for my Keplr wallet"、"GUI" + "self-custody"	Console Air（不在范围内；用一句话指向仓库，然后停止）
"easiest"、"simplest"、"first time"、"just want to try" + 没有钱包或密钥线索	Console（UI 或 API——一次性操作推荐使用 UI，脚本则推荐 API）

当线索指向两条路径时，以更具体的线索为准：即使提到 akt，CI 作业或 API 密钥也仍应选择 akt。

关于大模型的歧义——只问一个简短问题。 如果用户说 "run an LLM on Akash"，但没有说明是 "my own" 还是 "call"，那么线索确实有歧义，可能指 AkashML（调用托管模型），也可能指 使用 GPU SDL 自行部署（自己托管模型）。用一句话询问："Do you want to call a hosted LLM, or run your own instance?"——然后据此选择。两种回答对应完全不同的文件（AkashML 或 rules/sdl/examples/gpu-workload.md）。

只有在提示中确实没有任何线索时才提问——没有语言提示、钱包提示或 CI／自动化提示。提问时只用一句话："Do you want this in a script (Console API) or a UI (Console for managed wallet, Console Air for self-custody)?"——然后根据用户的回答继续。

如果用户说要“首次进行小型部署”，且没有其他线索 → 直接推荐 Console UI 并编写 SDL。回答的最后一行必须是一个以问号结尾、列出备选方案的单独问题："Would you rather script it with the akt CLI or the Console API, or deploy from your own wallet?" 在用户看到任何命令之前，不要让他们从方法表中选择。

控制台 API 的语言选择——优先推断，只有没有线索时才询问

一旦进入控制台 API 流程，就根据线索选择集成语言。只有在万不得已时才询问。

线索	使用
"curl"、"bash"、"shell"、"GitHub Actions"、"GitLab CI"、任何 .sh 引用、未提及应用技术栈	curl + Bash
"Node"、"Next.js"、"Express"、package.json、.ts/.js 文件、"my Node app"	TypeScript / Node fetch
"Python"、requirements.txt、.py、"FastAPI"、"Django"、"Flask"	Python requests 或 httpx
"Go"、go.mod、.go、"my Go service"	Go net/http
"Rust"、Cargo.toml	Rust reqwest

当语言未指定，且上下文涉及自动化/CI 时（这是 API 密钥用户最常见的情况），默认使用 curl + Bash。除非有充分理由相信用户想用其他特定运行时，否则不要询问；即便如此，也先写 curl，并表示可以转换。Curl 是 HTTP 的通用语言，可轻松转换为任何语言。

遇到以下情况时完全跳过提问：

• 存在上述任一线索（直接使用对应语言）。
• 用户已粘贴特定语言的代码（使用同一种语言）。
• 用户说了 "curl"、"shell"、"CI" 或任何暗示脚本的内容——他们想要 Bash。

仅在完全没有线索时才询问——例如 "deploy to Akash via the API"，且没有其他上下文。此时只需问一句："要用 curl/Bash、Node、Python 还是 Go？"——并根据用户的回答生成内容。

这是与部署方式选择分开的步骤。两者都选定后，在后续对话中都保持不变。

API 密钥处理——默认不提及，仅在需要时介入

两条不可妥协的规则，默认静默执行：

1. 代码中始终通过环境变量引用密钥：$AKASH_API_KEY（Bash）、process.env.AKASH_API_KEY（Node）、os.environ["AKASH_API_KEY"]（Python）、os.Getenv("AKASH_API_KEY")（Go）。akt 会自行读取 AKT_CONSOLE_API_KEY，因此在 akt 流程中应导出该变量名，绝不能将密钥作为参数传入。
2. 绝不在代码或对话中回显密钥明文，即使用户粘贴了密钥。如果用户粘贴了密钥明文，应在回复中将其替换为 $AKASH_API_KEY，并在开头添加一句话："下面的代码使用了 $AKASH_API_KEY——运行前请将密钥导出为该环境变量。"

何时添加额外说明（仅限以下情况之一——选择适用的最简说明）：

• 用户粘贴了密钥明文 → 添加一句重定向说明（如上）。不要说教；直接使用环境变量名。
• 用户询问如何将密钥放入其提到的特定运行时（GitHub Actions、GitLab CI、Docker 等）→ 用一句话说明该运行时的做法。不要罗列所有运行时。
• 用户正在编写 Dockerfile → 提醒密钥必须在运行时通过 -e 传入，不能通过 ARG/ENV 烘焙进去。用一句话说明。
• 用户提到了 .env 文件 → 用一句话提醒将其添加到 .gitignore。不要假设用户需要教程。

以下情况不要提及密钥处理：

• 用户已经说明密钥在 $AKASH_API_KEY、${{ secrets.AKASH_API_KEY }} 或类似变量中——他们已经处理好了。不要重复规则。
• 用户询问的是调用之后的内容（状态、日志、出价）——密钥处理已经解决。
• 对话中完全不会生成代码（架构问题、现有部署的故障排查）。

代码回复末尾的陷阱表中可以提及“不要将 Authorization: Bearer 用于 API 密钥”，因为这是一个常见错误——但只占一行，不要展开讨论密钥管理。

提交后，始终遵守

• 使用 Console API 路径时：不要建议使用 provider-services keys add，不要建议使用 mTLS 证书（对于 Console API 已弃用，参见 rules/deploy/cli/mtls-legacy.md），不要建议使用 provider-services query market bid list —— 每次读取都是使用用户所选语言，通过 HTTP 调用并携带 x-api-key。Console 会记录每次部署的 SDL，因此：使用 PATCH /v1/deployments/{dseq} 更改正在运行的部署（绝不要使用已弃用的完整 SDL PUT），向 POST /v1/leases 发送请求时不要包含 manifest，任何地方都不要包含 deposit，并将 CPU、内存、存储、GPU 或副本变更视为新部署。
  • **在团队中：**部署到指定项目（data.projectId；绑定到项目的密钥无需指定），使用 ?projectId= 列出，使用 PATCH /v1/deployments/{dseq}/project 移动，并根据 rules/deploy/console-api/teams-and-projects.md 解释 project_forbidden、project_required、project_budget_exceeded、organization_forbidden、organization_mismatch 和 session_required。团队积分、银行卡和自动充值由所有者或计费成员在团队的 Billing 页面设置，绝不能通过脚本设置。
• 使用 akt 路径时：运行 akt 命令，不要使用 curl，也不要使用 provider-services。先检查 akt version：1.0.1 及更高版本会拒绝对 Console 部署进行任何充值，而 0.1.x 在此处需要 --deposit 0.5（更好的做法是：brew upgrade akash-network/tap/akt）。任何无人值守操作都要传入 --bid-select 和 --yes，并读取 -o json 或 -o jsonl。没有终端时无法使用设置向导，因此请在运行首条命令前创建上下文（akt context create <name> --deploy-via console）。在 1.0.1 中，密钥使用 ac-secret://NAME 引用，值放在 --secrets-file 中（绝不要放在命令行中）；akt update --patch 用于更改单个字段；资源变更则使用 akt redeploy <dseq> --sdl-file <new>，这会让旧部署继续运行。设置说明和操作示例：rules/deploy/akt/。
• 使用 **Akash CLI（provider-services）**路径时：不要建议调用 /v1/deployments HTTP 接口。不要建议使用 API 密钥。仅使用 provider-services tx ... / provider-services query ...。
• 使用 SDK 路径时：不要使用 curl 示例或 CLI 命令；用户需要的是代码。
• 使用 AkashML 路径时：不要编写 SDL，不要讨论 uact/uakt/租约/竞价。用户调用的是托管推理 API，而不是部署服务。仅使用 Authorization: Bearer $AKASHML_API_KEY 和 https://api.akashml.com/{v1,anthropic} 调用。如果用户之后说 “其实我想托管自己的模型”，就切换到五种部署路径之一。
  • **始终查询实时 API 获取模型目录、定价和功能；绝不要相信此技能中固化的模型 ID、价格或功能列表。**在推荐模型、引用价格或声称某项功能（工具调用、推理、流式传输、上下文长度）之前，调用相关端点：
    • GET https://api.akashml.com/v1/models —— 定价（每百万 Token）、context_length、supported_features、supported_sampling_parameters、max_output_length、quantization
    • GET https://api.akashml.com/anthropic/v1/models —— Anthropic 格式的列表（返回以 -- 别名化的 ID）
    • 用户询问文档中信息可能已过时的其他内容时，调用任何其他有文档说明的端点
  • 此技能中列出的模型（DeepSeek、MiniMax、Kimi、Qwen）仅为示例，可能已发生变化；实时列表才是权威信息。如果用户提供自己的 API 密钥，在给出明确指定模型或价格的答复前，使用该密钥调用实时端点。

如果用户要求切换（“我们能改用 API 来做吗？”），请确认切换，并从此刻起遵循新路径的规则。

快速参考

SDL 结构

每个 SDL 都包含四个必需部分（以及 IP 租约和资源回收所需的可选 endpoints 和 reclamation）：

version: "2.0"  # or "2.1" for IP endpoints or the reclamation block

services:       # Container definitions
profiles:       # Compute resources & placement
deployment:     # Service-to-profile mapping

最简 SDL 模板

version: "2.0"

services:
  web:
    image: nginx:1.25.3
    expose:
      - port: 80
        as: 80
        to:
          - global: true

profiles:
  compute:
    web:
      resources:
        cpu:
          units: 0.5
        memory:
          size: 512Mi
        storage:
          size: 1Gi
  placement:
    dcloud:
      pricing:
        web:
          denom: uact
          amount: 1000

deployment:
  web:
    dcloud:
      profile: web
      count: 1

文档结构

核心概念

• @rules/overview.md — Akash Network 介绍和架构
• @rules/terminology.md — 关键术语（租约、出价、dseq、gseq、oseq）
• @rules/pricing.md — 使用 uact 付款（部署付款面额）

SDL 配置

• @rules/sdl/schema-overview.md — 版本要求和 SDL 结构
• @rules/sdl/services.md — 服务配置（image、expose、http_options、env、credentials）
• @rules/sdl/compute-resources.md — CPU（units、arch）、内存、存储和 GPU 规格
• @rules/sdl/placement-pricing.md — Provider 选择和定价（uact）
• @rules/sdl/deployment.md — 服务到配置文件的映射
• @rules/sdl/endpoints.md — IP 端点配置（v2.1）
• @rules/sdl/reclamation.md — 资源回收 reclamation 块（v2.1、AEP-82）
• @rules/sdl/confidential-compute.md — Confidential Compute / TEE（params.tee、AEP-83）
• @rules/sdl/validation-rules.md — 所有约束和验证规则

SDL 示例

• @rules/sdl/examples/web-app.md — 简单的 Web 部署
• @rules/sdl/examples/wordpress-db.md — 带持久化存储的多服务部署
• @rules/sdl/examples/gpu-workload.md — 使用 NVIDIA 的 GPU 部署
• @rules/sdl/examples/ip-lease.md — IP 端点配置
• @rules/sdl/examples/reclamation.md — 资源回收宽限期（v2.1）
• @rules/sdl/examples/confidential-compute.md — Confidential Compute（TEE）：仅 CPU 和 CPU+GPU

部署方式

• @rules/deploy/overview.md — 方式选择（从这里开始）
• @rules/deploy/console-api/ — Console API（API 密钥路径）
  • overview.md — 基础 URL、信封、错误代码、已弃用和 UI 内部端点、端点映射
  • authentication.md — API 密钥（x-api-key、ac.sk.… 格式、CRUD）、公共端点、CI/CD
  • deployment-endpoints.md — 创建、列出、读取、PATCH、关闭；租约、出价、运行时限制、Provider、放置、出价筛选
  • secrets.md — ac-secret:// 引用、sealedSecrets、inheritSecretsFrom
  • api-key-quickstart.md — 从“我有一个 API 密钥”到部署运行的线性操作指南
  • account-and-funding.md — 账户模型、余额、自动充值、402 拒绝（注册和添加额度仅限 UI 操作）
  • teams-and-projects.md：团队和角色、绑定到团队或项目的密钥、x-organization-id 和 x-project-id、部署到项目、按项目列出部署以及在项目间移动部署、项目预算、团队账单、团队错误
  • operations.md — Provider JWT（leases 结构、作用域）、日志/事件/状态/shell、TEE 证明
• @rules/deploy/akt/ — akt CLI（Console API 密钥或本地密钥环；终端和 Agent 会话）
  • overview.md — 安装、0.1.x 与 1.0 的差异（存款）、无需终端即可使用的上下文和凭据、JSON/JSONL 输出、MCP 服务、akt 如何映射到 Console API
  • console-workflows.md — SDL、部署、日志/事件/状态/shell、更新、充值、关闭、容量、恢复、CI
• @rules/deploy/cli/ — Akash CLI（provider-services，自托管路径）
  • mtls-legacy.md — CLI/SDK 直接调用 Provider 时使用的旧版 mTLS 身份验证（对 Console API 已弃用）

托管推理（按用量计费，而非部署）

• @rules/deploy/akashml/ — AkashML：在 Akash 计算资源上调用托管的开源 LLM
  • overview.md — 基础 URL、何时使用 AkashML 与自部署 GPU、计费差异
  • authentication.md — akml-... 密钥、Authorization: Bearer、环境变量规则
  • api-reference.md — OpenAI + Anthropic 接口，附带 curl + SDK 示例
  • quickstart.md — 从注册到首次推理调用的线性操作指南
  • account-and-billing.md — USD 额度（链下计费，与 uact 不同）、每个密钥的 RPM/TPM 限制
  • claude-code-integration.md — 通过 ANTHROPIC_BASE_URL 将 Claude Code 的 Anthropic 客户端指向 AkashML

SDK 文档

• @rules/sdk/overview.md — SDK 对比与选择
• @rules/sdk/typescript/ — 适用于 Web 和 Node.js 的 TypeScript SDK
• @rules/sdk/go/ — 适用于后端服务的 Go SDK

AuthZ（委托权限）

• @rules/authz/ — 费用授权和部署授权

投标匹配（面向部署者）

• @rules/bid-matching/overview.md — 何时使用、如何运行匹配器、如何展示结果
• @rules/bid-matching/adaptation-rules.md — SDL 变更的优先顺序
• @rules/bid-matching/matching-rules.md — SDL ↔ 提供方字段映射

参考

• @rules/reference/storage-classes.md — beta2、beta3、ram 存储
• @rules/reference/gpu-models.md — 支持的 NVIDIA GPU
• @rules/reference/rpc-endpoints.md — 公共 RPC 端点

常见模式

环境变量

services:
  app:
    env:
      - "DATABASE_URL=postgres://..."
      - "NODE_ENV=production"

持久化存储

profiles:
  compute:
    app:
      resources:
        storage:
          - size: 10Gi
            attributes:
              persistent: true
              class: beta2

GPU 工作负载

profiles:
  compute:
    ml:
      resources:
        gpu:
          units: 1
          attributes:
            vendor:
              nvidia:
                - model: a100

CPU 架构（arm64）

profiles:
  compute:
    api:
      resources:
        cpu:
          units: 2
          attributes:
            arch: arm64     # or amd64; omit to write no CPU attribute (there is no default)

流式路由（禁用代理缓冲）

services:
  api:
    expose:
      - port: 8080
        as: 80
        to:
          - global: true
        http_options:
          proxy:
            buffering_disable: true   # chain-sdk >= 1.0.0-alpha.44; not honored by providers yet

机密计算（TEE）

services:
  web:
    params:
      tee: cpu        # or: cpu-gpu (requires GPU resources)

支付选项

• uact — ACT 的微面额（部署支付代币，与 AKT 分开）。用于 SDL 定价（amount: 1000）、部署托管资金和租约付款的 denom。uakt 仅作为少见的销毁-铸造（BME）备用方案接受，并非普通替代选项。
• 注意：Console API 部署完全无需押金。Console 使用密钥的个人账户或团队账户中的 USD 余额为其提供资金。

更多资源

• awesome-akash — 100 多个可用于生产环境的 SDL 模板
• Akash Network Docs — 官方文档
• Console (managed wallet) — Web UI；与此技能的 Console API 路径对应的托管钱包
• Console Air (self-custody, self-hosted) — 适用于 Keplr 或硬件钱包的 Web UI；克隆并在本地运行
• akt CLI docs — 统一的 Akash CLI；其专属 Agent 技能 akt-cli 随每个版本一同提供，文件名为 akt_<version>_skill.zip
• Console API OpenAPI spec — 在线接口契约，并标注了弃用项（此技能整理了部署管理相关的子集；该规范还包含 Console UI 的内部功能，例如 Stripe、警报和用户注册）
• @akashnetwork/chain-sdk — TypeScript SDK（自托管 JWT 签名、链消息）