Ontoway 文档

外观

OpenAI 兼容接口 ​

以下 cURL 示例适用于 Bash 类终端。先将密钥放入环境变量，将 JSON 中的模型占位符替换为实际可用模型。

bash
export ONTOWAY_API_KEY="替换为你的 Ontoway API Key"

查询模型 ​

bash
curl --fail-with-body https://api.ontoway.ai/v1/models \
  -H "Authorization: Bearer $ONTOWAY_API_KEY"

Chat Completions ​

bash
curl --fail-with-body https://api.ontoway.ai/v1/chat/completions \
  -H "Authorization: Bearer $ONTOWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为可用的模型 ID",
    "messages": [{"role": "user", "content": "用一句话介绍你自己。"}]
  }'

流式输出 ​

在请求 JSON 中增加 "stream": true，并为 cURL 添加 -N 以关闭输出缓冲。应用端按 SSE 事件读取，不能把整个流当作单个 JSON 解析。

Responses ​

bash
curl --fail-with-body https://api.ontoway.ai/v1/responses \
  -H "Authorization: Bearer $ONTOWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为支持 Responses 的模型 ID",
    "input": "用一句话介绍你自己。"
  }'

工具调用、图像输入、会话状态等能力需单独核对渠道支持情况。接口兼容不等于完整实现官方平台所有产品功能。

Python 示例 ​

安装官方 openai Python 包后，设置 ONTOWAY_API_KEY 与 ONTOWAY_MODEL 环境变量：

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONTOWAY_API_KEY"],
    base_url="https://api.ontoway.ai/v1",
)
response = client.chat.completions.create(
    model=os.environ["ONTOWAY_MODEL"],
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

核对消耗请打开使用日志。参数结构参考 OpenAI API 文档，在 Ontoway 上的实际能力以当前渠道为准。