客服咨询
GUIDE

快速开始

墨智 AI 开放 API 用一个 API Key 即可调用平台聚合的全部对话、图像、视频模型，按实际用量统一计费。下面用五步跑通「提交任务 → 拿到结果」的完整闭环。

1. 获取 API Key

登录控制台，在 API 密钥 页面创建一个密钥。密钥形如 sk-mozhiai-…， 创建后只会完整展示一次，请妥善保存。密钥的渠道策略与额度说明见 API Key 认证。

2. Base URL

开放 API 是独立网关，所有接口都在 /v1 前缀下，仅支持 HTTPS：

Base URL
https://api.mozhiai.net/v1

3. 查询可用模型

先拉取模型列表，拿到要调用模型的 id：

cURL
curl https://api.mozhiai.net/v1/models \
  -H "Authorization: Bearer $MOZHIAI_API_KEY"

支持 ?type= 按模型类型、?q= 按关键词过滤，详见 模型列表接口。

4. 提交生成任务

向 POST /v1/generations 提交任务。注意 model_id 必须传**字符串**（雪花 ID，JSON 里加引号）：

cURL
curl -X POST https://api.mozhiai.net/v1/generations \
  -H "Authorization: Bearer $MOZHIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "1234567890",
    "prompt": "一只戴宇航头盔的柯基，赛博朋克风格",
    "input_file_urls": [],
    "params": {}
  }'

5. 获取结果：同步与异步

提交后立即返回任务对象，看响应里的 status 字段决定下一步：

  • completed — 同步任务（多数对话类模型），结果已在 output_result 里，直接取用，无需轮询。
  • pending / processing — 异步任务（图像、视频等耗时模型），用返回的 id 轮询 GET /v1/generations/:id，直到 status 变为 completed / failed 等终态。
轮询示例（cURL）
curl https://api.mozhiai.net/v1/generations/1234567890123456 \
  -H "Authorization: Bearer $MOZHIAI_API_KEY"

建议轮询间隔 ≥ 3 秒，任务进入终态后停止轮询。状态机与字段含义见 查询生成任务接口。

响应信封

所有接口返回统一信封：code 为 0 表示成功，非 0 时对照 错误码说明；trace_id 用于排查问题时提供给技术支持。

Response
{
  "code": 0,
  "message": "ok",
  "data": { "id": "1234567890123456", "status": "processing", "..." : "..." },
  "trace_id": "3f1c2e7a-..."
}

接口一览