API 文档

使用你的应用已经期待的协议。

将 RouteMesh API Key 作为 Bearer Token，并传入明确的模型 ID。每次响应都会返回 Generation ID。

Chat Completions 快速开始

将 RouteMesh API Key 作为 Bearer Token，并传入明确的模型 ID。每次响应都会返回 Generation ID。

curl

curl https://api.routemesh.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEMESH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "stream": true,
    "messages": [{"role": "user", "content": "Hello RouteMesh"}],
    "provider": {"zdr": true, "allow_fallbacks": true}
  }'

网关端点

方法	路径	用途
POST	/v1/chat/completions	兼容 OpenAI 的 Completions 与 SSE。
POST	/v1/responses	兼容 OpenAI Responses 的输入项和事件流；暂不支持内置 image_generation 工具。
POST	/v1/images/generations	兼容 OpenAI 的图片生成与增量图片事件。
POST	/v1/images/edits	使用 OpenAI 兼容模型通过 JSON 图片引用或 multipart 进行编辑。
POST	/v1/images/variations	为支持的模型创建 multipart 图片变体。
POST	/v1/messages	兼容 Anthropic 的 Messages API。
POST	/v1/embeddings	兼容 OpenAI 的向量 Embeddings。
GET	/v1/models	公开模型目录。
GET	/v1/generations/{id}	追踪供应商、用量、延迟和成本。

POST/v1/chat/completions

兼容 OpenAI 的 Completions 与 SSE。

POST/v1/responses

兼容 OpenAI Responses 的输入项和事件流；暂不支持内置 image_generation 工具。

POST/v1/images/generations

兼容 OpenAI 的图片生成与增量图片事件。

POST/v1/images/edits

使用 OpenAI 兼容模型通过 JSON 图片引用或 multipart 进行编辑。

POST/v1/images/variations

为支持的模型创建 multipart 图片变体。

POST/v1/messages

兼容 Anthropic 的 Messages API。

POST/v1/embeddings

兼容 OpenAI 的向量 Embeddings。

GET/v1/models

公开模型目录。

GET/v1/generations/{id}

追踪供应商、用量、延迟和成本。

供应商策略

使用 provider.order、only、ignore、allow_fallbacks、max_price、data_collection 和 zdr 限制候选端点。回退不会更改选定的模型。

错误契约

错误响应包含 code、message、type 和 request_id 字段。无效密钥返回 401，余额不足返回 402，限流返回 429，端点不可用返回 503。