总览

把视频变成 3DGS 模型。

接入、调试、查账都交给 AI —— 你只需要三步。

01 复制给 AI

简报含全部接口、计价与错误处理 · 与 /agent.md 同源

                

粘贴给 Claude / Cursor / ChatGPT / Codex,说一句「帮我接入这个 API」,剩下的交给它。

02 你只需要做三件事

AI 代办不了的部分
STEP 1

登录

手机号验证码或微信扫码登录,验证成功即可使用。

STEP 2

创建 API Key

Secret 只显示一次,存到服务端环境变量,然后告诉 AI 变量名。

STEP 3

充值

微信扫码,0.10 元起。1 元 = 10 Points,一次建模约 120 pts。

03 当前状态

只读 · 来自 /api/v1/account

账单明细

按账户返回
时间类型变化余额
连接后显示真实账单

API Keys

未连接连接后显示
未配置 API Key
Secret 只在创建时返回一次
登录后加载 API Key

视频转 3DGS

不想读文档?把下面的简报复制给 AI。想读?契约和示例都在下面。


                  

粘贴给 Claude / Cursor / ChatGPT / Codex,说一句「帮我接入这个 API」,剩下的交给它。

契约摘要

Base URL
https://developer.metop.com.cn
认证
X-API-Key: <api_key_id>.<secret>
计价
1 CNY = 10 Points;任务按版本化 pricing_rules 估价
幂等
Idempotency-Key(创建类必填,重试同键)

端点

由 contracts/developer-center.openapi.yaml 生成;方法、路径、认证、计价、幂等必须与契约一致
方法路径用途认证计价幂等
POST/api/v1/uploads创建上传会话X-API-Key0required
POST/api/v1/uploads/{sessionId}/credentials取得 STS 凭证X-API-Key0n/a
POST/api/v1/uploads/{sessionId}/files/{fileId}/complete完成单个文件X-API-Key0required
POST/api/v1/uploads/{sessionId}/complete取得 asset_idX-API-Key0required
POST/api/v1/3dgs/estimates估价X-API-Key0n/a
POST/api/v1/3dgs/tasks提交建模任务X-API-Key按估价扣费required
GET/api/v1/3dgs/tasks/{taskId}查询任务X-API-Key0n/a
GET/api/v1/3dgs/tasks/{taskId}/download?format=glb下载模型(短时 URL)X-API-Key0n/a

接入流程

  1. 创建上传会话声明文件名、大小和时长
  2. 获取临时凭证只用于本次 EOS 上传
  3. 上传视频视频字节直传 EOS
  4. 完成并取 asset_id完成文件后提交会话
  5. 创建 3DGS 任务使用同一个 API Key
  6. 查询与下载任务成功后取短时 URL

请求示例

业务服务接入(推荐)

适合生产:在你的后端保存 API Key,用服务端 SDK 调用 Developer Center;浏览器和移动端只调用你自己的业务接口。

Node.js:创建会话并上传视频
import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';
import { createReadStream, statSync } from 'node:fs';
const stat = statSync('capture.mp4');

const session = await dc.post('/api/v1/uploads', {
  client_file_id: 'capture-001',
  file_name: 'capture.mp4',
  size_bytes: stat.size,
  content_type: 'video/mp4',
  declared_duration_seconds: 12.4
}, { headers: { 'Idempotency-Key': 'upload-capture-001' } });
const upload = session.data.upload_session;
const file = upload.files[0];

