接入文件

接入文件

快速開始

Base URL: https://api.aciemind.com/v1
API Key:  sk-cafe-...（帳號中心建立，或 Agent 用 POST /api/agent/register 自助取得）

Python

from openai import OpenAI
client = OpenAI(base_url="https://api.aciemind.com/v1", api_key="sk-cafe-...")
r = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)

curl

curl https://api.aciemind.com/v1/chat/completions \
  -H "Authorization: Bearer sk-cafe-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M3","messages":[{"role":"user","content":"ping"}]}'

不用改程式碼的其他部分，只需要換 base_url 和 api_key。Model ID 用短名稱（見模型目錄），不用 provider 前綴。

如果你要接 Cursor、Claude Code、Codex、Cline、Continue、Cherry Studio 等編程工具，請看 編程工具接入文件。

身份驗證

Authorization: Bearer sk-cafe-...。金鑰只在建立/註冊當下顯示一次，請立即保存；遺失只能重新建立。

回應標頭

速率限制

錯誤碼

API 參考

POST /v1/chat/completions

{
  "model": "claude-sonnet-5",
  "messages": [{"role": "user", "content": "..."}],
  "stream": false,
  "tools": [ /* OpenAI function-calling 格式，選填 */ ]
}

回傳 usage.total_tokens 用來換算成本；stream:true 時走 SSE，串流結束後才在背景結算扣款。

POST /v1/messages（Anthropic 相容）

金鑰放 x-api-key（Anthropic 慣例），也接受 Authorization: Bearer。完整支援 tool_use 雙向轉換，串流回合規 Anthropic SSE。詳見下方「SDK 參考」的 Claude Code 設定。

圖像生成

圖像模型請以 公開目錄 為準（按張計費，需已啟用路由）：

curl https://api.aciemind.com/v1/images/generations \
  -H "Authorization: Bearer sk-cafe-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"z-image-turbo","prompt":"一隻在咖啡廳寫程式的貓","n":1,"size":"1024x1024"}'

計費以生成張數為準；回應 header x-cafe-channel 顯示實際上游。

影片生成

影片統一使用非同步介面：先建立工作，再依回傳的 id 輪詢。HappyHorse、Veo、Sora、Grok、Seedance、CogVideoX 的官方 API 差異已由平台路由層處理；MiniMax 既有 Token Plan 官方路徑保留不變。

curl https://api.aciemind.com/v1/videos/generations \
  -H "Authorization: Bearer sk-cafe-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"happyhorse-1.1-t2v","prompt":"一匹快樂的馬在海邊奔跑","duration":5,"resolution":"720P"}'

curl https://api.aciemind.com/v1/videos/generations/{id} \
  -H "Authorization: Bearer sk-cafe-..."

狀態會是 queued、in_progress、completed 或 failed；完成後從 data[0].url 取得影片。影片 URL 可能受上游有效期限制，建議完成後立即轉存到自己的物件儲存。

目前已整理的生圖／生影片模型

目錄中的價格是平台對外計價，不等同上游帳單；美元／人民幣模型依官方公開價換算後加上平台服務係數，Ark 等依帳戶、地區、解析度或套餐扣點的項目會在模型備註中標示。

Embeddings

Embeddings 模型請以公開目錄為準；若 text-embedding-3-small 有啟用路由可直接呼叫：

curl https://api.aciemind.com/v1/embeddings \
  -H "Authorization: Bearer sk-cafe-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"text-embedding-3-small","input":"Token Cafe embedding test"}'

回應 header x-cafe-channel 顯示實際上游；計費以 prompt token 為主。

POST /api/agent/register

curl -X POST https://api.aciemind.com/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'   # body 選填

{
  "ok": true,
  "api_key": "sk-cafe-...",
  "endpoint": "https://api.aciemind.com/v1/chat/completions",
  "trial_ntd": null,
  "trial_entitlement": { "kind": "promotional_usage", "cash_value_twd": 0, "expires_in_days": 7 },
  "limits": { "rpm": 30, "rpd": 1000, "max_concurrency": 2 }
}

