JuCode 文档
ApiChat

创建响应(Responses API)

与 OpenAI Responses API 兼容。 > **强制流式。** 无论你传什么 `stream` 值,本端点**总是**返回 > `text/event-stream`。这是网关的契约,不是可配置项。如果你的客户端按 > `stream: false` 去解析 JSON,会失败。 与 `/v1/chat/completions` 不同,本端点**不会**注入 `stream_options.include_usage`。

POST
/v1/responses

与 OpenAI Responses API 兼容。

强制流式。 无论你传什么 stream 值,本端点总是返回 text/event-stream。这是网关的契约,不是可配置项。如果你的客户端按 stream: false 去解析 JSON,会失败。

与 /v1/chat/completions 不同,本端点不会注入 stream_options.include_usage。

Authorization

AuthorizationBearer <token>

Authorization: Bearer sk-juc-...

前缀必须是恰好 Bearer (首字母大写 + 单个空格)。bearer、BEARER 或用制表符分隔都会被判为无效。

除 API Key 外,也接受 OAuth 设备访问令牌(仅限 oauth_access 类型的 JWT; 普通网页会话令牌会被拒绝)。

In: header

Header Parameters

conversation_id?string

会话粘性提示(JuCode 扩展,非 OpenAI 标准)。同一会话的多次请求带上相同值, 网关会尽量把它们路由到同一个上游账号,提升 prompt cache 命中率。

浏览器端不可用:CORS 允许的请求头列表未包含此头。

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

OpenAI Responses API 请求。除 model 外原样透传。

Response Body

text/event-stream

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/responses" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-5.4",    "input": "帮我把这段话改写得更正式一些"  }'
"string"

创建对话补全 POST

与 OpenAI Chat Completions API 完全兼容。除 `model` 外的所有字段原样转发给上游。 ### 网关特有行为 **流式下强制统计用量。** 当 `stream: true` 时,网关会自动注入 `stream_options.include_usage = true`。因此流式响应**总是**以一个包含 `usage` 的 chunk 结尾,即使你没有主动请求。这样做是为了保证计费准确——你不需要、也 无法关闭它。 **`image_generation` 工具可能被剥离。** 若路由到的上游不支持图像生成工具, 网关会从 `tools[]` 中移除 `type: "image_generation"` 的条目。如果移除后 `tools` 为空,`tools` 和 `tool_choice` 会一并删除。 ### 会话粘性 传入 `conversation_id` 请求头可以让同一会话的多次请求尽量落到同一个上游账号, 提升 prompt cache 命中率。这是 JuCode 扩展,非 OpenAI 标准。

创建响应(压缩变体) POST

`/v1/responses` 的上下文压缩变体,用于长会话摘要。**这不是 OpenAI 标准端点。** 线格式与 `/v1/responses` 完全一致,同样强制流式。