用途:这是 ibl.ai 的 OpenAI 兼容聊天推理接口,与 OpenAI /v1/chat/completions 的请求/响应结构一致,由你的部署提供服务并路由到指定 provider/model。适合直接做原始补全、流式 token 输出或工具调用,无需 MCP 服务器或智能体。
主要能力:读取模型列表 GET …/orgs/{org}/v1/models,每个 id 是可用作 model 的 provider/model;POST …/orgs/{org}/v1/chat/completions 执行补全,采用标准 OpenAI 请求体,支持 messages、stream、tools、stream_options。stream:true 返回 SSE(data: {chunk} … data: [DONE])。支持工具调用(OpenAI tools / tool_calls),流式工具调用增量使用 0 基索引。
使用方式:认证头为 Authorization: Api-Token $IBLAI_API_KEY;路径变量 {org} = $IBLAI_ORG;model 必须为 provider/model 形式,如 openai/gpt-5、anthropic/claude-sonnet-4,裸名称返回 400 invalid_request。hosts 区分:非流式用 https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/v1;流式(stream:true)用 https://asgi.data.iblai.app/api/ai-mentor/orgs/{org}/v1,因为同步 WSGI 网关无法驱动异步 SSE 生成器。未连接时先运行 /iblai-api-login 以写入 IBLAI_ORG 和 IBLAI_API_KEY。可作为 OpenAI SDK 的替代:base_url 指向 …/orgs/{org}/v1,认证是 Api-Token 而非 Bearer,需通过 SDK 默认 headers 传入。
限制:model 必须能解析到部署已配置的 provider,未知或错误 model 会报 400;流式必须使用 ASGI host,WSGI 仅支持非流式。配置智能体所用模型见 /iblai-api-agent-llm,与已部署智能体对话见 /iblai-api-agent-chat。其他细节暂未提供。