开发者文档 Docs

01快速开始

三步跑通第一个任务

1. 注册开通：邮箱注册公测账户；KYC 后解锁完整功能与公测激励资格。无需预付费，按量结算。
2. 选择接入方式：控制台选卡 / API 自动路由 / CLI 批量提交，三种方式任选其一。
3. 部署并监控：实时查看算力层级、费用明细与验收报告；训练任务支持 checkpoint 容错。

# 提交一个 LoRA 微调任务（接口形态示意，以正式文档为准）
curl https://api.a12.network/v1/jobs -H "Authorization: Bearer $A12_API_KEY" -d '{
  "type": "lora-finetune",
  "base_model": "llama-3.1-8b",
  "dataset": "s3://my-bucket/finetune.jsonl",
  "auto_tier": true          # 调度引擎自动选择成本最优层级
}'

02实例类型

A12 提供三种实例类型，价差幅度参照主流 GPU 云市场的通行标准：

03计费细则

全部规则前置公开，无隐藏成本：

• 按秒计费：任务从开始到结束按实际秒数结算，用多少算多少。
• GPU 计算：按卡·时计价，价格随层级（Tier-S/A/B）与实例类型浮动；闲时折扣更深。
• 存储：$0.10/GB/月，实例删除即停止计费。停机不删除实例则继续计费存储。
• 带宽：按节点费率公示、双向计费，选卡前可见；数据密集负载请先估算带宽总成本。
• 余额规则：余额归零时实例先停机，数据保留 72 小时，期间补足余额即可恢复；超时后才进入删除流程。
• CPU-only 负载：$0.005/vCPU·时 + $0.001/GB，适合转码、批处理、爬虫等无 GPU 负载。
• 结算币种：法币 / USDT（稳定币）计价结算，租户不被迫持有平台 Token。

04存储与带宽

最佳实践：把数据集与模型放在对象存储，多任务共享读取，避免每个实例重复存储付费。

05API 入门

API 与 OpenAI SDK 形态完全兼容，三个入口：

# 1) 查询可用算力与实时价
curl https://api.a12.network/v1/offers -H "Authorization: Bearer $A12_API_KEY"

# 2) 提交任务（自动路由最优层级）
curl https://api.a12.network/v1/jobs -H "Authorization: Bearer $A12_API_KEY" -d '{...}'

# 3) OpenAI 兼容推理端点
client = OpenAI(base_url="https://api.a12.network/v1", api_key=os.environ["A12_API_KEY"])

任务状态机

QUEUED → SCHEDULED → RUNNING → [CHECKPOINT…] → DONE / FAILED / INTERRUPTED
                ↑__________________ 自动重试（可抢占任务） ______________|

想直接动手试？打开 API 交互中心 →——在浏览器里构造请求、查看模拟响应、复制 curl / Python / Node 示例。

06故障排查

未解决？提交工单，公测期核心工程师驻 Discord 答疑。

07Worker 硬件清单

接入 A12 网络的硬件按能力分四级。以下为各 Tier 的准入门槛与收益特征：

所有层级共同要求

• 在线时长与任务占用率影响调度优先级（L5 历史声誉）
• 通过五层核验（声明核验 → 能力实测 → 运行时遥测 → 任务验证 → 历史声誉）后才接单
• 支持 Windows / Linux；容器化执行，宿主文件系统不可见

08Worker 长期收益保障

供给侧经济学全公开——你赚多少、平台分多少、规则怎么变，全部写明：

分成结构

• 公测期：Worker 分成 80%——全网主要平台中最慷慨档（对比：主流消费级平台隐含抽成约 50%）。
• 阶梯化路线（提前 30 天公告）：网络稳定供给后调整为 75%，规模化成熟期 70%——同时上线存储 / 带宽收益分成与 CPU-only 负载补位，Worker 总收益不因阶梯调整而下降是设计目标。

收益透明承诺（参照行业透明度最高标准）

• 公测后 30 天起发布「Worker 实收周报」：按 GPU 型号公示实收均值、多数机器区间、Top 分位与任务占用率，附统计口径说明。
• 结算走 Earned → Pending（1–72h 观察）→ Released 三态托管，违约方罚没并赔付受损租户。
• 系数调整受三重约束：±20% 上限 / 90 天间隔 / 提前 30 天公告。
• CPU-only 与带宽负载在 GPU 任务低谷期补位，提高节点利用率。