API 文档接口参考

Grok 4.7 · 对话补全

对话模型（GPT、Claude、Gemini、Grok、DeepSeek 等）使用 OpenAI Chat Completions 格式，官方 OpenAI SDK 将 base URL 设为 https://01router.com/api/v1 即可调用。传 "stream": true 获得 SSE 流式输出。调用前按输入 + max_tokens（未传时为 4096）预扣积分，回复结束后按实际 token 用量结算；请求 ID 会出现在 X-Gateway-Request-Id 响应头和任务日志中。

POST/api/v1/chat/completions需要 Bearer API Key

grok-4.7对话 · xAI模型详情与价格

此模型使用的接口

POST/chat/completions对话补全 GET/models/{slug}查询单个模型

参数范围

选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入，请将示例媒体地址替换为可访问的文件。

请求

cURL

curl 'https://01router.com/api/v1/chat/completions' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-4.7",
  "messages": [
    {
      "role": "user",
      "content": "Hello!"
    }
  ],
  "max_tokens": 512,
  "stream": false
}'

输入参数

JSON 请求体

model string必填: 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。
可选值:"grok-4.7"
messages object[]必填: 非空消息数组，每项包含 role 和 content；content 可包含模型支持的多模态内容。
provider string可选: 可选供应商 slug。不传时自动路由；项目配置可能固定供应商。
project string可选: 可选项目 ID，使用该项目公开的模型目录和路由配置。
stream boolean可选: 默认 false；true 返回 text/event-stream 数据流，以 data: [DONE] 结束。
默认值:false
max_tokens integer可选: 正整数，默认 4096，不可与 max_completion_tokens 同时传入。
默认值:4096
最小值:1
max_completion_tokens integer可选: 正整数，默认 4096，不可与 max_completion_tokens 同时传入。
temperature number可选: OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。
tools object[]可选: OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。
response_format object可选: OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。

响应示例

200 · application/json

{
  "id": "chat_example",
  "object": "chat.completion",
  "model": "grok-4.7",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 2,
    "total_tokens": 10
  }
}

SSE · stream: true

data: {"id":"chat_example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"Hello!"},"finish_reason":null}]}

data: [DONE]

响应仅用于说明结构；ID、用量、价格和结果以实际请求为准。

输出字段

id string: 创建任务返回的生成 ID。
object string: chat.completion / chat.completion.chunk
model string: 模型目录中的 slug；项目密钥也可使用项目自定义的模型 slug。
choices array: 回答列表。非流式使用 choices[].message，流式数据块使用 choices[].delta。
usage object: 包含 prompt_tokens、completion_tokens、total_tokens。流式响应在供应商提供时包含用量。

使用说明

OpenAI 兼容的采样、工具调用与结构化输出能力取决于模型和供应商。仅支持 n = 1。

给 AI 使用

把文档索引或完整接口文档交给 AI 编程助手，包含实时模型参数。

llms.txt llms-full.txt 此页 Markdown