01 复制给 AI
简报含全部接口、计价与错误处理 · 与 /agent.md 同源粘贴给 Claude / Cursor / ChatGPT / Codex,说一句「帮我接入这个 API」,剩下的交给它。
接入、调试、查账都交给 AI —— 你只需要三步。
粘贴给 Claude / Cursor / ChatGPT / Codex,说一句「帮我接入这个 API」,剩下的交给它。
手机号验证码或微信扫码登录,验证成功即可使用。
doneSecret 只显示一次,存到服务端环境变量,然后告诉 AI 变量名。
微信扫码,0.10 元起。1 元 = 10 Points,一次建模约 120 pts。
| 时间 | 类型 | 变化 | 余额 |
|---|---|---|---|
| 连接后显示真实账单 | |||
未配置 API Key
不想读文档?把下面的简报复制给 AI。想读?契约和示例都在下面。
粘贴给 Claude / Cursor / ChatGPT / Codex,说一句「帮我接入这个 API」,剩下的交给它。
https://developer.metop.com.cnX-API-Key: <api_key_id>.<secret>Idempotency-Key(创建类必填,重试同键)| 方法 | 路径 | 用途 | 认证 | 计价 | 幂等 |
|---|---|---|---|---|---|
POST | /api/v1/uploads | 创建上传会话 | X-API-Key | 0 | required |
POST | /api/v1/uploads/{sessionId}/credentials | 取得 STS 凭证 | X-API-Key | 0 | n/a |
POST | /api/v1/uploads/{sessionId}/files/{fileId}/complete | 完成单个文件 | X-API-Key | 0 | required |
POST | /api/v1/uploads/{sessionId}/complete | 取得 asset_id | X-API-Key | 0 | required |
POST | /api/v1/3dgs/estimates | 估价 | X-API-Key | 0 | n/a |
POST | /api/v1/3dgs/tasks | 提交建模任务 | X-API-Key | 按估价扣费 | required |
GET | /api/v1/3dgs/tasks/{taskId} | 查询任务 | X-API-Key | 0 | n/a |
GET | /api/v1/3dgs/tasks/{taskId}/download?format=glb | 下载模型(短时 URL) | X-API-Key | 0 | n/a |
适合生产:在你的后端保存 API Key,用服务端 SDK 调用 Developer Center;浏览器和移动端只调用你自己的业务接口。
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); // 短时有效,立即下载
适合本地联调。普通业务接入不需要配置环境变量;下面的变量只是给终端命令复用地址、密钥和文件路径,也可以直接替换成实际值。视频字节仍需用返回的临时凭证配合 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。