CHMU Hub

API 手册

CHMU Hub 完整 API 文档。兼容 OpenAI 的聊天、图片和视频生成端点。

基础 URL

https://api.chmuhub.com/v1/public

认证方式

在请求头 Authorization 中携带 Bearer 格式的 API 密钥。

Authorization: Bearer sk-chmuhub-...

POST/chat/completions

向 AI 语言模型发送消息。完全兼容 OpenAI Chat Completions API，支持流式输出（SSE）。

请求参数

名称
类型
必填
描述
modelstring必填模型 ID（如 gpt-5、claude-sonnet-4.5）
messagesarray必填消息对象数组，包含 role 和 content
streamboolean选填开启流式输出（默认: true）
temperaturenumber选填采样温度（0-2）
max_tokensinteger选填最大生成 token 数

示例代码

curl https://api.chmuhub.com/v1/public/chat/completions \
  -H "Authorization: Bearer sk-chmuhub-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-5",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Hello! How can I help?" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 20, "completion_tokens": 8, "total_tokens": 28 }
}

POST/images/generations

通过文本描述生成图片。异步操作 — 返回 task_id 用于轮询。

请求参数

名称
类型
必填
描述
modelstring必填模型 ID（如 gpt-image-2、midjourney-v7）
promptstring必填图片的文本描述
resolutionstring选填分辨率（1k、2k、4k）
aspect_ratiostring选填宽高比（1:1、16:9、9:16）
ninteger选填生成图片数量

示例代码

curl https://api.chmuhub.com/v1/public/images/generations \
  -H "Authorization: Bearer sk-chmuhub-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A sunset over mountains, oil painting style",
    "resolution": "2k"
  }'

响应示例

{
  "task_id": "img_abc123...",
  "status": "GENERATING",
  "model": "gpt-image-2"
}

POST/videos/generations

启动异步视频生成任务，返回 task_id 用于轮询。

请求参数

名称
类型
必填
描述
modelstring必填模型 ID（如 sora-2、veo-3.1-fast）
promptstring必填视频的文本描述
durationinteger选填视频时长（秒）
aspect_ratiostring选填宽高比（16:9、9:16）
qualitystring选填质量等级（720p、1080p）
image_urlstring选填参考图片 URL（图生视频）

示例代码

curl https://api.chmuhub.com/v1/public/videos/generations \
  -H "Authorization: Bearer sk-chmuhub-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A golden retriever running in a sunlit field",
    "duration": 10
  }'

响应示例

{
  "task_id": "vid_abc123...",
  "status": "GENERATING",
  "model": "sora-2",
  "estimated_time": 120
}

GET/tasks/{taskId}

轮询异步任务的状态。返回进度和完成后的结果 URL。

请求参数

名称
类型
必填
描述
taskIdstring必填生成接口返回的任务 ID（路径参数）

示例代码

curl "https://api.chmuhub.com/v1/public/tasks/vid_abc123" \
  -H "Authorization: Bearer sk-chmuhub-..."

响应示例

// In progress:
{ "status": "GENERATING", "progress": 45 }

// Completed:
{
  "status": "COMPLETED",
  "videoUrl": "https://storage.chmuhub.com/videos/vid_abc123/output.mp4",
  "thumbnailUrl": "https://storage.chmuhub.com/videos/vid_abc123/thumb.jpg"
}

GET/models

列出所有可用模型及其能力。

示例代码

curl https://api.chmuhub.com/v1/public/models \
  -H "Authorization: Bearer sk-chmuhub-..."

响应示例

{
  "object": "list",
  "data": [
    { "id": "gpt-5", "object": "model", "type": "text", "name": "GPT-5" },
    { "id": "sora-2", "object": "model", "type": "video", "name": "Sora 2" },
    { "id": "gpt-image-2", "object": "model", "type": "image", "name": "GPT Image 2" }
  ]
}
API Reference - CHMU Hub Docs | CHMU Hub