const { data: credentials } = await dc.post(
  `/api/v1/uploads/${upload.id}/credentials`
);
const s3 = new S3Client({
  endpoint: credentials.credentials.endpoint,
  region: credentials.credentials.region,
  forcePathStyle: credentials.credentials.force_path_style,
  credentials: {
    accessKeyId: credentials.credentials.access_key_id,
    secretAccessKey: credentials.credentials.secret_access_key,
    sessionToken: credentials.credentials.session_token
  }
});
let parts = [];
if (file.object.upload_mode === 'single') {
  await s3.send(new PutObjectCommand({
    Bucket: file.object.bucket,
    Key: file.object.key,
    Body: createReadStream('capture.mp4')
  }));
} else {
  // 用 SDK 的 MultipartUpload 上传,并返回 [{ part_number, etag }, ...]。
  parts = await multipartUpload(s3, file.object, createReadStream('capture.mp4'));
}
await dc.post(`/api/v1/uploads/${upload.id}/files/${file.id}/complete`, {
  parts // single 模式为空数组;multipart 为 EOS 返回的完整 ETag 列表
}, { headers: { 'Idempotency-Key': 'complete-capture-001' } });
const { data: asset } = await dc.post(
  `/api/v1/uploads/${upload.id}/complete`, null,
  { headers: { 'Idempotency-Key': 'finish-capture-001' } }
);
console.log(asset.asset_id);
创建任务、轮询、下载
const task = await dc.post('/api/v1/3dgs/tasks', {
  asset_id: asset.asset_id
}, { headers: { 'Idempotency-Key': 'model-capture-001' } });
const taskId = task.data.task_id;

const current = await dc.get(`/api/v1/3dgs/tasks/${taskId}`);
// 重复查询直到 status 为 succeeded 或 failed。
const { data: download } = await dc.get(
  `/api/v1/3dgs/tasks/${taskId}/download?format=glb`
);
console.log(download.download_url); // 短时有效,立即下载

命令行 / cURL 调试

适合本地联调。普通业务接入不需要配置环境变量;下面的变量只是给终端命令复用地址、密钥和文件路径,也可以直接替换成实际值。视频字节仍需用返回的临时凭证配合 S3 兼容 SDK/CLI 上传。不要把 API Key 写进脚本仓库。

可选:设置本地调试变量
export DEVELOPER_CENTER_URL=http://127.0.0.1:8080
export DEVELOPER_CENTER_API_KEY='dc_live_...'
export VIDEO_FILE=./capture.mp4
export VIDEO_SIZE=$(wc -c < "$VIDEO_FILE")
创建上传会话并取得临时凭证
curl -X POST "$DEVELOPER_CENTER_URL/api/v1/uploads" \
  -H "X-API-Key: $DEVELOPER_CENTER_API_KEY" \
  -H "Idempotency-Key: upload-capture-001" \
  -H "Content-Type: application/json" \
  -d "{\"client_file_id\":\"capture-001\",\"file_name\":\"capture.mp4\",\"size_bytes\":$VIDEO_SIZE,\"content_type\":\"video/mp4\",\"declared_duration_seconds\":12.4}"

# 读取 data.upload_session.id、files[0].id 和 object.bucket/key/upload_mode
curl -X POST "$DEVELOPER_CENTER_URL/api/v1/uploads/$UPLOAD_ID/credentials" \
  -H "X-API-Key: $DEVELOPER_CENTER_API_KEY"
完成上传、创建任务并查询
curl -X POST "$DEVELOPER_CENTER_URL/api/v1/uploads/$UPLOAD_ID/files/$FILE_ID/complete" \
  -H "X-API-Key: $DEVELOPER_CENTER_API_KEY" \
  -H "Idempotency-Key: complete-capture-001" \
  -H "Content-Type: application/json" -d '{"parts":[]}'
curl -X POST "$DEVELOPER_CENTER_URL/api/v1/uploads/$UPLOAD_ID/complete" \
  -H "X-API-Key: $DEVELOPER_CENTER_API_KEY" \
  -H "Idempotency-Key: finish-capture-001"

# 取响应中的 asset_id 后创建并查询任务
curl -X POST "$DEVELOPER_CENTER_URL/api/v1/3dgs/tasks" \
  -H "X-API-Key: $DEVELOPER_CENTER_API_KEY" \
  -H "Idempotency-Key: model-capture-001" \
  -H "Content-Type: application/json" \
  -d "{\"asset_id\":\"$ASSET_ID\"}"
curl "$DEVELOPER_CENTER_URL/api/v1/3dgs/tasks/$TASK_ID" \
  -H "X-API-Key: $DEVELOPER_CENTER_API_KEY"
上传边界:Developer Center 只分配对象和临时凭证,不接收视频字节。upload_mode=single 时完成文件传空的 parts;multipart 时必须把 EOS 返回的每个 part_number / etag 原样传回。所有重试沿用同一个 Idempotency-Key。