OpenRouter 平台功能

OpenRouter 平台功能

Datetime

2 分钟阅读

Datetime

让任意模型都能获取当前日期和时间

Beta

测试版（Beta）

服务端工具目前处于测试阶段。API 与行为可能会变更。

openrouter:datetime 服务端工具让任意模型都能获取当前日期和时间。适用于需要时间感知的提示词——日程安排、时效性问题，或任何模型需要知道「现在」的任务。

快速开始

const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <OPENROUTER_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-5.2',
    messages: [
      {
        role: 'user',
        content: '今天是星期几？'
      }
    ],
    tools: [
      { type: 'openrouter:datetime' }
    ]
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);

配置

Datetime 工具接受可选的 timezone 参数：

{
  "type": "openrouter:datetime",
  "parameters": {
    "timezone": "America/New_York"
  }
}
参数类型默认值说明
timezonestringUTCIANA 时区名称（例如 "America/New_York"、"Europe/London"、"Asia/Tokyo"）

响应

模型调用 Datetime 工具时，会收到类似如下的响应：

{
  "datetime": "2025-07-15T14:30:00.000-04:00",
  "timezone": "America/New_York"
}

定价

Datetime 工具除标准 Token 用量外不产生额外费用。

后续步骤

上一页Web Fetch下一页 图像生成（服务端）