KnowledgeCoal API 文档

兼容 OpenAI 调用方式的公网 API。本文档区分“文本/聊天模型”和“图片生成模型”，并明确标出哪些聊天模型能够接收图片并识别图片内容。

调用信息

Base URL：

https://api.knowledgecoal.cn/v1

所有 /v1/* 请求都要携带密钥：

Authorization: Bearer YOUR_API_KEY

模型列表可能随 ChatHub 账号可用范围变化。程序当前目录如下；自动化程序也可以分别请求 GET /v1/models 和 GET /v1/image-models 获取机器可读的最新列表。

接口一览

多模态文本模型（支持图片识别）

以下 22 个模型既能处理文本，也能通过 POST /v1/chat/completions 接收图片。图片可使用公网 HTTPS URL，或 data:image/...;base64,...。

纯文本模型

以下 12 个模型支持文本聊天，但当前不能识别输入图片。向它们传入 image_url 会返回错误。

图片生成模型

以下 11 个模型通过 POST /v1/images/generations 调用。它们是“生成图片”的模型，不属于聊天模型。表中的参考图数量是上游模型能力信息；当前公网接口只开放文字提示词生成图片，尚未开放参考图参数。

调用示例

1. 文本聊天（Python / OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.knowledgecoal.cn/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.6-luna",
    messages=[{"role": "user", "content": "请只回复：OK"}],
)
print(resp.choices[0].message.content)

2. 识别图片（多模态输入）

resp = client.chat.completions.create(
    model="gpt-5.6-luna",  # 必须选择上方“支持图片识别”的模型
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "请描述这张图片"},
            {
                "type": "image_url",
                "image_url": {"url": "https://example.com/image.jpg"},
            },
        ],
    }],
)
print(resp.choices[0].message.content)

3. 生成图片（curl）

curl https://api.knowledgecoal.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash",
    "prompt": "一幅煤田地质剖面的专业科学插图",
    "aspect_ratio": "16:9",
    "response_format": "b64_json"
  }'

response_format 可设为 b64_json 或 url；aspect_ratio 支持 auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3。

运行策略

服务使用直接 API 通道，最多允许 6 个请求同时执行；超出的请求会排队。单次直接调用失败后最多尝试 3 次，不会回退到界面自动化。

连通性检查 · 服务状态 · 文本模型 JSON · 图片模型 JSON · 能力矩阵 JSON