JuCode 文档
ApiEmbeddings

创建嵌入向量

与 OpenAI Embeddings API 兼容。除 `model` 外的字段原样透传。 当模型路由到 Gemini 上游时,网关会做格式翻译,此时 `input` **只支持字符串或字符串数组**,不支持 token 数组形式。

POST
/v1/embeddings

与 OpenAI Embeddings API 兼容。除 model 外的字段原样透传。

当模型路由到 Gemini 上游时,网关会做格式翻译,此时 input 只支持字符串或字符串数组,不支持 token 数组形式。

Authorization

AuthorizationBearer <token>

Authorization: Bearer sk-juc-...

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

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/embeddings" \  -H "Content-Type: application/json" \  -d '{    "model": "text-embedding-3-small",    "input": "向量数据库用于相似度检索"  }'
{  "object": "list",  "data": [    {      "object": "embedding",      "index": 0,      "embedding": [        0      ]    }  ],  "model": "string",  "usage": {    "prompt_tokens": 0,    "total_tokens": 0  }}

创建响应(压缩变体) POST

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

生成图像 POST

与 OpenAI Images API 兼容。除 `model` 外的字段原样透传,因此上游支持的 `quality`、`style`、`background` 等参数都可直接使用。 > **不支持流式。** 网关会把上游响应完整读入内存后一次性返回。如果你传 > `stream: true`(gpt-image-1 的渐进式预览),SSE 流会被缓冲成一整块返回, > 而不是逐帧推送。 路由到阿里云百炼(DashScope / 万相)时,上游是异步接口,网关会在内部轮询 直到出图——单次请求最长阻塞 120 秒,超时返回 504。