JuCode 文档

概览

JuCode 是 OpenAI / Anthropic 兼容的大模型网关,改一行 base_url 即可接入。

JuCode 把多家厂商的大模型收敛到一套 OpenAI 兼容的接口后面。你继续用熟悉的官方 SDK,只把 base_url 换成 JuCode,就能访问背后接入的所有模型。

from openai import OpenAI

client = OpenAI(
    api_key="sk-juc-...",
    base_url="https://api.jucode.cn/v1",  # 只改这一行
)

能力

能力端点
对话与推理/v1/chat/completions/v1/responses
Anthropic 兼容/anthropic/v1/messages
嵌入向量/v1/embeddings
图像生成与编辑/v1/images/generations/edits/variations
视频生成(异步)/v1/videos
语音合成与转写/v1/audio/speech/transcriptions/translations
检索重排/v1/rerank
模型查询/v1/models

兼容性怎么理解

绝大多数端点是透传的:网关解析并改写 model 字段——把你传的逻辑模型名换成实际 上游厂商的模型名——其余字段原样转发,响应也原样返回。

这有两个实际影响,值得先说清楚。

好的一面,上游厂商支持的参数你都能直接用,哪怕本文档没有逐一列出。比如给 /v1/images/generationsbackgroundstyle 这些较新的参数,网关不会拦你。

需要注意的一面,本文档不会把成功响应的结构写死。响应体的确切形状由最终路由到 的上游决定。绝大多数情况下它与 OpenAI 官方文档一致,但如果你依赖某个非标准字段, 最好先实际调一次确认。

三处与 OpenAI 不同的行为

这三条最容易踩,建议现在就看一眼:

  • POST /v1/responses 强制流式,你传 stream: false 也会返回 SSE
  • POST /v1/chat/completions 流式时总是返回用量统计,无法关闭
  • POST /v1/videos 是异步任务,提交后需轮询,且完成时才计费

详见各端点页面。

认证

所有端点用同一个 API Key。Authorization: Bearerx-api-key 两种写法都接受, 所以 OpenAI SDK 和 Anthropic SDK 都能直接用。详见认证

curl https://api.jucode.cn/v1/models \
  -H "Authorization: Bearer sk-juc-..."

On this page