一套接口，接进任何吃算力的流程

第一步：拿密钥

登录控制台，在「用户信息 → API 密钥」创建。密钥只在创建时完整显示一次，请立即保存。

在线推理（OpenAI 兼容）

把 base_url 指向本平台即可，SDK 不用改。支持对话、图像生成、向量化、语音转写。

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kogun.site/v1",
    api_key="sk-kogun-你的密钥",
)

resp = client.chat.completions.create(
    model="kogun-qwen-72b",
    messages=[{"role": "user", "content": "把这段话翻成英文"}],
)
print(resp.choices[0].message.content)

// npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.kogun.site/v1",
  apiKey: "sk-kogun-你的密钥",
});

const r = await client.chat.completions.create({
  model: "kogun-qwen-72b",
  messages: [{ role: "user", content: "hello" }],
});
console.log(r.choices[0].message.content);

curl https://api.kogun.site/v1/chat/completions \
  -H "Authorization: Bearer sk-kogun-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kogun-qwen-72b",
    "messages": [{"role":"user","content":"hello"}]
  }'

批处理与自定义作业

渲染、训练、仿真、数据处理这类长任务走异步接口：先提交，拿 task_id，再轮询或等回调。

# 提交（自动按 gpu_model 与 estimated_hours 预扣费）
curl -X POST https://api.kogun.site/v1/compute/submit \
  -H "Authorization: Bearer sk-kogun-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "task_name": "blender-第3集-4K",
    "task_type": "render",
    "gpu_model": "RTX 4090",
    "estimated_hours": 6,
    "params": {"frames": "1201-1440", "engine": "cycles", "samples": 256}
  }'

# 查询进度
curl https://api.kogun.site/v1/compute/status/<task_id> \
  -H "Authorization: Bearer sk-kogun-你的密钥"

# 取结果（完成后返回产物地址）
curl https://api.kogun.site/v1/compute/result/<task_id> \
  -H "Authorization: Bearer sk-kogun-你的密钥"

接口清单

以下是面向调用方的稳定接口，完整参数见 API 参考。

错误处理

供给方：把你的设备接进来

如果你有闲置 GPU，安装 Worker 后自动注册、测速评级、进入调度池，按单结算，收益七成归你。

wget https://www.kogun.site/static/kogun-worker.py
python3 kogun-worker.py --login 你的用户名 你的密码 --server www.kogun.site:443