说明生成结果 DTO 的 number 精度边界

为 poll_after_ms、updated_at_micros、size_bytes 补充注释,说明其量级远低于 2^53,按 TS number 导出即可精确表示

重新生成 TypeScript 绑定,把上述说明同步为 JSDoc

技术方案补充同一说明,明确不做 bigint/string 特殊处理
This commit is contained in:
2026-09-19 14:14:14 +08:00
parent b703f0c374
commit 800da43a8d
5 changed files with 14 additions and 0 deletions
@@ -5,6 +5,9 @@ export type Model3dArtifact = {
resourceId: string;
format: Model3dOutputFormat;
contentType: string;
/**
* 产物字节数,当前单模型产物为几十 MB,远低于 2^53,按 TS number 导出。
*/
sizeBytes: number;
sha256: string;
previewResourceId?: string | null;
@@ -9,5 +9,8 @@ export type Model3dGenerationJob = {
progress: number;
error?: string | null;
result?: Model3dGenerationResult | null;
/**
* 更新时间(Unix 微秒);2^53 微秒约到公元 2255 年,按 TS number 导出即可精确表示。
*/
updatedAtMicros: number;
};
@@ -5,5 +5,8 @@ export type Model3dGenerationSubmission = {
operationId: string;
status: Model3dTaskStatus;
statusUrl: string;
/**
* 轮询间隔(毫秒),量级为分钟级,远低于 2^53,按 TS number 导出。
*/
pollAfterMs: number;
};