api_key 只回傳這一次，收到後立即保存。防刷限制：同 IP 24 小時內限 2 次、全站每日 50 次。未完成正式綁定且 14 天未使用的 agent 帳號會由每日排程自動 closed。若站點設定了 AGENT_REGISTER_CODE，需在 body 帶 invite_code 或 header X-Agent-Register-Code。

SDK 參考

完全相容 OpenAI SDK 生態——只需更改 base_url 與 api_key，其餘程式碼不變。

OpenAI SDK（Python / TypeScript）

from openai import OpenAI
client = OpenAI(base_url="https://api.aciemind.com/v1", api_key="sk-cafe-...")
resp = client.chat.completions.create(model="gpt-4o-mini", messages=[...])

import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aciemind.com/v1", apiKey: "sk-cafe-..." });
const resp = await client.chat.completions.create({ model: "gpt-4o-mini", messages: [...] });

Anthropic SDK / Claude Code CLI

# Anthropic Python/TS SDK
base_url="https://api.aciemind.com", api_key="sk-cafe-..."

# Claude Code CLI
export ANTHROPIC_BASE_URL=https://api.aciemind.com
export ANTHROPIC_API_KEY=sk-cafe-...

Cursor / Cline / aider

LangChain / LlamaIndex

from langchain_openai import ChatOpenAI
llm = ChatOpenAI(base_url="https://api.aciemind.com/v1", api_key="sk-cafe-...", model="gpt-4o-mini")

Agent 應用

Token Cafe 對 agent 沒有登入介面、沒有人工審批——自助註冊、標準 Bearer 金鑰，任何支援 OpenAI API 的框架都能直接接。

完整自助註冊流程

# Step 1：申請 Key（一次性，全程無人工介入）
curl -X POST https://api.aciemind.com/api/agent/register -d '{}'
# → { "api_key": "sk-cafe-...", "trial_ntd": null, "trial_entitlement": { ... }, ... }

# Step 2：用試用金呼叫公開模型（依用量扣款）
curl https://api.aciemind.com/v1/chat/completions \
  -H "Authorization: Bearer sk-cafe-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M3","messages":[{"role":"user","content":"hello"}]}'

# Step 3：需要 Claude / GPT 等更強模型時，依正式付款方案使用
curl https://api.aciemind.com/v1/chat/completions \
  -H "Authorization: Bearer sk-cafe-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"hello"}]}'

模型選擇

請使用 公開模型目錄 中的短 ID（例如 MiniMax-M3、gpt-4o-mini）。Agent 先取得限時體驗額度；正式方案會依公開價格與實際用量結算，新的預付額度目前暫停。

skill.md — 讓你的 AI 助理自己讀文件

把 skill.md 餵給 Claude / Cursor / Copilot 等助理，它就能自己理解 Token Cafe 的接入方式，不需要你手動貼程式碼片段。

curl -s https://token.aciemind.com/skill.md

CrewAI / AutoGen

# CrewAI（透過 langchain_openai）
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(base_url="https://api.aciemind.com/v1", api_key="sk-cafe-...", model="claude-haiku-4-5")

# AutoGen
config_list = [{
    "model": "claude-haiku-4-5",
    "base_url": "https://api.aciemind.com/v1",
    "api_key": "sk-cafe-...",
}]

任何支援 base_url + api_key 自訂端點的 agent 框架都適用同一模式。

Agent 發現

• llms.txt
• skill.md
• skill.md（鏡像）

計費驗證（Probe）

帳號中心 Dashboard「計費驗證 Probe」提供兩種模式：

• 歷史比對（零成本）：比對該模型最近一次成功用量紀錄的 token 數、上游通道與 NT$ 花費。
• 即時探測：以固定 prompt 實際呼叫 API（會扣少量 credits），驗證計費與通道。