API 使用快速开始

几分钟内即可开始使用 MOASIS API：创建 API 密钥、提交提示词，然后轮询获取生成的动作。

1. 创建 API 密钥

在 MOASIS 网页应用中打开 设置 → API 密钥，创建一个具有 CHAT 作用域的密钥。详见 密钥管理。

每个请求都必须在 Authorization 请求头中携带该密钥：

Authorization: Bearer sk-<your-api-key>

2. 提交提示词并轮询结果

# 1. 提交提示词
conversationId=$(curl -s -X POST http://mohub-dev.vgentx.com/api/v1/chat/generate \
  -H "Authorization: Bearer sk-<your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"message": "Generate a person walking forward."}' | jq -r '.data.conversationId')

# 2. 持续轮询，直到回合完成且任务可用
curl -s http://mohub-dev.vgentx.com/api/v1/chat/generate/conversation/$conversationId/tasks \
  -H "Authorization: Bearer sk-<your-api-key>"

# 3. 当任务状态变为 COMPLETED 后，从其 contents 中获取预签名链接
wget $PRESIGNED_URL -O output.fbx # 或
wget $PRESIGNED_URL -O output.mp4

至此完成——当任务的 status 变为 COMPLETED 后，其 contents[].presignedUrl 即为生成动作的下载链接。

下一步

完整的请求/响应结构、各个接口以及任务状态取值，请参阅 文本引导动作生成。