开始使用

迁移现有应用

在兼容客户端中更换接入地址和密钥。

通用客户端配置

在支持自定义 OpenAI Chat Completions 服务的客户端中，填写以下配置。不同客户端可能在接入时额外请求其他接口，应按实际行为验证。

Base URL	`https://YOUR_DOMAIN/v1`
API Key	在NXAG控制台创建的 yq_ 密钥
Model	`demo-chat` 或已接入模型的对外 ID

当前兼容范围

首版支持纯文本 Chat Completions、模型列表、temperature、max_tokens、stream 与 stream_options.include_usage。当前不支持工具调用、图片消息、Embeddings、Responses、文件上传和完整的 Agent 执行链。

可用文本聊天不等于可执行电脑操作。DeepSeek Harness 等工具若依赖 tools 参数，需要完成工具调用适配后再验证。未知字段会返回 400，避免静默忽略。

curl https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer $NXAG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "demo-chat",
    "messages": [{"role": "user", "content": "你好"}]
  }'