Quick Start

首次调用 API

漫剧联盟提供 OpenAI 兼容接口。只需要准备 API Key、Base URL 和模型 ID，就可以通过 curl、Python SDK 或其他 OpenAI 兼容客户端发起请求。

协议OpenAI Compatible

Base URLhttps://mjlm.coral-gpu.com:3000/v1

鉴权方式Authorization: Bearer API Key

模型 ID以控制台模型广场为准

1. 准备工作

✓登录控制台，在 API 密钥页面创建或复制自己的 API Key。
✓确认账户余额充足，余额不足会返回 insufficient_user_quota。
✓在模型广场或模型价格页确认要调用的模型 ID，例如 deepseek-v4-pro。
✓不要把完整 API Key 写进前端页面、公开仓库、截图或日志。

2. Base URL 与鉴权

生产环境 Base URL 使用当前站点域名加 /v1。如果部署到自己的域名，请把示例中的域名替换为自己的站点地址。

配置项	填写值
Base URL	https://mjlm.coral-gpu.com:3000/v1
Header	Authorization: Bearer sk-替换为你的 API Key
Content-Type	application/json

3. 查看可用模型

先请求模型列表，确认 API Key、Base URL 和网络链路都正常。

curl

curl "https://mjlm.coral-gpu.com:3000/v1/models" \
  -H "Authorization: Bearer sk-替换为你的 API Key"

4. 发送首个对话请求

文本对话统一使用 POST /v1/chat/completions。模型名称需要使用控制台可见的完整模型 ID。

curl

curl -X POST "https://mjlm.coral-gpu.com:3000/v1/chat/completions" \
  -H "Authorization: Bearer sk-替换为你的 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      { "role": "user", "content": "你好，请用一句话介绍漫剧联盟。" }
    ],
    "stream": false
  }'

5. Python SDK 示例

使用 OpenAI 官方 SDK 时，只需要把 base_url 改成漫剧联盟的 /v1 地址。

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-替换为你的 API Key",
    base_url="https://mjlm.coral-gpu.com:3000/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "user", "content": "写一个 3 点式的 API 调用检查清单"}
    ],
)

print(response.choices[0].message.content)
print(response.usage)

6. 常见错误

现象	处理方式
401 或 API Key 无效	检查 Header 是否为 Authorization: Bearer sk-...，不要漏掉 Bearer。
404	确认 Base URL 末尾是 /v1，接口路径是 /chat/completions。
400 模型不存在	使用模型广场里展示的完整模型 ID，不要只写展示名。
余额不足	充值后重试，或选择价格更低、输出更短的模型。