API 快速开始

这是开发者 API 文档。 本页介绍如何通过服务端代码调用 PixMind。要在网页端使用 Video to Prompt，请查看 Video to Prompt 产品使用指南。

1. 创建 API Key

进入 API Platform 密钥管理页，创建 Key，并将它保存在服务端环境变量中。

export PIXMIND_API_KEY="pm_live_..."

2. 按需中转参考素材

图生图或图生视频时，建议先通过 POST /api-platform/v1/files/presign 上传本地文件，再创建生成任务，避免第三方图床拦截模型供应商。完整流程见临时媒体上传。

3. 提交请求

curl https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "type": "image",
    "prompt": "为陶瓷咖啡杯生成简洁的商品主图",
    "aspectRatio": "1:1",
    "resolution": "1K"
  }'

所有模型共用同一个端点 —— 传入视频模型 id（例如 veo-3.1）会自动路由到视频生成。

4. 获取结果

图片和视频生成为异步处理。请保存响应中的数字 taskId，并轮询 GET /api-platform/v1/tasks/{taskId}，直到状态变为 ready 或 failed。

curl https://aihub-admin.aimix.pro/api-platform/v1/tasks/44160 \
  -H "Authorization: Bearer $PIXMIND_API_KEY"

绑定任务的临时 R2 输入会在任务变为 ready 或 failed 后自动删除；未使用的上传会在 24 小时后回收。

5. 对话补全（LLM）

PixMind 为 LLM 模型提供 OpenAI 兼容的 POST /v1/chat/completions 端点。将 baseURL 设置为 https://aihub-admin.aimix.pro/api-platform/v1，并使用你的 PixMind API Key 作为 Bearer Token 即可。

curl https://aihub-admin.aimix.pro/api-platform/v1/chat/completions \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [
      { "role": "user", "content": "用一句话解释扩散模型。" }
    ]
  }'

Gemini 图片与视频输入

Gemini 线路支持 OpenAI 风格的内容块数组，可组合 text、image_url 和 video_url。媒体 URL 必须使用 HTTPS；每次请求最多包含 10 张图片（每张 10MB）和 1 个视频（20MB）。

curl https://aihub-admin.aimix.pro/api-platform/v1/chat/completions \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [{
      "role": "user",
      "content": [
        { "type": "text", "text": "比较商品图片与视频中的运动方式。" },
        { "type": "image_url", "image_url": { "url": "https://example.com/product.png" } },
        { "type": "video_url", "video_url": { "url": "https://example.com/motion.mp4" } }
      ]
    }]
  }'

OpenAI SDK

由于接口与 OpenAI 完全兼容，可直接使用官方 SDK：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PIXMIND_API_KEY,
  baseURL: "https://aihub-admin.aimix.pro/api-platform/v1",
});

const response = await client.chat.completions.create({
  model: "gemini-3.5-flash",
  messages: [{ role: "user", content: "用一句话解释扩散模型。" }],
});

console.log(response.choices[0].message.content);

流式输出

传入 stream: true 即可收到 Server-Sent Events 流，返回 chat.completion.chunk 增量，以 data: [DONE] 结束：

const stream = await client.chat.completions.create({
  model: "gemini-3.5-flash",
  messages: [{ role: "user", content: "写一首关于大海的俳句。" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

On this page