指南

快速開始

用 curl 完成一輪對話。

先把 API 地址和 API Key 設為環境變數，後面的命令都引用它們：

export AXON_API="https://agent.hkgai.net/open/api/v1"
export AXON_KEY="sk-axon-..."                    # 你的 API Key

1. 查看可用模型

curl -s "$AXON_API/models" -H "Authorization: Bearer $AXON_KEY"

{"items": [{"id": "deepseek-v4-flash"}], "meta": {"next_cursor": null}}

2. 建立會話

curl -s "$AXON_API/sessions" \
  -H "Authorization: Bearer $AXON_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "model_id": "deepseek-v4-flash",
        "instruction": "你是一名數據分析助手，回答簡潔，結論先行。",
        "metadata": {"user": "u_42"}
      }'

{
  "id": "ses_8d0f3b6a2c4e4f1a9b7c5d3e1f2a4b6c",
  "status": "IDLE",
  "model_id": "deepseek-v4-flash",
  "thinking_enabled": true,
  "instruction": "你是一名數據分析助手，回答簡潔，結論先行。",
  "mcp_servers": [],
  "metadata": {"user": "u_42"},
  "created_at": "2026-10-08T02:15:04.118240Z",
  "updated_at": "2026-10-08T02:15:04.118240Z"
}

3. 發送訊息

SESSION=ses_8d0f3b6a2c4e4f1a9b7c5d3e1f2a4b6c
curl -s "$AXON_API/sessions/$SESSION/messages" \
  -H "Authorization: Bearer $AXON_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "搜尋一下 Python 當前的穩定版本是多少"}'

{
  "id": "evt_5b16960a81ea48d3b1142e542dd512b5",
  "type": "user.message",
  "turn_id": "turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b",
  "created_at": "2026-10-08T02:15:09.553120Z",
  "content": "搜尋一下 Python 當前的穩定版本是多少",
  "files": [],
  "skills": []
}

4. 訂閱事件串流

curl -sN "$AXON_API/sessions/$SESSION/events/stream" -H "Authorization: Bearer $AXON_KEY"

輸出（節選）：

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190158370-0
event: user.message
data: {"id":"evt_5b16…","type":"user.message","turn_id":"turn_3f2a…","created_at":"…","content":"搜尋一下 Python 當前的穩定版本是多少"}

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190158402-0
event: agent.tool_use
data: {"id":"evt_…","type":"agent.tool_use",…,"tool_use_id":"toolu_01JB…","name":"web_search","input":{"query":"current stable version of Python"}}

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190160110-0
event: agent.message.delta
data: {"type":"agent.message.delta","turn_id":"turn_3f2a…","content":"Python 當前的穩定版本是 "}

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190160355-0
event: agent.message
data: {"id":"evt_…","type":"agent.message",…,"content":"Python 當前的穩定版本是 3.14.8。"}

id: turn_3f2a9c1e5b7d4e6f8a0b2c4d6e8f0a1b:1791190160361-0
event: turn.completed
data: {"id":"evt_…","type":"turn.completed",…,"usage":{"input_tokens":2026,"output_tokens":120}}

收到 turn.completed 後連接自動關閉。要繼續對話，再發送一條訊息並重新訂閱即可。完整的 Python 和 Node.js 範例見客戶端範例。