快速开始

MoonApiX 公开 API 使用 Bearer API Key 鉴权。

Authorization: Bearer <MOONAPIX_API_KEY>

推荐 API 域名：

域名	推荐场景
https://moonapix.com	主调用域名，推荐优先使用。
https://moonapi.yuezhuoxing.com	国内长请求备用线路。
https://api.yuezhuoxing.com	国内加速备用线路。

OpenAI-compatible 客户端的 Base URL 通常需要在所选域名后加 /v1，例如 https://moonapix.com/v1。

示例请求

cURL

curl https://moonapix.com/v1/models \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

JavaScript

const response = await fetch('https://moonapix.com/v1/models', {
  headers: {
    Authorization: 'Bearer <MOONAPIX_API_KEY>'
  }
})

const models = await response.json()
console.log(models)

Python

import requests

response = requests.get(
    "https://moonapix.com/v1/models",
    headers={"Authorization": "Bearer <MOONAPIX_API_KEY>"},
    timeout=30,
)

print(response.json())

视频任务最小流程

视频、数字人、音乐和部分图片能力是异步任务。视频生成建议从 POST /v1/videos 开始：

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-kz-fast",
    "prompt": "A cinematic product video, slow camera push-in, clean studio light.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

保存响应中的 id 或 task_id，再查询任务：

curl https://moonapix.com/v1/tasks/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

图生视频或参考图场景可以直接传客户自己的公网 URL。MoonApiX 不会因为选择某个视频模型就自动创建 OSS 托管 URL 或模型素材 ID；需要托管素材时再显式调用 /v1/assets/uploads。

下一步

• 查看 API Reference 和 接口目录。
• 了解 鉴权、API Key 与分组、任务管理概览、Webhook 和回调 和 错误码。
• 按能力进入 文本系列、图像系列、视频系列、上传与素材、数字人、音乐 / Suno 或 Web 与 Gemini。
• 上线前使用 接入检查清单 自测。