开放 API（OpenAI 兼容）

每个 Space——无论数据模式还是通用模式——都可以通过 OpenAI 兼容 API 编程调用。 在 Space 内生成 API key，把任意 OpenAI SDK 指向 Datyo，你的脚本、后端或 智能体就能与该 Space 的助手对话（数据模式还会基于挂载的数据集执行 SQL 分析）。

生成 API key

1. 打开 Space → 点击右上角 ⋮ 菜单 → API 调用。
2. 填写名称，点击 生成 Key。
3. 立即复制——完整 Key 仅显示一次，之后只保留前缀用于展示。

Key 可随时在同一弹框中吊销，吊销后立即失效。用量按正常对话计入 Key 所有者账户。

调用方式

Base URL：https://console.datyo.ai/v1 · 端点：POST /chat/completions

curl https://console.datyo.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-df-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "standard",
    "stream": false,
    "messages": [{"role": "user", "content": "上周营收 Top5 的商品？"}]
  }'

from openai import OpenAI

client = OpenAI(base_url="https://console.datyo.ai/v1", api_key="sk-df-...")
stream = client.chat.completions.create(
    model="standard",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

参数

字段	取值	说明
model	flagship / standard / lite	可选；默认用 Space 的模型档位
messages	OpenAI 格式	调用是无状态的——每次请求携带完整历史
stream	true / false	SSE 分块（chat.completion.chunk + data: [DONE]）或单个 JSON
web_search	true / false	Datyo 扩展：让回答基于实时联网检索

响应遵循 OpenAI 格式（choices[0].message.content、usage token 统计）。 数据模式 Space 会先对挂载数据集执行 SQL 再回答；通用模式按其指令与技能回答。

注意

• 妥善保管 Key——持有者可消耗你的额度。轮换方式：吊销旧 Key、生成新 Key。
• API 调用不会出现在 Space 的对话历史中；可在用量/Monitor 统计里看到。